Agent skill

Ckjia Shopping

by mateaix in mateaix/mateclaw

跨平台比价与购物推荐 / Cross-platform price comparison. An agent skill from mateaix/mateclaw.

Apache-2.0Auto-check passedAgent Workflows

Install Ckjia Shopping

skills CLI
$ npx skills add mateaix/mateclaw --skill ckjia-shopping -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mateaix/mateclaw ckjia-shopping --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mateaix/mateclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/mateclaw-server/src/main/resources/skills/ckjia-shopping .claude/skills/ckjia-shopping && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ckjia-shopping
GitHub stars
1.2k
Token cost
~958 tokens
SKILL.md length
188 words
Files
5 (incl. assets)
Skills in repo
17
Repo updated
First seen
Licence
Apache-2.0

At a glance

跨平台比价与购物推荐 / Cross-platform price comparison. An agent skill from mateaix/mateclaw.

  • Works in 3 steps: "推荐 / 帮我挑 / 性价比 / 想买 X / X 多少钱" →… → 附带图片 / 拍照识物 →… → transport 健康自检 → ckjia_ping("hello"),验证…
  • Tasks that involve MCP servers
  • SKILL.md covers 优先级(最高优先级规则), 决策树, 输出格式(强制规则,零容忍) and 其它字段处理, plus 2 more sections
  • Reaches ckjia.com and union-click.jd.com; needs CKJIA_MCP_KEY

What it does

Ckjia Shopping is an agent skill from mateaix/mateclaw. 跨平台比价与购物推荐 / Cross-platform price comparison. 淘宝 / 京东 / 天猫 / 拼多多商品聚合搜索 + 拍图识物。需要先启用 ckjia-shopping MCP server 并配置 CKJIAMCPKEY 才能用。

Its SKILL.md is about 960 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including assets.

It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol. The repository describes itself as: 🤖 MateClaw — Your second brain with Multi-Agent Orchestration, MCP Protocol, Skills & Memory, Dream, and Multi-Channel Support. Built on Spring AI Alibaba. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve MCP servers

Example prompts

  • “/ckjia-shopping”

Requirements

  • A credential in CKJIA_MCP_KEY
  • Pre-approved tools (allowed-tools): ckjia_shopping_recommend, ckjia_image_recognize, ckjia_ping

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. "推荐 / 帮我挑 / 性价比 / 想买 X / X 多少钱" → ckjia_shopping_recommend(query, top_n=5)
  2. 附带图片 / 拍照识物 → ckjia_image_recognize(image_url) → 拿到 suggested_query 后再 ckjia_shopping_recommend(suggested_query)
  3. transport 健康自检 → ckjia_ping("hello"),验证 MCP 链路通

What it can do on your machine

Read from SKILL.md and the folder at commit 10aad3b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • ckjia_shopping_recommend
    • ckjia_image_recognize
    • ckjia_ping

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • ckjia.com
    • union-click.jd.com
    • img14.360buyimg.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • CKJIA_MCP_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ckjia Shopping loads about 958 tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 188 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~37
When it runs · the whole SKILL.md, loaded when a task matches
~958

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mateaix/mateclaw at commit 10aad3b, republished under its Apache-2.0 licence (© mateaix). 188 words, ~958 tokens.

Download SKILL.mdSave it as .claude/skills/ckjia-shopping/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
ckjia-shopping
description
跨平台比价与购物推荐 / Cross-platform price comparison. 淘宝 / 京东 / 天猫 / 拼多多商品聚合搜索 + 拍图识物。需要先启用 ckjia-shopping MCP server 并配置 CKJIA_MCP_KEY 才能用。
allowed-tools
ckjia_shopping_recommend, ckjia_image_recognize, ckjia_ping
nameZh
参考价 - 比价购物
nameEn
CKJIA Shopping
version
1.0.1
optional
true
icon
/skill-assets/ckjia-shopping/assets/ckjia_app_icon.png
category
data
type
mcp
tags
shopping, price, ecommerce, 比价, 购物
<!-- 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 / 这个值不值买 / 拍照认一下这是什么"时使用本技能。

优先级(最高优先级规则)

只要用户的意图属于购物 / 比价 / 选购 / 报价(关键词:买、多少钱、价格、参考价、推荐、性价比、哪款好、值不值、京东/淘宝/天猫/拼多多……),必须先调用 ckjia_shopping_recommend 拿到结构化商品数据,再组织回答。

  • ✅ 先 ckjia_shopping_recommend → 拿到带图片和价格的真实商品
  • ❌ 不要直接用网页搜索 / 凭记忆报价 / 编造型号和价格来回答购物类问题
  • 仅当 ckjia_shopping_recommend 多次超时或返回为空时,才退回到网页搜索,并明确告诉用户"参考价数据暂不可用,以下为网络估算"

决策树

  1. "推荐 / 帮我挑 / 性价比 / 想买 X / 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 链路通

输出格式(强制规则,零容忍)

聊天界面能把商品渲染成带图片和价格的可点击卡片。要触发卡片,必须把推荐结果放进一个语言标记为 product-cards 的代码围栏里,围栏内是一个 JSON 数组,每个对象的字段值直接从工具返回的 ProductCard 原样复制(尤其 url / imageUrl 必须照抄,不能改写、不能编造)。

必须遵守的输出模板

先用一两句话给出整体结论(预算区间、推荐方向),然后紧跟卡片围栏,最后补充选购提醒:

markdown
🎯 你的预算内我挑了这几款,优先看 1.5 匹 / 新一级能效:

```product-cards
[
  {
    "name": "格力空调 云佳pro 1.5匹 新一级能效",
    "url": "https://union-click.jd.com/jdc?e=...",
    "imageUrl": "https://img14.360buyimg.com/.../xxx.jpg",
    "price": 3057,
    "originalPrice": 3299,
    "lowestPrice": 2999,
    "platformLabel": "京东",
    "shopName": "格力京东自营官方旗舰店",
    "purchaseAdvice": "卧室够用,关注是否含基础安装"
  }
]
```

提醒:空调到手价会受安装费 / 高空费 / 国补影响,下单前确认基础安装是否免费。

每个对象建议带的字段(缺失就省略,不要填占位符):name、url、imageUrl、price、originalPrice、lowestPrice、platformLabel、shopName、purchaseAdvice。

严禁的错误(出现任何一条都算回复失败)
  • ❌ 不输出 product-cards 围栏 —— 用户看不到卡片,也点不进购买页
  • ❌ 改写或编造 url / imageUrl —— 卡片会点开错误页面或图片裂开
  • ❌ 在围栏里填占位符、省略号或不完整 JSON —— 卡片会渲染失败
  • ❌ 把价格写进字符串而丢掉数字 —— 卡片无法对齐展示价格

兼容性:纯文本渠道(部分 IM)无法渲染卡片围栏,会退化成代码块。若当前对话明显是这类渠道,再退回到 1. [商品名](url) — 价格 的普通列表,并照抄 markdownLink。Web 聊天页一律用 product-cards 围栏。

其它字段处理

  • 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

  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 的 URL 改为生产域名后再启用

© mateaix, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (assets) in mateclaw-server/src/main/resources/skills/ckjia-shopping of mateaix/mateclaw.

  • SKILL.md
  • assets/ckjia_app_icon.png
  • assets/ckjia_logo.png
  • assets/ckjia_logo_dark.png
  • assets/ckjia_logo_new.png

Open the folder on GitHubat commit 10aad3b

Compare with similar skills

Ckjia Shopping next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ckjia Shopping compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ckjia Shopping this skillmateaix/mateclaw1.2k—~958Automated safety check: PassApache-2.0
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k4 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence
Context Mode Output Sandboxmksglu/context-mode26k—~4.1kAutomated safety check: PassCustom licence

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 4 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Migrates the compatible subset of settings and global file-based MCP servers from the Warp desktop app into Warp Agent CLI without exposing credentials or state.

    65k GitHub starsUsed in 1 repo~2.1k tokens
    Agent WorkflowsAuto-check passed

More from mateaix/mateclaw

All 17 skills in this repo
  • Pixel Art

    mateaix/mateclaw

    Pixel art w/ era palettes (NES, Game Boy, PICO-8). An agent skill from mateaix/mateclaw.

    1.2k GitHub starsUsed in 5 repos~1.8k tokens
    Auto-check passed
  • DOCX

    mateaix/mateclaw

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    1.2k GitHub stars~4.1k tokensUpdated 2 days ago
    Auto-check passed
  • XLSX

    mateaix/mateclaw

    Use this skill any time a spreadsheet file is the primary input or output.

    1.2k GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Execute plans via delegatetask subagents (2-stage review). An agent skill from mateaix/mateclaw.

    1.2k GitHub starsUsed in 3 repos~2.6k tokens
    Auto-check passed
  • Ideation

    mateaix/mateclaw

    Generate project ideas via creative constraints. An agent skill from mateaix/mateclaw.

    1.2k GitHub starsUsed in 2 repos~1.5k tokens
    Auto-check passed
  • Architecture Diagram

    mateaix/mateclaw

    Dark-themed SVG architecture/cloud/infra diagrams as HTML. An agent skill from mateaix/mateclaw.

    1.2k GitHub starsUsed in 5 repos~1.7k tokens
    Auto-check passed

Categories

Questions about Ckjia Shopping

What does Ckjia Shopping do?

跨平台比价与购物推荐 / Cross-platform price comparison. An agent skill from mateaix/mateclaw. Ckjia Shopping is an agent skill from mateaix/mateclaw. 跨平台比价与购物推荐 / Cross-platform price comparison.

When should I use Ckjia Shopping?

Ckjia Shopping fits situations like: tasks that involve MCP servers.

How do I install Ckjia Shopping in Claude Code?

Run `npx skills add mateaix/mateclaw --skill ckjia-shopping -a claude-code`. Or copy the skill folder (mateclaw-server/src/main/resources/skills/ckjia-shopping in mateaix/mateclaw) into .claude/skills/ckjia-shopping in your project. Claude Code loads it when a task matches its description.

How do I install Ckjia Shopping in Codex?

Run `npx skills add mateaix/mateclaw --skill ckjia-shopping -a codex`. Or copy the skill folder (mateclaw-server/src/main/resources/skills/ckjia-shopping in mateaix/mateclaw) into .agents/skills/ckjia-shopping in your project. Codex loads it when a task matches its description.

Can I use Ckjia Shopping in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mateaix/mateclaw --skill ckjia-shopping -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ckjia-shopping, .gemini/skills/ckjia-shopping, .github/skills/ckjia-shopping and .opencode/skills/ckjia-shopping in your project.

What does Ckjia Shopping need to run?

Going by SKILL.md and its folder, Ckjia Shopping needs credentials named CKJIA_MCP_KEY. Our summary lists: A credential in CKJIA_MCP_KEY. Its frontmatter pre-approves these tools: ckjia_shopping_recommend, ckjia_image_recognize, ckjia_ping.

Does Ckjia Shopping access the network?

SKILL.md names 3 domains. In commands or code: ckjia.com, union-click.jd.com and img14.360buyimg.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Ckjia Shopping safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ckjia Shopping use?

Ckjia Shopping is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ckjia Shopping use?

About 958 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ckjia Shopping?

Skills that share tags, products or a category with Ckjia Shopping: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and Crush Configuration (charmbracelet/crush, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ckjia Shopping?

mateaix (a GitHub user) maintains it in mateaix/mateclaw, which has 1,152 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 9, 2026.

Source: mateaix/mateclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.