mcpField
T
twitter-monitor

twitter-monitor

github.com/kangarooking数据与数据库688199 次安装7 周前更新
代码仓库

关于 twitter-monitor

twitter-monitor 是用于一次性抓取 X/Twitter 账号推文并导出 JSON 或 CSV 的 skill。它涵盖账号与 API 密钥配置,并可在抓取成功后选择同步到 Feishu 或设置定期运行。

主要功能

  1. 01抓取一个或多个账号的推文
  2. 02将记录导出为 JSON 或 CSV
  3. 03配置 API 密钥和分页深度
  4. 04可选同步 Feishu 和定期运行

适用场景

  1. 01收集指定 X/Twitter 账号的推文
  2. 02导出账号动态以供查看
  3. 03将抓取记录追加到 Feishu Bitable
  4. 04测试抓取成功后设置定期监控

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/kangarooking/kangarooking-skills --skill twitter-monitor

安装后在 Claude Code 中输入/twitter-monitor确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/
accounts.example.json
env.example
references/
feishu-output.md
scheduling.md
twitterapi-setup.md
scripts/
twitter_monitor.py

详细介绍

Twitter 监控

工作流

将此技能用作执行工作流,而不是长期运行的守护进程。先完成一次性抓取,仅在有用时再提供可选的飞书同步和定时执行。

  1. 如果缺少 X/Twitter 账号 ID,请向用户询问。接受 sama、@sama、个人资料 URL 或以逗号分隔的多个 ID。
  2. 如果 TWITTER_API_KEY 不可用,请让用户提供或配置 twitterapi.io API 密钥。不要将 API 密钥写入提交到代码仓库的文件中。
  3. 确认分页深度。默认使用 --pages 1;只有在用户要求获取更多历史记录或接受更高的 API 用量时,才使用更大的数值。
  4. 运行 scripts/twitter_monitor.py 并生成 JSON 或 CSV 输出。
  5. 如果用户需要飞书/Lark 多维表格输出,请遵循 references/feishu-output.md。
  6. 一次性命令运行成功后,询问用户是否需要定期执行。如果需要,请遵循 references/scheduling.md,并在适当时使用 OpenClaw。

快速开始

在此技能目录中:

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

当用户需要设置 API 密钥、账号输入示例或命令变体时,请阅读 references/twitterapi-setup.md。

输出架构

脚本为每条推文写入一条记录,包含以下字段:

  • 推文内容
  • 日期
  • 推文链接
  • 推文ID
  • 作者
  • 作者ID
  • 阅读量
  • 点赞数
  • 转发数
  • 评论数
  • 收藏数
  • 是否回复
  • 抓取时间

在追加到任何持久化目标前,请按 推文ID 去重。

飞书

常规抓取无需配置飞书。只有用户要求将记录写入、追加或同步到飞书/Lark 多维表格时,才进入飞书工作流。

优先使用 feishu-cli,而不是硬编码飞书应用凭据。如果缺少 feishu-cli,请询问用户是否要安装和配置。字段映射和同步规则请参阅 references/feishu-output.md。

定时执行

仅在一次性抓取成功后,或用户明确要求持续监控时,才提供定时执行选项。

如果用户需要由 Agent 管理的定期任务或已在使用 OpenClaw,请优先选择 OpenClaw。否则,根据运行环境选择 Codex 自动化、cron 或 launchd。请参阅 references/scheduling.md。

安全

切勿提交真实 API 密钥、飞书令牌、包含私人监控数据的输出文件或本地状态缓存。请将机密保存在环境变量、密钥管理器或用户现有的 CLI 身份验证中。

评论

支持 Markdown