用途:为智能体提供 X(Twitter)数据源,可在不申请开发者账号、不做应用审核、不走 OAuth、不等待官方 API 配额审批的情况下,按次付费调用帖子搜索、资料解析、时间线、关注者、List 与趋势数据。当任务涉及 X 搜索查询、用户名、帖子 ID 或 List ID 时可用。
主要能力:基址 https://twitter.fetcher.sh,共 15 个 GET 端点。搜索帖子 /api/search(支持 X 高级搜索运算符,如 from:、since:、min_faves:、filter:),搜索账号 /api/search/users,按 @handle 查资料 /api/handle/{handle} 及 /about,按数字 ID 查资料 /api/user/{id},用户时间线 /tweets、回复 /replies、关注者 /followers、关注 /followings,单帖 /api/tweet/{id}($0.002)及回复 /replies、转发者 /retweeters,List 成员 /api/list/{id}/members 与帖子 /tweets,趋势 /api/trends。多数端点 $0.005/次,价格区间 $0.002–$0.005/次。
使用方式:两种付费,数据相同。1)预付积分:在 https://fetcher.sh/topup 获取密钥,设置 export FETCHER_API_KEY="bby_live_xxx",请求头 Authorization: Bearer $FETCHER_API_KEY。2)x402 按次付费:省略请求头,未付款的 GET 返回 402 及可机读的付款要求(USDC,支持 Base、Polygon、Arbitrum、Monad、Solana),@x402/fetch 可自动签名并重试。响应结构为 { "status": number, "message": string, "data": ... },HTTP 状态与 status 一致。可选 cursor、sort 参数用于分页或排序;search 的 query 与 trends 的 country 为必填。也可通过 MCP 接入 https://twitter.fetcher.sh/mcp,免费工具含 search_endpoints、describe_endpoint、check_balance,付费工具含 fetch_data、topup_credits 及快捷方式 twitter_search。机读文档见 /openapi.json、/llms.txt、/skill.md,另有 /x-search 斜杠命令。
限制:无速率限制,但上游失败不退款(结算先于交付)。错误码:400 参数缺失或无效、401 密钥未知或已轮换、402 需付款或积分耗尽(topup_required)、404 非计价路径。资料未提供速度、成功率、数据覆盖范围等性能指标。