AI Hub Icon
AIBit 发现开源项目
首页 / 实用开源项目

CLI 工具：Claude Code 与 OpenClaw 的 X/Twitter 研究

February 11, 2026
类别: 实用开源项目
标签:
OpenSource cli XAPI ResearchTool ClaudeCode

使用快速 CLI 发挥 X/Twitter 研究强大潜力

在构建 AI 代理或开展数据驱动的调查时，您需要一种可靠的方式从 X/Twitter 拉取对话。x‑research‑skill 正好满足这一需求——它是一个端到端的命令行接口，使用 TypeScript 编写，并能无缝集成到 Claude Code 或 OpenClaw。您可以即时、低成本且成本可控地浏览推文、线程和用户活动，同时您的代理可以专注于更高级别的推理。

为何重要

  • 门槛低 – 无需繁重的 UI 或服务器设置；只需 Git clone、安装 Bun 并进行身份验证。
  • 成本透明 – CLI 在每次查询后会打印精确的 X API 成本，帮助您保持在预算范围内。
  • 基于缓存的节省 – 重复查询会命中 15 分钟（快速模式下 1 小时）的缓存，消除冗余 API 调用。
  • 快速模式 – 单页、10 条结果的脉冲检查，将点击次数和费用降至最低。
  • 关注列表监控 – 跟踪任意账号的对话，当有新活动出现时自动提醒。

快速开始

下面是从克隆仓库到运行第一条搜索的逐步路线图。

先决条件

  1. 从 X 开发者门户获取 X Bearer Token（只需只读访问权限）。
  2. 将其导出到终端：export X_BEARER_TOKEN="your-token-here" 或添加 X_BEARER_TOKEN=your-token-here 到 ~/.config/env/global.env。
  3. 安装 Bun（支持 CLI 的轻量级 JavaScript 运行时）。

将项目克隆到工作空间

# For Claude Code
mkdir -p .claude/skills && cd .claude/skills
git clone https://github.com/rohunvora/x-research-skill.git x-research

# For OpenClaw
mkdir -p skills && cd skills
git clone https://github.com/rohunvora/x-research-skill.git x-research

运行示例搜索

cd skills/x-research
bun run x-search.ts search "OpenAI" --sort likes --limit 5

终端将显示推文文本、作者、日期、互动指标，最后给出请求费用（例如 $0.50）。

关键功能说明

搜索与排序

可使用自然语言或高级标志：

bun run x-search.ts search "AI agents" --sort impressions --since 1d

可用选项包括：

  • --sort – likes、impressions、retweets、recent
  • --since – 1h、3h、12h、1d、7d
  • --min-likes、--min-impressions – 滤除低互动率的结果
  • --quick – 仅保留 10 条结果，自动隐藏转推和回复

线程拉取

bun run x-search.ts thread <tweet_id>

返回完整线程，且每条消息都已标注并按 Markdown 或 JSON 格式输出。

用户资料与近期推文

bun run x-search.ts profile @username

显示用户最新公开推文，遵循相同的过滤条件。

关注列表仪表盘

bun run x-search.ts watchlist add alice "Crypto analyst"
bun run x-search.ts watchlist check

在本地维护 watchlist.json；check 会扫描每个账号并报告新的活动。

成本管理

X 的按需付费模式适用于每一次 API 调用。截止 2026 年 2 月的默认费率为：

  • 帖子读取：$0.005
  • 用户查询：$0.010
  • 搜索页（100 条推文）：约 $0.50（快速模式），3 页 $1.50。
  • 缓存的重复查询免费。
  • 24 小时去重可防止同一帖子被重复计费。

CLI 每次运行都会打印简明的成本摘要，帮助您随时了解支出。如果超出阈值，只需在开发者控制台 充值 预付信用额度。

安全性与令牌管理

绝不在日志中泄露令牌：

  • 脚本从环境或 ~/.config/env/global.env 读取 X_BEARER_TOKEN。
  • 请勿将令牌嵌入命令行或被他人访问的脚本中。
  • 仅使用只读令牌，以保持最低权限。
  • 若怀疑令牌已泄露，请立即轮换。

限制与未来路线图

  • 目前仅使用 “recent” 搜索端点；全归档搜索已可用但尚未集成。
  • 不具备写权限——工具为只读。
  • 后续版本将支持全归档查询、先进过滤以及线程结构的可选图形可视化。

总结

无论您是构建 AI 聊天机器人的数据科学家、整合社交媒体洞察的研究者，还是自动化推文摄取的业界爱好者，x‑research‑skill 都为您提供强大且零摩擦的 X API 接口。内置缓存、成本报告和快速模式可让您在扩展研究流程时保持预算可控。

克隆仓库，设置令牌后立即开始实验。祝研究顺利！

原创文章: 查看原文

分享本文