shopping-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PDD_PID | No | 多多进宝推广位 PID（在 https://jinbao.pinduoduo.com/ 推广管理中创建推广位后获得）。 | |
| JD_APP_KEY | No | 京东开放平台应用的 app_key（申请 jd.union.open.* 权限）。未填写时京东降级为 mock 模式。 | |
| JD_SITE_ID | No | 京东联盟推广者网站 ID（SITE_ID），在 https://union.jd.com/ 注册推广者后获得。 | |
| TAOBAO_PID | No | 淘宝推广位 PID，形如 mm_<memberId>_<siteId>_<adzoneId>；site_id 与 adzone_id 由程序自动从 PID 解析。 | |
| JD_APP_SECRET | No | 京东开放平台应用的 app_secret。未填写时京东降级为 mock 模式。 | |
| PDD_CLIENT_ID | No | 拼多多开放平台应用的 client_id（在 https://open.pinduoduo.com/ 注册应用后获得）。未填写时拼多多降级为 mock 模式。 | |
| JD_POSITION_ID | No | 京东联盟推广位 ID（POSITION_ID）。 | |
| TAOBAO_APP_KEY | No | 淘宝开放平台应用的 appkey（申请淘宝客 API 权限）。未填写时淘宝降级为 mock 模式。 | |
| TAOBAO_SESSION | No | 通过 oauth.taobao.com 授权淘宝客后获得的 session（授权 token）。 | |
| PDD_CLIENT_SECRET | No | 拼多多开放平台应用的 client_secret。未填写时拼多多降级为 mock 模式。 | |
| TAOBAO_APP_SECRET | No | 淘宝开放平台应用的 app_secret。未填写时淘宝降级为 mock 模式。 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| shopping_statusA | 查看三个平台（taobao / jd / pdd）的凭证配置状态、当前运行模式与申请指引。 返回每个平台的 mode（live=真实数据 / mock=假数据）、缺失的环境变量名、 以及该平台该去哪里申请、需要什么资质。开始任何调用前先看这个。 |
| search_productsA | 按关键词搜索商品，返回统一字段（价格/券后价/券额/佣金率/销量/店铺/链接）。 Args: platform: taobao / jd / pdd keyword: 搜索关键词，中文即可 page: 页码，从 1 开始 page_size: 每页条数，1-50 has_coupon: 只要带优惠券的商品 sort: default / commission（佣金高）/ sales（销量）/ price_asc / price_desc / coupon_price |
| get_productA | 按商品 id 查详情。 淘宝传 num_iid，京东传 skuId，拼多多传 goods_sign（搜索结果 item.extra.goods_sign 那一长串 token —— 拼多多已停用数字 goods_id）。 Args: platform: taobao / jd / pdd item_id: 淘宝 num_iid / 京东 skuId / 拼多多 goods_sign |
| convert_linkA | 把商品转成自己的推广/返利链接（含优惠券）。 拼多多要传 goods_sign（搜索结果 item.extra.goods_sign），不是数字 goods_id； 拼多多已把 goods_id_list 从转链接口下线（会报 40005）。 Args: platform: taobao / jd / pdd item: 淘宝 num_iid、京东 skuId 或商品 URL、拼多多 goods_sign sub_pid: 可选，子推广位/自定义参数，用于区分流量来源 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: status/config check, keyword search, single-item detail lookup, and affiliate-link conversion. The descriptions explicitly differentiate item_id semantics per platform (num_iid vs skuId vs goods_sign), leaving no room for misselection.
Three tools follow a clean verb_noun pattern (search_products, get_product, convert_link), but shopping_status uses a domain prefix plus noun rather than a verb, a minor deviation. The set is still highly readable and predictable.
Four tools is a tight but sensible scope for an affiliate-shopping workflow (search, detail, link conversion, plus a setup/status helper). It leans slightly thin — a category or batch-conversion tool could earn its place — but nothing is redundant.
The core affiliate lifecycle (discover via search, inspect via get_product, monetize via convert_link, verify setup via status) is fully covered. Minor gaps like batch conversion or order/reporting operations exist but are workable around.