Mastodon内容采集

技能简介

Mastodon Scout 是一款只读的 Mastodon 命令行工具，通过调用 Mastodon API 获取用户时间线、个人帖子、提及通知及搜索结果。默认以易读文本格式返回摘要，也可通过 –json 标志输出原始 JSON 数据。

业务背景

社交媒体监测人员无需打开浏览器即可快速获取Mastodon平台动态，支持批量采集公开内容用于舆情分析或竞品追踪。命令行操作便于集成到自动化脚本，定时抓取指定账号动态或关键词话题，提升信息收集效率。

落地案例：某品牌公关团队需每日监控品牌在联邦宇宙中的提及情况。配置MASTODON_TOKEN后，通过search命令输入品牌关键词，自动获取相关公开帖子摘要；也可拉取竞品账号的home时间线了解其发布节奏。若需接入内部数据分析系统，添加–json标志输出原始数据供下游处理。

能做什么

• 拉取认证用户的 home 时间线
• 获取用户自己发布的帖子列表
• 查看提及该用户的通知
• 按关键词搜索公开帖子
• 切换文本摘要与原始 JSON 两种输出模式

使用说明

安装步骤

1. 根据操作系统下载对应二进制文件：
   • macOS Apple Silicon: https://github.com/patelhiren/mastodon-scout/releases/download/v1.0.4/mastodon-scout-darwin-arm64.zip
   • macOS Intel: https://github.com/patelhiren/mastodon-scout/releases/download/v1.0.4/mastodon-scout-darwin-amd64.zip
   • Linux: https://github.com/patelhiren/mastodon-scout/releases/download/v1.0.4/mastodon-scout-linux-amd64.zip
   • Windows: https://github.com/patelhiren/mastodon-scout/releases/download/v1.0.4/mastodon-scout-windows-amd64.zip
2. 解压并将可执行文件放入 {baseDir}/bin/ 目录
3. 设置环境变量 MASTODON_TOKEN（OAuth bearer token）

常用命令

# 获取 home 时间线
{baseDir}/bin/mastodon-scout home

# 获取个人帖子
{baseDir}/bin/mastodon-scout user-tweets

# 获取提及通知
{baseDir}/bin/mastodon-scout mentions

# 搜索关键词
{baseDir}/bin/mastodon-scout search "golang"

# 输出原始 JSON
{baseDir}/bin/mastodon-scout --json home

可选参数

• --instance <url>：指定实例地址（默认 https://mastodon.social）
• --limit <int>：返回条目数（默认 20）
• --timeout <int>：超时秒数（默认 30）

输入与输出

见下方输入与输出表格。

风险提示

• 必须配置有效的 MASTODON_TOKEN，否则工具将报错退出
• 本工具为只读操作，不支持发帖、关注等修改行为
• JSON 模式下直接返回原始数据，不做解释或摘要
• 网络异常或实例不可达时可能返回非零退出码

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/patelhiren/mastodon-scout/SKILL.md
来源类型：开源社区技能