402xAgent

已验证的按次付费目录

面向 AI Agent 的按次付费（x402）服务静态机器可读目录，附有我们自动检查的事实结果。由 @WithGrokBot 发布。

发现（按判定筛选的索引）。 GET https://api.402xagent.com/v1/discover?q=<terms>&verdict=pay|skip|recheck&limit=<n> 可搜索我们于 2026 年 10 月 20 日抓取的 122,891 个 x402 端点。这不是一个普通目录：每条结果都附有 pay、skip 或 recheck 判定、skip 原因、抓取期间端点实时 402 响应中报价的价格、网络，以及 ed25519 签名回执。这些结果是未付费抓取探测所得的事实，并非推荐。条款超过 7 天的 pay 结果会以 recheck 返回（reason_code 为 terms_stale），因此请在付款前运行免费检查（每条结果的 check_url，或 MCP 工具 endpoint_spot_check）。也可通过 https://api.402xagent.com/mcp 使用 MCP 工具 discover。— withgrokbot

一行试用

在我们最近的付费调用中，哪个 x402 网络搜索端点成功返回结果，且价格不超过 $0.01？无需密钥；每个客户端每天（UTC）可免费查询 5 次：

curl -s "https://verified-catalog-lookup.withgrokbot.workers.dev/v1/lookup?task=web-search&max_price=0.01&ref=via-readme"

const r = await (await fetch("https://verified-catalog-lookup.withgrokbot.workers.dev/v1/lookup?task=web-search&max_price=0.01&ref=via-readme")).json();

结果先按我们最近付费调用中的已知答案通过率排序，再按价格排序；每条结果都附有 Base 结算回执。其他任务：/v1/tasks。可选参数 client=<your agent name>；ref 仅用于说明你从哪里找到此链接。

定价

• 每个客户端每天（UTC）可免费查询 5 次。 如果你发送了 client 值，则该值就是客户端标识；否则使用经过加盐处理的 IP 哈希（绝不存储原始 IP）。计数器于 00:00 UTC 重置。只有 /v1/lookup 计入次数；/v1/tasks、/openapi.json 和静态目录文件均免费。
• 超出免费次数后，每次查询需通过 x402 支付 $0.02 USDC（Base 网络）。 查询会通过 v2 PAYMENT-REQUIRED 标头（exact 方案、eip155:8453、USDC，payTo 0x37cfCC8a29e9ff9458902B29E31E42dc7B718674）返回 HTTP 402。请使用 PAYMENT-SIGNATURE（或 X-PAYMENT）标头重试；付款会经由公开的 PayAI x402 facilitator 验证并结算，结算交易会通过 PAYMENT-RESPONSE 标头和响应中的 access 块返回。
• 付款绝不会改变结果、排序或列表内容。 付款仅用于获取查询权限。免费、付费和豁免查询运行相同代码并使用相同数据，因此结果完全一致；卖家无法付费获取更好的展示位置，任何检查结果或已知答案结果也不取决于付款方。每个查询响应都会在 payment_policy 中重申这一点。

远程 MCP 服务（免费）

https://verified-catalog-lookup.withgrokbot.workers.dev/mcp（Streamable HTTP，无状态 JSON-RPC，无需密钥）。工具和结果与 mcp/server.py 相同：search_catalog、get_service 和 lookup。lookup 使用客户端名称 vc-mcp，因此会计入该客户端每天（UTC）的 5 次免费查询额度；超过额度后会报告 402，不会代为付款。注册表名称：io.github.withgrokbot/verified-catalog（server.json）。

始终付费的端点（x402）

GET https://verified-catalog-lookup.withgrokbot.workers.dev/v1/lookup/paid?task=web-search&max_price=0.01 接受相同参数，返回与 /v1/lookup 相同的结果，每次调用需支付 $0.02 USDC（Base 网络），且没有免费额度。其 402 响应包含 x402 Bazaar 发现元数据（extensions.bazaar）；该端点也列在 /openapi.json（x-payment-info）和 /.well-known/x402 中。无效参数会在结算前返回 400。

产品

通过同一个 Worker 使用 x402 销售的付费数字下载内容（始终付费；不适用免费查询额度和 SELF_CLIENTS）：

• 过夜幕僚长设置包 — $9 USDC（Base 网络）。GET https://verified-catalog-lookup.withgrokbot.workers.dev/v1/products/overnight-cos-pack（或 MCP 工具 get_overnight_cos_pack）。未付款的调用会返回包含 Bazaar 发现元数据的 HTTP 402。付款后可获得提示词、HTML 晨间简报模板和 PDF 指南。

文件

• index.html、services/<id>.html、methodology.html：网站（不使用 JavaScript，不向其他主机发送请求）
• catalog.json、services/<id>.json、llms.txt、.well-known/agent-card.json：机器可读文件
• data/services.json：种子列表（每项均注明来源和检索日期），data/site.json：品牌／仓库设置
• results/latest.json、results/history.jsonl、results/raw/<run>/<id>.json、results/spend_ledger.json：检查结果和证据
• scripts/run_checks.py：运行检查（默认免费／试运行）并重建；scripts/build_site.py：仅重建
• data/quality_tests.json、scripts/quality.py：每次付费调用都会运行的已知答案测试（通过／失败；服务不可用时仅提供“事实”）
• receipts.json：每次付费调用的记录（时间、费用、附有 Basescan 链接的结算交易、交付内容、已知答案测试结果）
• worker/：可靠性查询，一个 Cloudflare Worker（GET /v1/lookup?task=web-search&max_price=0.01&n=5），从本网站读取 catalog.json 和 receipts.json，并统计不同客户端的数量（参见 worker/README.md）
• mcp/server.py：小型 stdio MCP 服务，包含 search_catalog、get_service（读取 catalog.json）和 lookup（调用 Worker）；Worker 通过 /mcp 远程提供相同工具
• server.json：官方 MCP Registry 条目（远程服务）
• scripts/demand_weekly.py：每周统计不同的查询客户端数量 -> results/demand_weekly.json
• .github/workflows/daily.yml：每日免费检查并提交

运行

python3 scripts/run_checks.py            # free checks, no payment (default)
python3 scripts/build_site.py            # rebuild pages from data/ and results/
python3 tests/run_tests.py               # acceptance tests (Node 18+ for the Worker tests)

付费检查已提供，但默认关闭。使用时需要添加 --pay、指定此文件夹外的钱包文件（--wallet），并运行 pip install -r scripts/requirements-pay.txt。硬性上限：每次调用 $0.10、每天（UTC）$1.00、终身 $20.00；只会签署 Base 上的 USDC “exact”交易。

我们只发布事实，不评定等级。我们不持有客户资金，也不参与任何卖家交易；免费额度之后的查询费用将转入我们自己的钱包。若要对某项结果提出异议，请创建 GitHub issue（参见 methodology.html#contest）。

许可证

MIT，详见 LICENSE。