前言¶
做 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 流程上。
