Twitter / X 推文查询（只读）#

通过 twitterapi.io 拉取推文： 按账号 或 按关键词，输出 JSON。不集成 LLM，不做趋势榜/热度建模。

环境#

• TWITTER_API_KEY：必填（HTTP Header X-API-Key）。
• TWITTER_API_BASE：可选，默认 https://api.twitterapi.io。

OpenClaw / ClawHub 安装#

在已支持 Skills 的客户端中（以仓库发布名为准，示例为 alexander10011/twitter-query）：

bash

npx skills add alexander10011/twitter-query

安装后，在 技能包根目录 下执行脚本（路径以实际克隆位置为准）。

脚本路径（仓库根目录）#

能力命令某用户时间线python3 scripts/query_by_user.py USERNAME [选项]关键词高级搜索python3 scripts/query_by_keyword.py "查询字符串" [选项]

按账号#

bash

export TWITTER_API_KEY="你的key"
python3 scripts/query_by_user.py VitalikButerin --max-pages 5
python3 scripts/query_by_user.py someuser --include-replies --max-pages 10

• 接口： GET /twitter/user/last_tweets（ 文档）， cursor 分页，每页最多约 20 条。
• 时间范围由分页量间接限制；需要「近 N 天」可对返回的 createdAt 再过滤。

按关键词#

bash

python3 scripts/query_by_keyword.py '$BTC min_faves:5' --query-type Latest --max-pages 3
python3 scripts/query_by_keyword.py 'from:elonmusk since:2026-03-01_00:00:00_UTC' --query-type Top

• 接口： GET /twitter/tweet/advanced_search（ 文档）。
• queryType： Latest 或 Top；默认 Latest。
• 语法参考： twitter-advanced-search。

输出#

脚本向 stdout 打印 JSON（ utf-8），含 meta 与 tweets。

Agent 工作方式#

1. 确认已设置 TWITTER_API_KEY。
2. 选择 query_by_user 或 query_by_keyword，运行脚本。
3. 若需中文摘要或观点归纳，在 当前对话模型内 完成，本 Skill 不调用外部总结 API。

许可证#

MIT，见 LICENSE。