← 返回 Skills 市场
patelhiren

Mastodon Scout

作者 Hiren Patel · GitHub ↗ · v2.0.1
cross-platform ✓ 安全检测通过
2015
总下载
5
收藏
3
当前安装
6
版本数
在 OpenClaw 中安装
/install mastodon-scout
功能描述
Read-only Mastodon skill. Outputs human-readable timeline summaries or raw JSON.
安全使用建议
This skill appears to do exactly what it claims: a read-only Mastodon timeline/search helper implemented in a small Python script. Before installing: (1) confirm the registry metadata is updated to declare MASTODON_TOKEN (and optionally MASTODON_INSTANCE/LIMIT) so you know what will be required; (2) create a Mastodon application token with only the read scope (the SKILL.md explicitly recommends this) and keep the token secret — do not paste it into public logs or version control; (3) verify the Mastodon instance URL you provide is correct (the script will call whatever instance you pass); and (4) if you allow autonomous invocation of skills, remember this one can run with your token when invoked, so avoid granting it overly broad tokens. If you want extra assurance, inspect the included scripts/mastodon_scout.py locally before running it — it uses only stdlib network calls and only performs GET requests to standard Mastodon API endpoints.
功能分析
Type: OpenClaw Skill Name: mastodon-scout Version: 2.0.1 The OpenClaw skill 'mastodon-scout' is designed for read-only interaction with the Mastodon API. The `SKILL.md` provides clear, security-conscious instructions for token setup, explicitly limiting scopes to 'read'. The `scripts/mastodon_scout.py` uses standard Python libraries, handles user input (e.g., search queries) with `urllib.parse.quote` to prevent injection, and only makes GET requests to the configured Mastodon instance. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts against the agent beyond its stated purpose of providing user guidance for authentication.
能力评估
Purpose & Capability
The code and SKILL.md implement a read-only Mastodon client that fetches timelines, mentions, user posts, and search results — this matches the name and description. However, the registry metadata lists no required environment variables while the SKILL.md (and the script) require MASTODON_TOKEN (required) and optionally MASTODON_INSTANCE. That metadata mismatch should be corrected but does not indicate malicious behavior.
Instruction Scope
SKILL.md limits runtime actions to invoking the bundled Python script and (optionally) helping the user create a read-only token. The instructions do not request reading unrelated files, scanning the host, or sending data to unexpected endpoints. The script only contacts the Mastodon instance provided by the user or the default instance.
Install Mechanism
No install spec; the skill is instruction-only with a bundled Python script that uses the Python standard library. Nothing is downloaded or written to disk beyond the existing script, so install risk is low.
Credentials
The script requires a single OAuth bearer token (MASTODON_TOKEN) and optionally uses MASTODON_INSTANCE and an environment LIMIT fallback. These are proportionate to a Mastodon read-only client. Small issues: registry metadata omitted these env vars while SKILL.md declares them (and metadata inside SKILL.md also lists them). Also LIMIT is read from env but not declared in the registry metadata. These are metadata inconsistencies rather than overbroad credential requests.
Persistence & Privilege
The skill does not request persistent/always-on inclusion (always: false), does not modify other skills or system config, and does not write credentials to disk. It behaves as a normal user-invoked skill.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install mastodon-scout
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /mastodon-scout 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v2.0.1
- Updated the SKILL.md metadata section for improved structure and compatibility. - No changes to commands, options, examples, error handling, or usage details. - No functional changes to the skill's capabilities or invocation. - Documentation now uses a new metadata format.
v2.0.0
**Major update: Switch from native binaries to a bundled Python script for fetching Mastodon data.** - Replaces CLI binary invocations with a Python script (`scripts/mastodon_scout.py`) using Python 3 stdlib only. - Adds support for the optional `MASTODON_INSTANCE` environment variable to select the Mastodon server. - Invocation, error handling, and output format instructions revised to match new Python script. - Installation and binary handling steps removed; agent now runs the Python script directly. - Documentation updated for new commands, options, environment variable setup, and error messages.
v1.0.5
- Updated installer URLs to use version 1.0.5 release archives for all supported platforms. - No other content or functional changes.
v1.0.4
- Updated all download/install URLs to reference version 1.0.4 binaries. - Added explicit required environment variable metadata for MASTODON_TOKEN. - Fixed binary paths in Invocation Rules and examples for consistency. - No changes to functionality or command options.
v1.0.3
- Improved install section in metadata: binaries are now placed in `{baseDir}/bin` and `targetDir` is specified for each platform. - Added support for binary discovery with `anyBins`, allowing either `{baseDir}/bin/mastodon-scout` or `mastodon-scout`. - Updated CLI command examples and invocation rules to use the `{baseDir}/bin/mastodon-scout` path. - No changes to CLI flags, authentication, or functionality.
v1.0.2
- Added detailed setup and usage instructions for the Mastodon Scout CLI, including environment variable and authentication requirements. - Clarified operating system-specific binaries and installation links for macOS (Apple Silicon & Intel), Linux, and Windows. - Documented all supported commands (home, user-tweets, mentions, search) and command-line flags. - Outlined text and JSON output modes, including explicit guidance for error handling and agent summarization/explanation behavior. - Included security notes and step-by-step instructions for obtaining and configuring a Mastodon OAuth bearer token. - Emphasized the tool’s read-only nature and improved documentation for invocation, input, and expected results.
元数据
Slug mastodon-scout
版本 2.0.1
许可证
累计安装 3
当前安装数 3
历史版本数 6
常见问题

Mastodon Scout 是什么?

Read-only Mastodon skill. Outputs human-readable timeline summaries or raw JSON. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2015 次。

如何安装 Mastodon Scout?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install mastodon-scout」即可一键安装,无需额外配置。

Mastodon Scout 是免费的吗?

是的,Mastodon Scout 完全免费(开源免费),可自由下载、安装和使用。

Mastodon Scout 支持哪些平台?

Mastodon Scout 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Mastodon Scout?

由 Hiren Patel(@patelhiren)开发并维护,当前版本 v2.0.1。

💬 留言讨论