mateclaw/mateclaw-server/src/main/resources/skills/ckjia-shopping/SKILL.md

name	version	icon	description	category	type	dependencies
ckjia-shopping	1.0.0	/skill-assets/ckjia-shopping/assets/ckjia_logo_new.png	跨平台比价与购物推荐 / Cross-platform price comparison and shopping recommendation. 淘宝 / 京东 / 天猫 / 拼多多商品聚合搜索，拍图识物，AI 购物意图识别。Phase 1 ships shopping_recommend + image_recognize; unified_search / price_history / compare_skus 在后续迭代追加。	data	mcp	tools ckjia_shopping_recommend ckjia_image_recognize ckjia_ping

查价 · 比价购物

当用户询问"X 多少钱 / 哪里便宜 / 帮我推荐 X / 这个值不值买 / 拍照认一下这是什么"时使用本技能。

决策树

1. "推荐 / 帮我挑 / 性价比 / 想买 X" → ckjia_shopping_recommend(query, top_n=5)
   • 想要 ckjia 顺便给出意图理解（用于澄清后续问句）→ include_intent=true
2. 附带图片 / 拍照识物 → ckjia_image_recognize(image_url) → 拿到 suggested_query 后再 ckjia_shopping_recommend(suggested_query)
3. transport 健康自检 → ckjia_ping("hello")，验证 MCP 链路通

输出渲染建议

• recommendations: ProductCard[] 在 chat UI 自动渲染成卡片网格（移动端单列、桌面端多列）
• intent 字段是给 agent 自己看的"我理解对了吗"——拿到后若 budgetRange 与用户原话不符，应主动澄清
• needsClarification=true 时，把 clarificationQuestion + clarificationOptions 直接抛给用户选

注意

• 同一个 query 不要在一次对话里反复调用 —— ckjia 侧已有缓存，重复调用浪费配额
• 用户未登录时不必填 user_id；当前 Phase 1 所有调用以 API key owner 身份执行
• API key 由管理员在 ckjia 控制台申请后填入 mateclaw Settings ▸ MCP Connections 的 headers_json，使用 ${CKJIA_MCP_KEY} 环境变量占位符避免明文落库
• 触发 429 rate_limited 时按 Retry-After 等待一次，再失败就汇总现有结果而不是无限重试

如何申请 API Key

1. 访问 ckjia 控制台 https://ckjia.com/console/mcp-keys（自助申请页面 P2 落地后开放；Phase 1 需联系运维手工签发）
2. 选 free / standard tier 与勾选所需 scopes
3. 一次性获得明文 key（形如 ckjia_mcp_live_5fK8j2nQ…）
4. 在 mateclaw 部署环境配 CKJIA_MCP_KEY=ckjia_mcp_live_xxx
5. Settings ▸ MCP Connections 启用 ckjia-shopping 即可