SuperAPI AI 工具集

res-x

通用与其它

查看项目

更新于 10-16 01:18

技能介绍

用途:抓取 X/Twitter 推文内容和搜索 X 帖子,解决 WebFetch 抓取 X 链接时报“JavaScript disabled”错误的问题。基于 xAI Responses API 的 Grok x_search 工具实现。

主要能力:按 URL 抓取单条或多条推文;批量抓取时每 3 个 URL 合并为一次 API 调用以降低成本;搜索 X 帖子(--quick 为快速概览,省略则结果更深);两个命令均支持 --json 输出便于程序化解析。接受的 URL 包括 x.com 或 twitter.com 的 status 链接及 i/article 文章链接,处理前规范化为 https://x.com/{user}/status/{id} 或 https://x.com/i/article/{id}。

使用方式:前置需安装 uv(curl -LsSf https://astral.sh/uv/install.sh | sh)并配置 xAI API key(获取地址 https://console.x.ai)。key 需一次性存入钥匙串,使用前执行 security unlock-keychain ~/Library/Keychains/claude-keys.keychain-db 解锁。抓取示例:uv run scripts/x_fetch.py fetch "https://x.com/user/status/123456";多条可一次传入多个 URL 自动按 3 条/次批处理,加 --single 则每条单独调用以保证最高保真;搜索示例:uv run scripts/x_fetch.py search "query terms"。每次调用前须先检测 key 是否可用。

适用场景:阅读已保存的 X/Twitter 链接、批量处理文件(如 Obsidian 日记)中的 X 链接、搜索 X 帖子。

限制:必须持有 xAI API key,无降级模式;按 API 调用计费,约 $0.005/次,抓取 10 条推文约 $0.020,--single 模式约 $0.050;不适用于普通网页搜索(应改用 res-web 或 res-deep);不应使用 WebFetch 处理 X URL。推文内容需完整呈现不作截断。