Twitter Monitor 是一个用于抓取 X/Twitter 账号近期推文的技能，属于 kangarooking/kangarooking-skills 技能集。它通过 twitterapi.io 获取数据，输出结构化的 JSON 或 CSV 记录，并可选将记录同步到飞书/Lark 多维表格。
用途 该技能用于从指定的一个或多个 X/Twitter 账号抓取近期推文，适合需要批量获取账号动态、整理推文数据或进行后续同步的场景。它被设计为一次性执行的工作流，而不是长期运行的守护进程。
主要能力
- 支持一个或多个 X/Twitter 账号的推文抓取，账号标识可接受 handle（如 sama、@sama）、个人主页链接，或多个逗号分隔的账号。
- 通过 twitterapi.io 获取数据，需要配置 twitterapi.io 的 API 密钥。
- 输出 JSON 或 CSV 格式的结构化记录。
- 每条推文记录包含以下字段：推文内容、日期、推文链接、推文ID、作者、作者ID、阅读量、点赞数、转发数、评论数、收藏数、是否回复、抓取时间。
- 写入任何持久化目标前，按推文ID去重。
- 可选将记录同步到飞书/Lark 多维表格。
- 可选配置周期性执行。
使用方式 从技能目录执行，先设置 API 密钥环境变量，再运行脚本。示例命令：
export TWITTER_API_KEY="..." python scripts/twitter_monitor.py --accounts sama --pages 1 --format json
多个账号：
python scripts/twitter_monitor.py --accounts sama,elonmusk,OpenAI --pages 1 --format csv
使用 JSON 账号列表文件：
python scripts/twitter_monitor.py --accounts-file assets/accounts.example.json --pages 1
使用流程上，先完成一次性抓取，再按需提供可选的飞书同步和调度。若缺少账号标识，需向用户询问；若 TWITTER_API_KEY 不可用，需请用户提供或配置 twitterapi.io 的 API 密钥，且不要将 API 密钥写入提交到仓库的文件中。分页深度需确认，默认 --pages 1，仅在用户要求更多历史或接受更高 API 用量时使用更大数值。运行 scripts/twitter_monitor.py 生成 JSON 或 CSV 输出。若用户需要飞书/Lark 多维表格输出，参考 references/feishu-output.md。一次性命令成功后，询问是否需要周期性执行；若需要，参考 references/scheduling.md，并在合适时使用 OpenClaw。
飞书同步 正常抓取不要求飞书配置。仅当用户要求写入、追加或同步记录到飞书/Lark 多维表格时，才进入飞书工作流。优先使用 feishu-cli，而非硬编码飞书应用凭据。若缺少 feishu-cli，询问是否安装并配置。字段映射和同步规则见 references/feishu-output.md。
调度 仅在一次性抓取成功后，或用户明确要求持续监控时，才提供调度。若用户需要由智能体管理的周期性任务或已在使用 OpenClaw，优先使用 OpenClaw；否则根据运行环境选择 Codex automations、cron 或 launchd。详见 references/scheduling.md。
适用场景
- 批量获取一个或多个 X/Twitter 账号的近期推文并整理为结构化数据。
- 将推文数据同步到飞书/Lark 多维表格进行协作或存档。
- 在一次性抓取验证后，建立周期性监控任务。
限制与安全
- 需要 twitterapi.io 的 API 密钥，密钥应保存在环境变量、密钥管理器或用户已有的 CLI 认证中。
- 切勿提交真实 API 密钥、飞书令牌、包含私有监控数据的输出文件或本地状态缓存。
- 分页深度默认 1 页，增加页数会提高 API 用量。
- 飞书同步和调度均为可选，需用户明确要求后启用。
- 关于 API 密钥设置、账号输入示例或命令变体，可参考 references/twitterapi-setup.md。