Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub ยท Developer Tools
Mastodon Scout
Read-only Mastodon CLI. Outputs human-readable timeline summaries or raw JSON.
skill openclawclawhub Free
Read-only Mastodon CLI. Outputs human-readable timeline summaries or raw JSON.
โฌ 0 downloads โ
0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- SKILL.md, scripts/mastodon_scout.py
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
New install
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
Upgrade existing
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 2.0.1
Provenance
- Publisher
- patelhiren
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
Purpose
Read-only Mastodon skill. Fetches data from the Mastodon API via a bundled Python script (scripts/mastodon_scout.py). Returns human-readable summaries by default, or raw JSON with --json.
Invocation Rules (MANDATORY)
python3 ./scripts/mastodon_scout.py <command> [options]
Commands
CommandWhat it fetcheshomeAuthenticated user's home timelineuser-tweetsAuthenticated user's own postsmentionsMentions of the authenticated usersearch <query>Posts matching the query
Options
--instance <url> Mastodon instance base URL (default: $MASTODON_INSTANCE or https://mastodon.social) --limit <int> Number of items to return (default: $LIMIT or 20) --json Output raw JSON instead of human-readable text
Environment Variables
MASTODON_TOKEN Required. OAuth bearer token. MASTODON_INSTANCE Optional. Instance base URL (default: https://mastodon.social).
Examples
python3 ./scripts/mastodon_scout.py home python3 ./scripts/mastodon_scout.py mentions --limit 10 python3 ./scripts/mastodon_scout.py search "golang" python3 ./scripts/mastodon_scout.py home --json python3 ./scripts/mastodon_scout.py home --instance https://fosstodon.org
Text Mode (Default)
The script formats each post as: [N] Display Name (@user@instance) ยท <timestamp> <content> โฉ <replies> ๐ <reblogs> โญ <favourites> <url> The agent MAY add a brief summary after the list.
JSON Mode (--json)
Returns raw Mastodon API JSON. Return it verbatim โ no interpretation.
Error Handling
The script prints a human-readable error to stderr and exits non-zero: ConditionMessageToken missingError: MASTODON_TOKEN is not set401Mastodon API error: 401 Unauthorized โ check MASTODON_TOKEN403Mastodon API error: 403 Forbidden422Mastodon API error: 422 Unprocessable Entity429Mastodon API error: 429 Rate Limited โ try again later Do not retry on error. Guide the user to Authentication Setup if the token is missing or invalid.
Examples That Trigger This Skill
mastodon-scout home show my mastodon timeline check mastodon mentions search mastodon for "golang" get my mastodon posts
Notes
This skill is read-only (no posting, following, or other mutations) scripts/mastodon_scout.py uses stdlib only โ no pip install required In JSON mode: output verbatim, no interpretation
Authentication Setup (Agent MAY Help)
EXCEPTION TO STRICT MODE: If the user needs help obtaining a token, the agent may provide guidance before executing the skill.
How to Obtain a Token:
Step 1: Access Development Settings Log into your Mastodon instance (e.g., mastodon.social, fosstodon.org) Navigate to: Settings โ Development (or Preferences โ Development) Direct URL: https://[instance-domain]/settings/applications Step 2: Create Application Click "New Application" Application name: mastodon-scout (or any name) Redirect URI: urn:ietf:wg:oauth:2.0:oob Scopes: CRITICAL โ only select read (uncheck write, follow, push) Step 3: Get Access Token Click Submit, then open the created application Copy the "Your access token" value Step 4: Set Environment Variable export MASTODON_TOKEN="paste_token_here" Step 5: Verify python3 ./scripts/mastodon_scout.py home --limit 5
Common Mastodon Instances:
mastodon.social โ General purpose (default) fosstodon.org โ FOSS/tech community mas.to โ Tech focused hachyderm.io โ Tech/infosec community
Security Notes:
Token is read-only (cannot post, follow, or delete) Keep token secret (don't commit to git) Can be revoked anytime in Development settings Each Mastodon instance requires its own token
Category context
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
1 Docs1 Scripts
- SKILL.md
- scripts/mastodon_scout.py