用途：为 AI 智能体提供 x402 按次付费（pay-per-call）服务的静态、机器可读目录，并附自动化检查的事实结果。可按任务和价格上限查找服务，结果按近期付费调用中的已知答案通过率排序，再按价格排序，并附 Base 链结算凭证。
主要能力：提供 /v1/lookup 查询接口，支持 task、max_price、n 等参数；提供 /v1/tasks 任务列表；提供远程 MCP 服务器（Streamable HTTP、无状态 JSON-RPC、无需密钥），含 search_catalog、get_service、lookup 三个工具，与 mcp/server.py 结果一致。目录文件包括 catalog.json、services/<id>.json、llms.txt、.well-known/agent-card.json 等；检查结果与证据存于 results/ 目录，receipts.json 记录每次付费调用。
使用方式：免费额度为每个客户端每 UTC 日 5 次查询，客户端标识为传入的 client 值，否则为 IP 的加盐哈希（不存原始 IP），计数于 00:00 UTC 重置。超出后每次查询 0.02 USDC（Base 链），通过 x402 支付：未付费返回 HTTP 402 与 v2 PAYMENT-REQUIRED 头（exact 方案、eip155:8453、USDC、payTo 0x37cfCC8a29e9ff9458902B29E31E42dc7B718674），重试时带 PAYMENT-SIGNATURE 或 X-PAYMENT 头，经 PayAI x402 facilitator 验证结算，结算交易在 PAYMENT-RESPONSE 头与响应 access 块中返回。另有始终付费端点 /v1/lookup/paid，参数与结果相同，每次 0.02 USDC，无免费额度。
适用场景：需要为智能体挑选可靠 x402 服务、比较价格与通过率、获取可验证结算凭证的场景。
限制：支付仅购买查询访问权，不影响结果、排序或收录；免费、付费与豁免查询使用相同代码与数据，结果一致，卖家无法付费获得排名。付费数字下载（如 Overnight Chief of Staff Setup Pack，9 USDC）始终付费，不适用免费额度。付费检查默认关闭，需 --pay、外部钱包文件与依赖，且有硬性上限（每次 0.10 美元、每 UTC 日 1.00 美元、终身 20.00 美元），仅签署 Base 上 USDC 的 exact 方案。项目仅发布事实、不做评级，不持有客户资金，也不是卖家交易的一方；对结果有异议可通过 GitHub issue 提出。许可为 MIT。
