用途：为智能体提供 Twitter/X 数据源，覆盖搜索推文、解析账号、拉取时间线与关注者、读取列表和查看趋势等场景。所有接口均为单个 HTTP GET，按次付费，据资料无需开发者账号、应用审核、OAuth 握手，也无需等待官方 API 层级或速率限制审批。
主要能力：基础地址 https://twitter.fetcher.sh，共 15 个 GET 端点，单次 0.005 美元，单条推文接口为 0.002 美元。可搜索推文与账号（/api/search、/api/search/users），按 handle 或用户 ID 查资料（/api/handle/{handle}、/api/handle/{handle}/about、/api/user/{id}），获取用户时间线、回复、关注者与被关注列表（/api/user/{id}/tweets、/replies、/followers、/followings），按 ID 取单条推文及其回复和转发者（/api/tweet/{id}、/replies、/retweeters），读取 Twitter 列表成员与推文（/api/list/{id}/members、/tweets），以及按国家查看趋势（/api/trends）。支持 X 高级搜索运算符如 from:、since:、until:、min_faves:、filter: 等；可选 cursor、sort 等查询参数用于分页或排序。
使用方式：两种付费方式。其一为预付额度，设置环境变量后发送 Authorization: Bearer $FETCHER_API_KEY 请求，例如 curl -H "Authorization: Bearer $FETCHER_API_KEY" "https://twitter.fetcher.sh/api/search?query=hello"。其二为 x402 按次付费，省略该请求头，未付费的 GET 会返回 402 及机器可读的付款要求（USDC，支持 Base、Polygon、Arbitrum、Monad、Solana），可用 @x402/fetch 自动签名并重试。所有响应格式为 { "status": number, "message": string, "data": ... }，HTTP 状态与 status 一致。另有 MCP 服务 https://twitter.fetcher.sh/mcp，可免费调用 search_endpoints、describe_endpoint、check_balance，付费调用 fetch_data 等。
限制：错误码包括 400 参数缺失或无效、401 密钥未知或轮换、402 需付款或额度耗尽、404 非计费路径；据资料无速率限制，且上游失败不退款（结算先于交付）。其余细节暂未提供。