Skills twitter-query

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/alexander10011/twitter-query" ~/.claude/skills/clawdbot-skills-twitter-query && rm -rf "$T"
manifest: skills/alexander10011/twitter-query/SKILL.md
source content

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 工作方式

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

许可证

MIT,见 LICENSE