京东选品插件（京东联盟）

演示

一次真实查询（2026 年 10 月）：问“机械键盘 红轴”，插件返回的第一条是一款京东自营的 87 键有线机械键盘，京东价 222 元，券后价 178 元，好评率 99%，附带领券和商品链接。价格会随时变化。

用法和旅行插件一样，在 AI 对话里直接说需求就行。问“300 元以内的红轴机械键盘”，它会列出符合条件的商品，带上京东价、券后价、最划算的那张券、是不是自营、评论数和好评率；问“最近有什么历史低价”，它会去翻热销、好券、历史最低价、9.9 包邮这些精选榜单。看中某一件，可以让它查详细规格，或者把用券后的价格算清楚。商品链接打开后会跳到京东 App，下单还是自己来。

它怎么工作

插件通过京东联盟的开放接口拿数据。京东联盟是京东官方的推广平台，注册后可以申请接口，插件用申请到的 AppKey 和 SecretKey 给每个请求签名。

真正的难题是权限。京东联盟按账号等级开放接口，新账号是最低的 V1 级：精选频道、商品详情、订单查询都能用，偏偏最关键的关键词搜索没有权限。我的办法是让插件每天把 20 个精选频道里的商品全部抓下来，存成一份本地索引，现在大约有 4 万件，主要是热销、有券、历史低价和自营的商品。搜索时就在这份索引里按关键词筛选、按价格过滤、按要求排序，所以几乎是瞬间返回。代价是它不是京东全站搜索，冷门商品可能搜不到，所以插件每次都会写明数据来源，也要求 AI 如实告诉用户“没搜到不代表京东没有”。

这个办法也是改出来的。第一版以关键词搜索为主，等联盟审核通过、拿到 Key 一测，才发现那个接口要更高的等级，只好按 V1 实际能用的接口把工具重写了一遍。后来又从“每次搜索临时拉几个榜单”改成“每天建一次索引”，速度和覆盖面都好了很多。

下载和使用

代码包是 MIT 许可证。京东联盟的 AppKey 和 SecretKey 需要你自己申请，不随包提供。

1. 安装 Python 3.10 或更新版本到 python.org 下载。Windows 安装时勾选“Add python.exe to PATH”。
2. 解压并进入目录把 jd-picker-mcp.zip 解压到不含中文和空格的路径，例如 D:\jd-picker-mcp，打开 PowerShell 进入该目录。
3. 创建虚拟环境并安装依赖依次运行：

   python -m venv .venv
   .venv\Scripts\activate
   pip install -r requirements.txt

   macOS 或 Linux 把第二行换成 source .venv/bin/activate。
4. 注册京东联盟打开 京东联盟，用京东账号登录并完成推广者入驻。不同账号等级的接口权限不同。
5. 创建开放平台应用打开 京东开放平台，在控制台创建应用，拿到 AppKey 和 SecretKey，并按控制台提示申请京东联盟相关接口权限。V1 等级通常没有关键词全站搜索权限。
6. 填写配置把 .env.example 复制为 .env，填写：

   JD_APP_KEY=your-jd-app-key
   JD_APP_SECRET=your-jd-app-secret
   MCP_TRANSPORT=stdio

   Key 只保存在这个文件里，.gitignore 已排除它。
7. 自检运行 python server.py --check。看到“OK：配置已读取”说明两个字段都读到了。自检不联网，不校验接口权限和额度。
8. 接入 Claude Desktop在设置 → 开发者 → 编辑配置里加入：

   {
     "mcpServers": {
       "jd-picker": {
         "command": "D:/jd-picker-mcp/.venv/Scripts/python.exe",
         "args": ["D:/jd-picker-mcp/server.py"]
       }
     }
   }

   路径改成你自己的，保存后完全退出 Claude 再打开。
9. 接入 Claude Code运行：

   claude mcp add jd-picker -- D:/jd-picker-mcp/.venv/Scripts/python.exe D:/jd-picker-mcp/server.py

   再输入 /mcp 检查。
10. 建立商品索引没有关键词搜索权限时，插件会在后台把精选榜单同步到 data/index.json，首次可能较慢并消耗接口额度。之后 24 小时内复用本地索引。索引路径可以用 JD_INDEX 修改。
11. 开始使用对 AI 说：“帮我找 300 元以内的机械键盘”“最近有什么历史低价”“查一下我昨天的推广订单”。my_orders 只查询当前账号自己的推广订单，不能查别人。
12. （可选）部署成 HTTP 服务把 MCP_TRANSPORT 改成 http，设置 MCP_AUTH_TOKEN，参考包里的 deploy/ systemd 和 nginx 示例。客户端需要带 Authorization: Bearer 你的口令。

常见问题

这是个人学习项目，与京东没有任何官方关系。商品、价格、优惠券等数据的版权归京东所有。使用时请遵守京东联盟开放平台的服务条款，Key 只给自己用。