cn-shop-mcp

合规的淘宝 / 京东 / 拼多多商品搜索与跨平台比价 MCP Server（本机 stdio，Python）。

• 合规：只调用三家官方开放平台 API（淘宝联盟 / 京东联盟 / 多多进宝），不做页面抓取、不做 UI 自动化。
• 能力：搜索、比价、转链（淘口令 / 拼多多短链 / 京东短链）、"好价合集"群发文案；下单/付款仍在各平台 App 完成。
• 工具：共 11 个，见下方工具一览。

安装

方式一：uvx（推荐，无需克隆代码）

uvx cn-shop-mcp

MCP 客户端里配置（以 opencode 为例，完整示例见客户端配置）：

"cn-shop-mcp": {
  "type": "local",
  "command": ["uvx", "cn-shop-mcp"],
  "environment": { "CN_SHOP_MCP_ENV_FILE": "D:/path/to/你的/.env" }
}

.env 查找顺序：① 环境变量 CN_SHOP_MCP_ENV_FILE 指定路径 → ② 当前工作目录（含上级）→ ③ 包目录相对（源码运行时自动生效）。

方式二：源码运行（开发用）

uv sync
copy .env.example .env    # Windows（macOS/Linux: cp .env.example .env）
# 编辑 .env，按下方指南填入三家凭证

验证：uv run python scripts/live_smoke.py 电脑桌（未配置任何平台时退出码为 2 并提示缺失项）。

凭证配置表

任一家未配置：该平台工具返回 degraded: not_configured 与修复提示，其余平台不受影响。

三家账号注册与开通

淘宝联盟

1. 打开 https://pub.alimama.com（用淘宝账号登录），完成实名认证与媒体备案；
2. 创建推广位，得到推广位 ID（adzone_id）；
3. 打开 https://open.taobao.com 创建应用，申请"淘宝客【推广者】"权限（物料搜索接口 taobao.tbk.dg.material.optional），获得 AppKey / AppSecret；
4. 填入 .env：TB_APP_KEY / TB_APP_SECRET / TB_ADZONE_ID。

京东联盟

1. 打开 https://union.jd.com（用京东账号登录），完成实名认证；
2. 在 https://jos.jd.com（宙斯开发者中心）/ 联盟开放平台创建应用，获得 AppKey / AppSecret；
3. 关键词搜索接口（jd.union.open.goods.query）可能需要为应用申请权限；未获批前： 在 .env 设 JD_SEARCH_MODE=jingfen（现为默认），用"京粉精选"频道先跑通（无关键词，返回频道精选商品）；
4. 填入 .env：JD_APP_KEY / JD_APP_SECRET。

多多进宝（拼多多）

1. 打开 https://jinbao.pinduoduo.com，手机号注册并实名；
2. 创建推广位，得到 PID；
3. 到 https://open.pinduoduo.com 创建（多多客角色）应用，获得 client_id / client_secret；
4. 按官方指引用 pid + custom_parameters 完成搜索接口备案（未备案会报 60001）；
5. 填入 .env：PDD_CLIENT_ID / PDD_CLIENT_SECRET / PDD_PID。

客户端配置

opencode

写入 ~/.config/opencode/opencode.json（或项目根 opencode.json）：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cn-shop-mcp": {
      "type": "local",
      "command": ["uvx", "cn-shop-mcp"],
      "environment": { "CN_SHOP_MCP_ENV_FILE": "D:/work/cn-shop-mcp/.env" },
      "enabled": true
    }
  }
}

源码方式运行的话，command 换成 ["uv", "--directory", "你的仓库路径", "run", "cn-shop-mcp"] 即可。

验证：opencode mcp list 应出现 cn-shop-mcp。

Claude Desktop / Cherry Studio（mcpServers 形状）

{
  "mcpServers": {
    "cn-shop-mcp": {
      "command": "uvx",
      "args": ["cn-shop-mcp"],
      "env": { "CN_SHOP_MCP_ENV_FILE": "D:/path/to/你的/.env" }
    }
  }
}

工具一览

sort：relevance（默认）/ sales_desc / price_asc / price_desc / commission_desc。 价格筛选（price_min / price_max）按券后价（有券可用时）判断；coupon_only 仅保留有券商品。京东/拼多多为页内本地筛选。 示例对话："帮我搜一下 80cm 宽的电脑桌，对比淘宝京东拼多多的价格。"

排障

局限（如实说明）

• 跨平台没有互通商品 ID：compare_prices 的同款分组是启发式线索（给出高/中/低置信度），不保证同款，请以人工确认为准。
• 搜索范围为联盟物料库：未参加联盟推广计划的商品不会出现在结果里。
• 拼多多进宝库不覆盖 3C 大件/核心配件（实测返回 0 条、非报错）：手机、平板、固态硬盘、内存条、显卡、CPU、主板、显示器、键鼠、机箱、整机 等；周边配件正常（移动硬盘/U盘/路由器/耳机/充电宝/散热器/数据线等）。此类商品请用淘宝搜索或各平台网页/APP 查价。
• 京东 jingfen 模式不支持关键词（返回频道精选），且会标注 degraded 提示。
• 只读：下单/付款请到各平台 App 完成。

开发

uv run pytest                      # 全量离线测试
uv run python scripts/live_smoke.py 关键词   # 手动冒烟（需真实凭证）