核心用法
Mastodon Scout 是一款只读型命令行工具，专用于从 Mastodon 联邦宇宙获取数据。核心功能覆盖四大场景：
| 命令 | 用途 |
|------|------|
| `home` | 获取关注用户的时间线 |
| `user-tweets` | 拉取自己的历史发帖 |
| `mentions` | 查看被提及的消息 |
| `search <query>` | 全文搜索公开内容 |
支持 --json 标志输出原始 API 响应，便于脚本集成；默认文本模式则由 AI 助手智能摘要，提升可读性。
显著优点
1. 零浏览器依赖：纯二进制执行，适合服务器、CI/CD 或隐私敏感环境
2. 跨平台覆盖：提供 macOS（Apple Silicon/Intel）、Linux、Windows 原生预编译二进制
3. 只读权限设计：OAuth 仅需 read scope，天然防误操作，社媒账号零风险
4. 灵活实例支持：通过 --instance 可切换任意联邦节点（如 fosstodon.org、hachyderm.io）
5. 低延迟交互：本地执行，无网络搜索或二次工具调用
潜在局限
- 仅读取无互动：无法发帖、回复、关注或点赞，需配合官方客户端完成社交操作
- Token 配置门槛：新用户需手动在 Mastodon 后台创建 Application 并复制 Access Token，流程对非技术用户不够友好
- 单 Token 单实例：跨实例浏览需频繁切换环境变量或
--instance参数 - 无内置分页：大量内容获取需自行控制
--limit，API 速率限制由底层接管
适合人群
- 开发者与系统管理员：在终端监控技术社区动态
- 隐私优先用户：避免常驻浏览器 Cookie 追踪
- 自动化场景：结合 Cron 或脚本定时备份或分析个人数据
- 多实例用户：快速在 mastodon.social、hachyderm.io 等节点间切换
常规风险
| 风险点 | 说明 |
|--------|------|
| Token 泄露 | Bearer Token 若写入 Shell 历史或 Git 仓库，可被他人用于读取账户数据 |
| 实例信任 | 使用小众实例时，需确认其隐私政策与数据留存策略 |
| API 限速 | Mastodon 实例默认限速，高频调用可能触发暂时封禁 |
建议通过 .env 文件或密钥管理服务注入 MASTODON_TOKEN，并设置 Shell 忽略前缀（如 HISTIGNORE）避免敏感命令入历史记录。