用途:为智能体提供即插即用的 X(Twitter)数据源。若任务涉及 X 搜索查询、账号句柄、帖子/推文 ID 或列表 ID,可用本技能。无需开发者账号、应用审核、OAuth 握手,也不受官方 API 层级与速率限制审批限制。
主要能力:共 15 个端点,全部为 GET。包括按关键词或运算符搜索帖子(/api/search)、按名称搜索账号(/api/search/users)、按句柄查资料(/api/handle/{handle} 及 /about)、按数字 ID 查用户(/api/user/{id} 及其时间线、回复、关注者、关注列表)、按 ID 查单条帖子(/api/tweet/{id} 及其回复、转发者)、读取 X 列表成员与帖子(/api/list/{id}/members、/tweets)、查询某国趋势(/api/trends)。
使用方式:基础 URL 为 https://twitter.fetcher.sh。认证有两种:一是预付费额度,设 FETCHER_API_KEY 后以 Authorization: Bearer $FETCHER_API_KEY 调用;二是 x402 按次付费,省略头,无付款的 GET 会返回 402 及机器可读付款要求(USDC,支持 Base、Polygon、Arbitrum、Monad、Solana),@x402/fetch 可自动签名重试。响应统一为 { "status": number, "message": string, "data": ... }。还提供 MCP 端点 https://twitter.fetcher.sh/mcp,以及 /openapi.json、/llms.txt、/skill.md。
适用场景:搜索帖子与账号、解析资料、拉取时间线、关注者、列表内容、趋势等需要 X 数据的智能体任务。
限制:按次 $0.002–$0.005;无速率限制;上游失败不退款(先结算后交付)。错误码:400 参数缺失或无效,401 密钥未知或已轮换,402 需付款或额度耗尽,404 非定价路径。仅查询(search)和 country(trends)为必填,其他为可选。{id}/{handle} 为路径参数,需替换真实值。