ReturnCheck

ReturnCheck — 为 AI 购物 Agent 验证退货政策

ReturnCheck 可验证本次购买实际适用的退货政策。 对于 AI 购物 Agent，它会给出已验证的判定，而非猜测。

提供 product_url 和 buyer_country，它会返回判定结果 （YES / YES_WITH_CONDITIONS / NO / UNKNOWN），并附上页面中的准确政策条款引用、来源 URL、退货期限和置信度评分。如果无法验证页面上的条款，它会返回 UNKNOWN——绝不编造。

专为 Agent 对 Agent 的商业交易打造：提供 MCP 工具，并支持 x402 友好的微定价，每条已验证的回答收费 $0.02（UNKNOWN 免费；另提供无需密钥的免费试用）。

---

可复现的开发者演示

四种判定结果的证据演示：合成测试案例和已记录的 IKEA US 检查

包含已记录的 YES、YES_WITH_CONDITIONS、NO 和 UNKNOWN 响应、原始测试来源链接、一个 IKEA 真实商家的案例，以及可运行示例。四种判定结果的测试材料均为合成内容；只有 IKEA 案例使用调用方提供的真实商家政策文本。这不是独立基准测试、实时重新测试，也不代表原生兼容 UCP。

为什么要构建它

AI Agent 已开始购买商品。购买前，它们需要知道一笔交易是否可撤销——而如今，没有人能以机器可信任并据此行动的方式回答“这件商品能退吗？”。ReturnCheck 正是为此提供中立的验证基础工具：它面向所有购物 Agent 提供服务，不与任何一方竞争。

快速开始

MCP（Streamable HTTP）——工具：check_return

https://returncheck.m-angelmartinez-fer.workers.dev/mcp

HTTP

curl -X POST https://returncheck.m-angelmartinez-fer.workers.dev/v1/check \
  -H "content-type: application/json" \
  -d '{"product_url":"https://store.example/p/shoe","buyer_country":"US","item_condition":"unopened"}'

如果你已经获取了商品或政策页面的内容，可通过 page_html 或 page_text 传入——ReturnCheck 会据此进行验证并跳过抓取（覆盖效果最佳，也可绕过阻止服务端读取的网站）。它仍绝不编造。

如果这些内容来自单独的政策页面，还应通过 page_source_url 传入其 HTTP(S) URL。这样既能在 evidence.source_url 和语料库中保留所提供的来源，也能继续将 product_url 作为商品上下文。该 URL 由调用方声明，不会被独立抓取。若未提供，则仍使用现有的 product_url 回退逻辑；提供不同页面的旧版调用方应添加此字段。仅当存在明确相邻的一般性条款时，才会推断已打开商品的替代选项；条款含糊、针对特定类别或相互冲突时，仍需走常规验证流程。

x402 付费调用

付费 HTTP 路由使用同一端点：POST /v1/check。

如需查看当前生效的 x402 条款而不消耗免费额度，请发送不带请求体的 POST /v1/check，且不要提供 PAYMENT-SIGNATURE。ReturnCheck 会返回当前生效的 402 挑战。此发现探测请求不要发送 {} 或实际的检查请求体。

进行付费调用时，请将 JSON 信封进行 base64 编码，并放入 PAYMENT-SIGNATURE 请求头：

{
  "x402Version": 2,
  "accepted": {
    "scheme": "exact",
    "network": "eip155:8453",
    "amount": "20000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0xbF428071027402E9b0cE85e22146EDdc028cEB3b",
    "maxTimeoutSeconds": 60,
    "extra": { "name": "USD Coin", "version": "2" }
  },
  "payload": {
    "signature": "0x...",
    "authorization": {
      "from": "0x...",
      "to": "0x...",
      "value": "20000",
      "validAfter": "0",
      "validBefore": "...",
      "nonce": "0x..."
    }
  },
  "extensions": {
    "payment-identifier": {
      "info": {
        "required": true,
        "id": "unique-id-16-to-128-chars"
      }
    }
  }
}

规则：

• accepted 是完整的已接受付款要求对象，而非布尔值。
• payload 直接包含 signature 和 authorization。
• 规范标识符路径为 extensions["payment-identifier"].info.id。
• 不要将 bazaar 发现扩展复制到 PAYMENT-SIGNATURE 中。
• 当前生效的 402 挑战是付款条款的权威依据。
• 已签名请求会直接进入付款流程；无需先用尽免费额度。
• 使用相同的端点、请求体、标识符、签名和 nonce 重放同一笔付费操作。如果授权在付费调用前过期，请重新签发授权；随后应重放该新授权。
• 若结算结果为 pending、unconfirmed、HTTP 500 或其他不明确状态，在核实首次结果前，不要创建第二份授权。

返回内容

{
  "verdict": "YES_WITH_CONDITIONS",
  "returnable": true,
  "confidence": 0.9,
  "policy": { "merchant_return_days": 30, "return_category": "FiniteReturnWindow" },
  "evidence": {
    "source_url": "https://store.example/policies/refund-policy",
    "exact_clause": "Items may be returned within 30 days of delivery for a full refund.",
    "verified_on": "2026-08-23"
  }
}

定价

已验证答案（YES / NO / 条件）	$0.02
UNKNOWN	免费
免密钥免费试用	每天可调用几次，无需注册

面向 Agent 的发现

• OpenAPI：/openapi.json
• 插件清单：/.well-known/ai-plugin.json
• Agent 清单：/agents.json
• LLM 清单：/llms.txt
• MCP 工具列表：/mcp

确定性预检

运行 npm run check，验证已注册的工作并运行完整回归测试套件。 使用 npm run work:new -- ucp job-name 注册新工作（也提供支付、语料库和 制品配置文件）。每次推送和拉取请求时，所有已注册的任务都会自动运行。永久 审查流程见 AGENTS.md。已注册任务现在要求提供与确切输入绑定的审查回执。检查还会 检测未覆盖的变更文件和跨批次语料库污染。交付和历史指标配置文件提供软件包／快照及基准测试检查。

审查支付软件包、UCP 证据或语料库变更前，运行 npm run validate。三个离线配置文件会生成 PASS/FAIL、阻断性错误、警告、SHA-256 哈希值以及需要后续 AI 审查的字段。输入约定、限制和命令见 preflight/README.md。 npm test 包含预检回归测试。PASS 不代表已获准部署或付款。

设计原则

• 绝不臆造。 每个确定性判定都包含一条经过页面逐字验证的条款。如果无法验证，答案就是 UNKNOWN。
• 冻结的契约（v1.0）。 只添加字段，绝不破坏现有字段。
• 美国数据优先，全球化架构。 在边缘端完全以无服务器方式运行（Cloudflare Workers + D1 + Workers AI）。

关键词

退货政策 API · 退货验证 · AI 购物 Agent · Agent 商务 · MCP 服务 · check_return · x402 · Agent 间支付 · 电商退货 · 这件商品可以退货吗 · 退款政策检查器