Twitter Query

通过 twitterapi.io 只读接口查询 X/Twitter 推文：可按用户名拉取用户时间线，或按关键词做高级搜索（Latest/Top），支持光标分页，结果以 JSON 打印到标准输出。仅做检索，不做 LLM 总结与热度建模，需要自备 API Key。

alexander10011

热度 51.65

最近更新 2026-05-11 17:38:07

分类：搜索依赖：代码执行 / 第三方 API应用场景：社交媒体 / 研究 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add twitter-query

Metadata

name: twitter-query
description: Query X/Twitter via twitterapi.io read-only APIs by account (user timeline) or by keyword (advanced search). Outputs structured JSON; no LLM, no trend scoring. Use when the user asks for tweets from a handle, user timeline, keyword/hashtag/cashtag search, or 推特/X 推文查询.

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）：

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。