KH Merch Graph

KH Merch Graph

一个 MCP（Model Context Protocol）服务，可将《王国之心》周边商品的日文二手商品标题（Mercari、Yahoo! Auctions、Suruga-ya、Mandarake 等）转换为：可能对应的官方 SKU、商品描述中成色用语的实际含义、盗版风险提示、售价与官方建议零售价的比值，以及运送到你所在国家的到手成本估算。让任何兼容 MCP 的 AI Agent 使用它，再把商品信息交给它即可，剩下的工作由它完成。

在浏览器中试用（无需 AI Agent）： https://merchgraph.app

有何不同

1. 经过核实的商品目录，不靠抓取或猜测。 目录中的每个 SKU 都由人工对照一手来源（官方商品页面、制造商新闻稿等）核实过；每个条目都附有来源 URL，并会随每次匹配结果一并返回，方便你自行查证。服务内部不会使用 LLM 推断任何信息。
2. 没有把握，就不提供候选项。 匹配置信度较低时，本服务不会把猜测当作答案。低置信度匹配会单独放在 weak_matches 中返回，不会混入 candidates；如果 candidates 数组为空，表示“目录中可能没有这个商品”，而不是“尽力匹配的结果”。
3. 自带商品信息。 本服务不会自行爬取或抓取二手交易平台，也不会存储你发送的商品信息或 URL。你已经打开了商品页面，只需粘贴商品信息，本服务就会进行解读。

支持的 IP

目前仅支持《王国之心》。 目录中的每个 SKU 都由人工逐一核实，因此我们有意让目录缓慢扩充。如果你询问其他系列，本服务不会编造答案，而是会记录这项需求（参见数据来源与隐私），帮助决定下一步添加什么内容。如果你想推荐某个系列或具体的缺失 SKU，可以使用 report_correction 或提交 GitHub issue。

使用示例

连接此服务后，你可以向 AI Agent 提出以下请求（参见连接）。

1. “这件商品值得买吗？”

“我在 Mercari 上看到这个，售价 ¥8,000：一番くじ KINGDOM HEARTS -25th Anniversary- A賞 ソラ スタチュー 開封済み。 这是什么商品？价格合理吗？”

Agent 会调用 resolve_listing，并返回匹配的 SKU、官方建议零售价、价格比值、「開封済み」（“已拆封”）的含义，以及该 SKU 的一手来源链接。

2. “有哪些 ¥5,000 以下的索拉周边？”

“给我看看 ¥5,000 以下、可以摆出来展示的《王国之心》索拉周边。”

Agent 会调用 discover({ ip: "kingdom-hearts", character: "Sora", budget_jpy: 5000, purpose: "display" })，并返回符合这些筛选条件的目录 SKU 列表（这不代表其中任何商品目前正在任何平台出售——这是浏览商品目录，不是搜索二手交易平台）。

3. “运到美国后的总成本是多少？”

“那件商品售价是 ¥8,000，重量大约 400g。运到美国的总成本是多少？”

Agent 会调用 estimate_landed_cost({ price_jpy: 8000, weight_g: 400, dest_country: "US" })，并返回各路线的估算费用（代购服务费 + 运费），标出最便宜的选项，同时说明费率表上次核查的时间。

连接

• MCP 端点（Streamable HTTP、JSON-RPC 2.0，无需认证）：https://mcp.merchgraph.app/mcp（旧地址 https://kh-merch-graph.fandex.workers.dev/mcp 仍可使用）
• 健康检查：.../health
• 适用于通过 URL 发现服务的 AI Agent：.../llms.txt（简明易读的入口说明）和 .../openapi.json（架构参考——实际传输使用 MCP 自身的 tools/list/tools/call，这是为仅支持 OpenAPI 的工具提供的文档）

Claude Desktop / Claude.ai

使用上方的 MCP 端点 URL 将其添加为自定义连接器。无需 API 密钥或认证。

其他任何 MCP 客户端

使用 Streamable HTTP 传输连接到 /mcp 端点。tools/list 会返回下方全部五种工具的实时权威架构。

工具

工具	功能
resolve_listing	商品标题/描述 → SKU 候选项、成色术语、仿冒品警示标记、价格比例
resolve_listings_batch	一次调用中处理多个商品，与 resolve_listing 功能相同（默认每次最多 5 个，由 wrangler.toml 中的 MAX_BATCH_LISTINGS 设置）；结果按输入顺序排列
explain_product	sku_id 或自由文本查询 → 单个 SKU 的完整详情（系列、角色、尺寸、再版历史、来源）
discover	按 IP/角色/预算/用途浏览目录
estimate_landed_cost	商品价格 + 重量/SKU + 目的地国家 → 按运输路线估算到岸成本
report_correction	报告目录错误，或提供主要来源以提议新增 SKU

完整的输入/输出结构：docs/SPEC.md。

数据来源与隐私

• 目录中的每条记录都必须包含指向主要来源的 source_url；未经验证的记录会标记为 verified=false， 而不是在未经说明的情况下被视为可信。
• 此服务不会抓取、浏览或登录任何交易平台。它只会在单次请求期间读取 Agent 发送给它的文本。
• 公共部署上的使用日志仅包含：工具名称、匹配的 SKU ID、价格、目的地国家和时间戳。商品标题、描述以及你提供的任何 URL 都不会记录或存储。
• 如果 resolve_listing 未找到候选项，或有人通过 discover 查询目录中尚未收录的 IP，服务会记录少量、不具识别性的信号（少数已识别的关键词，或仅记录所查询的 IP 名称——绝不记录原始商品文本），以便维护者了解接下来需要添加什么。

免责声明

• 真实性提示不是结论。 flags 会指出值得向卖家询问的事项（例如价格远低于 MSRP、与仿冒品相关的材质/标记等）。此服务绝不会断言商品是真品或假货。
• 价格是用于规划的估算值，不是鉴定估值或报价。 MSRP 比例和到岸成本总额旨在帮助你判断是否需要进一步了解，不应作为购买决策或估值的依据。

报告更正或新增 SKU

调用 report_correction，提供你想修改的字段（若要提议新增商品，则将 sku_id 留空）、建议值，以及——重要的是——用于佐证的 source_url。你也可以提交 GitHub issue。

贡献 / 自行构建

此仓库也是一个循序渐进的教学套件，教你如何从零开始构建类似的 MCP 服务。完整设计请参阅 docs/GETTING_STARTED_JA.md（日语）和 docs/SPEC.md。许可证：MIT（参见 LICENSE）。第三方名称、徽标和图片不在许可范围内；请参阅 NOTICE。

流水线：运行中