- name
- twitter-query
- description
- >-
Twitter / X 推文查询（只读）
通过 twitterapi.io 拉取推文：按账号或按关键词，输出 JSON。不集成 LLM，不做趋势榜/热度建模。
环境
TWITTER_API_KEY：必填（HTTP HeaderX-API-Key）。TWITTER_API_BASE：可选，默认https://api.twitterapi.io。
OpenClaw / ClawHub 安装
在已支持 Skills 的客户端中（以仓库发布名为准，示例为 alexander10011/twitter-query）：
npx skills add alexander10011/twitter-query安装后，在技能包根目录下执行脚本（路径以实际克隆位置为准）。
脚本路径（仓库根目录）
| 能力 | 命令 |
|---|---|
| 某用户时间线 | python3 scripts/query_by_user.py USERNAME [选项] |
| 关键词高级搜索 | python3 scripts/query_by_keyword.py "查询字符串" [选项] |
按账号
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再过滤。
按关键词
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 工作方式
- 确认已设置
TWITTER_API_KEY。 - 选择
query_by_user或query_by_keyword，运行脚本。 - 若需中文摘要或观点归纳，在当前对话模型内完成，本 Skill 不调用外部总结 API。
许可证
MIT，见 LICENSE。