// Skill 是主路径：搜索 → 选择 Route A 0 元对象 → 获取内容 → 使用后评分
请先读取 <市场地址>/SKILL.md，并按其中约定工作。
1. 搜索并优先选择 Route A 的 0 元对象。
2. 付费对象逐笔确认：每次 acquire 前列出对象、单价和累计花费，等我确认后再执行。
3. 获取内容后先判断它是否真的能参与当前任务；不能使用就明确说明原因。
4. 内容确实参与任务后，使用返回的 platform_transaction_id 提交 1-5 分使用后评分，used=true。
不要自动购买付费对象，不要调用 Route B provider，不要重复 acquire。无账号注册、无 API Key 申请。付费主路径读取 /SKILL.md， 把当前 Payment-Needed Header 原值交给官方支付宝 402 买家支付能力 alipay-bot 402-buyer-pay；官方命令支付并恢复原请求，不要手动重试 acquire。SDK 的 payment_proof 仅是自备 Proof 适配器协议。只有 status=delivered 且 record_source=platform_authoritative 的交易可评分；同会话同对象只能评分一次。 付款不由 SDK 完成，浏览器不模拟支付。
// 最快的接入方式：让 Agent 先读取 /SKILL.md，并按 Skill 指引安装/确认 CLI
// Agent 先读取 Skill，再安装/确认 CLI；每笔付费获取前等用户确认。
// 高级参考：目录免费浏览，完整内容按次计费
| 方法 | 说明 | 关键参数 | 返回 |
|---|---|---|---|
| client.knowledge.query | 搜索知识库，返回货架目录（含 preview / 价格 / 调用量，不含完整 content） | query, value_type?, route_type? | 目录条目列表 |
| client.knowledge.get | 按 object_id 精确查对象详情与 input_schema | object_id | 对象详情 |
| client.knowledge.acquire | 按路线获取完整内容 —— SDK 内部在路线A／路线B 间分流；0 元档自动完成，付费档不代付（返回 402；官方支付改用 /SKILL.md，payment_proof 仅自备 Proof 适配器）。不要自行拼装 provider.acquire_url | object_id, query_params?, payment_proof? | 完整内容；付费未带 proof 时为 402 + 账单 |
| client.knowledge.rating | 内容实际参与任务后提交 1-5 分评分；仅平台签发且已交付的交易可评 | object_id, platform_transaction_id, rating, used, comment? | 评分结果 |
// Python 3.12+ 只装客户端：pip install git+https://github.com/CongQIANFN/agentmarket-sdk.git；未发布 PyPI。示例 API Base：https://api.agentmarket.org.cn/api/v1。
// 仅当宿主不支持 Skill / 系统提示时使用；付费默认关闭
{
"mcpServers": {
"agentmarket": {
"command": "/absolute/path/to/agentmarket/.venv/bin/agentmarket-mcp",
"env": { "AGENTMARKET_BASE_URL": "http://127.0.0.1:8000/api/v1" }
}
}
}// 当前 agentmarket-mcp 未发布 npm 包；公开 GitHub 仓库只包含 SDK/CLI 客户端必要代码。生产地址替换为您的 AGENTMARKET_BASE_URL。AGENTMARKET_AUTO_PAY 默认为 0，付款不由 MCP/SDK 完成。Skill 可用时优先使用 /SKILL.md。
// 官方 402 买家路径：Payment-Needed 原值交接 → alipay-bot 支付并恢复原请求
Agent 调用 acquire_knowledge({object_id})，SDK 向内容端点发起普通请求。
服务端返回 402 与 Payment-Needed Header。账单在 Header 中，Agent 不解码、不改写。
把 Header 原值、原始资源 URL、method、body 和业务 Header 交给 alipay-bot 402-buyer-pay。
官方命令支付后恢复原始资源请求并发送履约回执，返回 200 + 完整内容。
| 计费口径 | 说明 |
|---|---|
| price_cents | 单位为分/次（15 = ¥0.15/次）；部分对象提供 0 元免费档 |
| 计费触发 | 仅 acquire 成功交付计费；query / get 永远免费 |
| 参数化对象 | 先 get_knowledge 拿 input_schema，acquire 时作为 query_params 传入 |
// 两条路线，一个入口 —— SDK 内部分流，买家与 Agent 无感
| 路线 | 含义 | 托管方 | 担保 |
|---|---|---|---|
| A · platform_hosted | 平台托管内容并统一结算 | AgentMarket 平台 | 平台提供平台侧交易记录与交付状态 |
| B · seller_managed | 开发者系统直接履约（对象带 provider.acquire_url） | 卖家自己的端点 | 平台仅提供发现入口，并展示开发者已回传的状态 |
// Agent 应当理解的返回语义
| 状态 | 含义 | Agent 处理 |
|---|---|---|
| 402 | 需要支付（协议内正常流程） | 按 /SKILL.md 交接当前 Payment-Needed 原值给官方 402 买家支付能力 |
| 404 | object_id 不存在 | 回 query_knowledge 重新发现 |
| 410 | 对象已过期（valid_until 已过） | 过期对象不会出现在目录，勿重试 |
| 422 | query_params 不符合 input_schema | 按错误详情修正参数 |
| 429 | 调用频率超限 | 退避后重试 |
// 常见问题
Q：买家需要注册账号吗？
A：不需要。目录浏览免费；acquire 对 0 元档直接交付，付费档返回 402 并由外部支付宝 A2M 能力完成支付。
Q：什么时候评分？
A：内容确实参与当前任务后评分；used=true 表示真实使用，评分需要返回的 platform_transaction_id。
Q：怎么保证信任信号可信？
A：调用量、付费买家会话、转化率均由平台侧统计生成，卖家无法自报；付费买家会话按已关联交易会话统计，不代表唯一用户数。
Q：Route B 出问题找谁？
A：Route B 的交易与履约由开发者系统负责；平台只展示开发者已回传的状态，不代替卖家售后结论。纠纷请直连 provider。