发现与免费预检
Skill、llms.txt、OpenAPI 和匿名 tools/list 都有稳定地址;Agent 可先规范化输入并看成本,不创建任何付费对象。
SKILL → preflight
按账号批量获取 X(原 Twitter)近期公开帖子。Agent 可以直接发现工具、用 Base USDC 通过标准 x402 v2 按次付费、拿到任务级凭证,再读取结构化 JSON;无需先注册 Xcatcher 账户。
# 1. Agent 发现能力 tools/list # 2. 免费预检:无鉴权、无 quote、无 task、无支付 preflight_crawl({ "users": ["openai", "naval"], "mode": "normal" }) # 3. 用户决定继续后,取得请求绑定的 402 challenge get_direct_crawl_payment({ "users": ["openai", "naval"], "mode": "normal" }) # 4. 用户批准 → 钱包签名 → 提交 → 结构化结果 submit_direct_crawl_payment({"users":["openai","naval"], "mode":"normal", "payment_signature_b64": "..."}) get_direct_result_preview({"task_id": 12345, "task_token": "xtask_..."})
钱包可直接按次付费;已有账户可继续用积分。每个工具都标明是否读数据、建任务或移动资金。
Skill、llms.txt、OpenAPI 和匿名 tools/list 都有稳定地址;Agent 可先规范化输入并看成本,不创建任何付费对象。
钱包无账户走 direct x402;已有 API Key 走积分任务。实时响应给出模式、价格和 500 handles 上限。
challenge 绑定 handles 与模式;Agent 展示精确条款并获得授权,钱包内部完成签名,服务端只结算一次。
任务级 token 隔离每次付费结果;状态、分页 JSON 和 XLSX 都不暴露服务器路径或公共裸链。
Xcatcher 的边界很明确:输入是账号 handle,输出是近期公开帖子快照;不是关键词搜索,也不是完整 firehose。
Normal 使用累进批量价:前 5 个 $0.01,第 6–25 个 $0.0075,第 26–100 个 $0.006,第 101–500 个 $0.005;最低任务金额 $0.01。内部 Actor 重试不重复收费。账户积分仍为 normal 1 point、deep 10 points 每 handle;准确总价以免费 preflight 和当次 402 为准。
给模型、MCP 客户端、API 导入器和搜索引擎各自最合适的格式。
/skills/xcatcher/SKILL.mdAgent 工作流、支付护栏和结果解释
/llms.txt精简的 LLM 发现索引
/llms-full.txt完整的机器可读服务说明
/openapi.yamlREST OpenAPI 3.0.3 描述
/server.json官方 MCP Registry manifest
/mcp/health无鉴权健康检查
/api/v1/demo免费的合成结果样例
/trust/安全、支付、数据与可靠性边界
/integrations/agent-skills/适配主流 Agent 的一键安装入口
/integrations/circle-agent-marketplace/Circle x402 服务发现准备度与实时 402 验证
/use-cases/x-account-monitoring/X 账号监控的完整 Agent 用例
/examples/agent-prompts/可直接复用的 Agent 提示词与输出规范
/guides/x-twitter-data-for-ai-agents/何时该用或不该用 Xcatcher