ckjia-shopping
跨平台比价与购物推荐 / Cross-platform price comparison. 淘宝 / 京东 / 天猫 / 拼多多商品聚合搜索 + 拍图识物。需要先启用 ckjia-shopping MCP server 并配置 CKJIA_MCP_KEY 才能用。
- License 许可
- Apache-2.0
- 最近更新
- 2026-06-25
- Stars
- ★ 4
- Forks
- 4
01 前言 Front Matter
- icon
- /skill-assets/ckjia-shopping/assets/ckjia_app_icon.png
- name
- ckjia-shopping
- tags
- [ "shopping", "price", "ecommerce", "比价", "购物" ]
- type
- mcp
- nameEn
- CKJIA Shopping
- nameZh
- 参考价 - 比价购物
- version
- 1.0.1
- category
- data
- optional
- true
- description
- 跨平台比价与购物推荐 / Cross-platform price comparison. 淘宝 / 京东 / 天猫 / 拼多多商品聚合搜索 + 拍图识物。需要先启用 ckjia-shopping MCP server 并配置 CKJIA_MCP_KEY 才能用。
- allowed-tools
- [ "ckjia_shopping_recommend", "ckjia_image_recognize", "ckjia_ping" ]
02 资源文件 4
- 资产文件assets/ckjia_app_icon.png16.8 KB
- 资产文件assets/ckjia_logo_dark.png11.5 KB
- 资产文件assets/ckjia_logo_new.png12.5 KB
- 资产文件assets/ckjia_logo.png10.1 KB
03 SKILL.md 正文
<!-- NOTE: dependencies.tools intentionally omitted. The three MCP tools (ckjia_shopping_recommend / ckjia_image_recognize / ckjia_ping) live on a remote MCP server and are registered into ToolRegistry at runtime via McpToolCallbackProvider — they're never persisted to the mate_tool table that SkillDependencyChecker.selectCount queries, so listing them here would permanently mark the skill as "unresolved". Tool availability is enforced by the ckjia-shopping MCP server being enabled + healthy in Settings ▸ MCP Connections instead. -->
参考价 - 比价购物
当用户询问"X 多少钱 / 哪里便宜 / 帮我推荐 X / 这个值不值买 / 拍照认一下这是什么"时使用本技能。
决策树
- "推荐 / 帮我挑 / 性价比 / 想买 X" →
ckjia_shopping_recommend(query, top_n=5)- 想要 ckjia 顺便给出意图理解(用于澄清后续问句)→
include_intent=true
- 想要 ckjia 顺便给出意图理解(用于澄清后续问句)→
- 附带图片 / 拍照识物 →
ckjia_image_recognize(image_url)→ 拿到suggested_query后再ckjia_shopping_recommend(suggested_query) - transport 健康自检 →
ckjia_ping("hello"),验证 MCP 链路通
输出格式(强制规则,零容忍)
每个 ProductCard 已经预渲染了两个开箱即用字段,直接复制粘贴这两个字符串到回复,不要自己拼装:
markdownLink—— 已经是[商品名](购买URL)格式,照抄即可priceTag—— 已经是¥4099 ~~¥4499~~ (9% off)格式,照抄即可
必须遵守的输出模板
1. {{markdownLink}}
- 💰 {{priceTag}}
- 🛒 {{platformLabel}} · {{shopName}}
- 📊 评分 {{rating}} · 销量 {{salesCount}}
- 💡 历史最低 ¥{{lowestPrice}}
- {{purchaseAdvice}}
把双花括号 {{xxx}} 替换成 ProductCard 对应字段的值。markdownLink 一定要原样输出,不要把它拆开后用其它方式重组。
真实示例
工具返回:
{
"name": "格力空调 云佳pro 1.5匹...",
"url": "https://union-click.jd.com/jdc?e=...",
"markdownLink": "[格力空调 云佳pro 1.5匹...](https://union-click.jd.com/jdc?e=...)",
"priceTag": "¥3057",
"platformLabel": "京东",
...
}
正确输出:
1. [格力空调 云佳pro 1.5匹...](https://union-click.jd.com/jdc?e=...)
- 💰 ¥3057
- 🛒 京东
严禁的错误(出现任何一条都算回复失败)
- ❌ 不输出
markdownLink—— 用户没法点击购买 - ❌ 把 markdownLink 拆开只取商品名 —— 等于丢弃链接
- ❌ 编造任何不在 ProductCard 字段里的 URL
- ❌ 输出
[商品名](url)但中间填占位符或省略号
其它字段处理
intent字段是给 agent 自己看的"我理解对了吗"——拿到后若budgetRange与用户原话不符,应主动澄清needsClarification=true时,把clarificationQuestion+clarificationOptions直接抛给用户选,不要硬猜
注意
- 同一个 query 不要在一次对话里反复调用 —— ckjia 侧已有缓存,重复调用浪费配额
- 用户未登录时不必填
user_id;当前 Phase 1 所有调用以 API key owner 身份执行 mate_mcp_server里预置的 localhost URL 只用于本地开发/测试;生产启用前必须在Settings ▸ MCP Connections改成 ckjia 官方 SaaS 域名或私有部署域名- API key 由管理员在 ckjia 控制台申请后填入 mateclaw
Settings ▸ MCP Connections的headers_json,使用${CKJIA_MCP_KEY}环境变量占位符避免明文落库 - 触发 429
rate_limited时按Retry-After等待一次,再失败就汇总现有结果而不是无限重试
如何申请 API Key
- 访问 ckjia 控制台
https://ckjia.com/console/mcp-keys(自助申请页面 P2 落地后开放;Phase 1 需联系运维手工签发) - 选
free/standardtier 与勾选所需 scopes - 一次性获得明文 key(形如
ckjia_mcp_live_5fK8j2nQ…) - 在 mateclaw 部署环境配
CKJIA_MCP_KEY=ckjia_mcp_live_xxx - Settings ▸ MCP Connections 将
ckjia-shopping的 URL 改为生产域名后再启用
04 同仓库更多 Skills
sample
Test fixture for SkillBundleMaterializer.
x_intel
Read X (Twitter) posts, search, timelines and user profiles via the official xurl CLI.
writing-plans
Write implementation plans: bite-sized tasks, paths, code.
webhook-subscriptions
Webhook subscriptions: event-driven agent runs.
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.
systematic-debugging
4-phase root cause debugging: understand bugs before fixing.