用 AI 编码助手接入源头淘

给 Cursor / Claude / Codex / ZCode 等编码助手的接入提示词。复制下面整段给助手，它就能读懂我们的接口并替你完成集成。

提示词模板

你要帮我把我开发的 AI agent 接入"源头淘"商品货架（一个面向 AI agent 的电商后端）。

请先阅读以下两份资料再动手：
1. 机器可读接口说明：https://mcp.yuantoutao.com/llms.txt
2. API 参考：https://mcp.yuantoutao.com/docs/api-reference.html

约束：
- 认证用 Authorization: Bearer <key>（key 我会放在环境变量 YUANTOUTAO_API_KEY）
- 所有金额单位是人民币分（int），展示时除以 100
- 下单接口必须带 Idempotency-Key 头（UUID v4），重试时复用同一个值
- 不要传任何价格参数，价格以服务端返回为准
- 用户支付：桌面环境把 pay_url 渲染成二维码；手机环境跳转
- 下单前必须向用户复述商品、价格、收货信息并得到确认

请生成一个 TypeScript 模块 `yuantoutao.ts`，导出 searchGoods / getOrder /
createOrderWithRetry（含指数退避与幂等重试）三个函数，并附最小可运行示例。

为什么要专门做这一页

Rye 的实践证明：给编码助手一个"理解接口的入口"（llms.txt + 明确约束），能让开发者从打开文档到跑通第一笔调用的时间缩短一个量级。我们把这页当作接入文档的一部分持续维护——当你用 AI 助手接入遇到误解接口的地方，请提 issue 告诉我们哪句话该改。

沙箱先行

不需要等真实货源。用开源模拟商城先跑通逻辑（工具签名一致）：

npx commerce-mcp-sandbox --http 3300

把上面提示词里的端点换成 http://localhost:3300/mcp 即可（无需鉴权）。仓库：MeshTok/commerce-mcp