Mastodon Scout

🦣 Mastodon 只读数据探索工具

Mastodon 只读命令行工具,支持获取时间线、搜索和提及查询,输出可读的摘要或原始 JSON 数据。

收藏
6.8k
安装
2.5k
版本
1.0.3
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Mastodon Scout 是一款只读型 Mastodon 命令行工具,通过官方 API 获取数据。主要功能包括:

  • home:获取认证用户的主页时间线
  • user-tweets:获取用户自己的帖子
  • mentions:获取提及该用户的通知
  • search <query>:搜索匹配关键词的帖子

支持 --json 标志输出原始 API 数据,或默认输出人类可读的摘要。通过 --instance 可指定非默认实例(默认 mastodon.social),--limit 控制返回数量,--timeout 设置请求超时。

显著优点

1. 只读安全设计:明确禁止发帖、关注、删除等写操作,令牌仅需 read 权限,降低误操作风险
2. 跨平台支持:提供 macOS(Intel/Apple Silicon)、Linux、Windows 原生二进制文件

3. 双模式输出:既适合终端直接阅读,也支持结构化数据处理

4. 低延迟执行:直接调用本地二进制,无网络搜索或中间层

潜在缺点与局限性

  • 认证门槛:需要用户手动在 Mastodon 实例创建应用并获取 OAuth 令牌,对非技术用户不够友好
  • 功能单一:仅支持读取操作,无法互动(回复、点赞、转发)
  • 实例碎片化:不同实例需单独配置令牌,多账户管理复杂
  • 无内置令牌管理:依赖环境变量,无安全存储或轮换机制
  • 错误处理依赖外部:二进制非零退出需用户自行判断原因

适合人群

  • 开发者与系统管理员:需要将 Mastodon 数据集成到脚本或工作流
  • 隐私敏感用户:偏好本地 CLI 工具而非网页客户端
  • 数据分析者:需要批量导出或处理自己的社交数据
  • Mastodon 多实例用户:需要跨实例快速切换查看内容

常规风险

  • 令牌泄露风险MASTODON_TOKEN 若被记录到 shell 历史或日志文件,可能导致账户被读取
  • 实例信任问题:使用非官方或小众实例时,API 响应可能被篡改
  • API 速率限制:频繁调用可能触发 Mastodon 实例的限流机制
  • 数据留存:查询结果可能包含其他用户内容,需注意隐私合规

Mastodon Scout 内容

手动下载zip · 2.7 kB
SKILL.mdtext/markdown
请选择文件