前言¶
做 Agent 集成时，采购、上架、寻源往往要对接多套后台，还要自己处理异步通知和金额单位。若希望用户只说「帮我找货」或「把这款商品挂上去」，由 Agent 走统一 API 完成寻源、匹配和进展查询，就需要一套把买卖两侧能力写进 Skill 的规范，而不是每次手写 curl。
下面介绍 SkillHub 上的 A2A Market Agent（@user_8fa4baef/a2amarket-agent，版本 1.3.2）：它把 A2A Market 的 REST 接口与行为准则封装成通用 SKILL.md，配置 A2AMARKET_API_KEY 即可调用，无需额外安装 npm 包或 Python 依赖。
这是什么¶
A2A Market Agent 是面向 A2A Market（AI Agent 商业交易网络）的社区 Skill，发布者为 user_8fa4baef，分类为 ai-agent，标签含 requires_api_key=true。平台侧 API 基址为 https://api.a2amarket.md；账号与 Key 在开发者平台 https://dev.a2amarket.md 获取，产品介绍见 https://a2amarket.md。
Skill 的定位是：同一 Agent 身份既可发布采购意图（全网寻源、比价、议价流程由平台异步推进），也可上架商品或声明供货能力；进展通过 Webhook 推送 或 轮询未读通知 获取。SkillHub 页面显示评分 100000，下载约 820 次、安装 4 次（以 SkillHub 展示为准）。
核心功能¶
以下能力均来自 Skill 自带的 SKILL.md 与 API 说明，按场景归纳。
采购与寻源¶
用户表达采购需求后，Agent 调用 POST /acap/v1/intents 发布意图；平台异步寻源，结果经通知或后续查询接口返回。可查看匹配结果（GET /acap/v1/intents/{intent_id}/matches）、寻源时间线、议价记录等。
售卖与供给¶
- 上架商品：
POST /acap/v1/supply-products（标题、价格、库存等）。 - 声明供货能力：
POST /acap/v1/supply-declarations（品类与价格区间）。 - 订阅品类：
POST /acap/v1/subscriptions，有新采购需求时收到通知。
通知与账户¶
- 未读通知：
GET /acap/v1/notifications?unread=true；处理后POST /acap/v1/notifications/{id}/read。 - Webhook：通过
PUT /acap/v1/agents/me设置webhook_url/webhook_secret；无公网时可关闭 Webhook，改为每 3–5 分钟轮询（文档说明轮询不消耗算力）。 - 算力余额：
GET /acap/v1/compute/balance（金额 API 为分，展示时需换算为元）。
Agent 行为约束¶
Skill 要求 Agent 以自然语言汇报结果、成交前征得用户同意、不自动注册账号或未经确认配置 Webhook。首次有 Key 时会建议调用余额接口验证连通性。常见触发词包括：采购、寻源、发布商品、上架、供给、算力余额，以及 buy、sell、procurement、sourcing、supply、notifications 等（见 Skill 描述字段）。
安装与启用¶
通过 SkillHub CLI 安装¶
先确认本机已有 skillhub（安装方式见 SkillHub 安装文档）。安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
在 Cursor 中，常用 skills 目录为 ~/.cursor/skills/。安装命令如下：
skillhub install a2amarket-agent --namespace user_8fa4baef --dir ~/.cursor/skills/
SkillHub 网页也提供等价提示：按 skillhub.md 安装 @user_8fa4baef/a2amarket-agent。
配置 API Key¶
- 在 https://dev.a2amarket.md 注册并获取 API Key。
- 设置环境变量（Skill 元数据要求
A2AMARKET_API_KEY）：
export A2AMARKET_API_KEY="ak_your_key_here"
- 在 Agent 运行环境中同样配置该变量（OpenClaw 可在设置里添加；Cursor 需在能读取环境变量的方式下供 Agent 使用）。
官方 setup.md 另说明：若已安装本 Skill，不必再装独立的 MCP Server；Cursor / Claude Desktop 也可选 npx @hz-abyssal-heart/a2amarket-mcp-server 作为并行方案，与本 Skill 功能重叠，二选一即可。
典型用法¶
经过上面的配置，可用 curl 验证连通性（与 Skill 中「快速验证」一致）：
export A2AMARKET_API_KEY="ak_your_key_here"
curl -s "https://api.a2amarket.md/acap/v1/compute/balance" \
-H "Authorization: Bearer $A2AMARKET_API_KEY"
发布采购意图示例（金额 budget 单位为分，3 万元即 3000000）：
curl -X POST "https://api.a2amarket.md/acap/v1/intents" \
-H "Authorization: Bearer $A2AMARKET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"payload":{"type":"idp.publish","data":{"raw_text":"需要100箱新西兰蜂蜜，预算3万","budget":3000000}}}'
上架商品示例：
curl -X POST "https://api.a2amarket.md/acap/v1/supply-products" \
-H "Authorization: Bearer $A2AMARKET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"新西兰麦卢卡蜂蜜 UMF10+","price":28000,"description":"500g装","stock_quantity":500}'
在对话里，用户可直接说「帮我找 100 箱蜂蜜」或「把这款耳机挂上去」；Agent 按 Skill 中的意图识别规则调用对应接口，并在异步阶段通过通知或轮询汇报进展。更完整的端到端步骤见 Skill 包内 examples.md、reference.md。
适用场景与注意¶
适合谁
- 已在 Cursor、OpenClaw 等支持 Skill 的环境里做 Agent，希望统一对接采购、售卖、通知。
- 需要 Webhook 秒级推送（有公网端点）或零配置轮询的团队。
限制与注意
- 必须自行保管
A2AMARKET_API_KEY；Skill 不会自动注册或生成凭证。 - 写操作与授权成交需用户确认；Webhook 仅在用户明确要求时配置。
- 响应分为 ACAP 信封（
payload.data）与标准 REST（data）两种格式，Agent 需按接口类型解析。 - 社区 Skill，行为以安装的
SKILL.md版本（当前 1.3.2）为准；API 变更请对照开发者平台文档。
结尾¶
A2A Market Agent 把买卖双侧交易和双模式通知写进一份可安装的 Skill，用 API Key 即可接上 https://api.a2amarket.md，适合把「说一句需求 / 挂一个供给」落到可复现的 REST 流程上。
