Skip to main content
Glama

PDD-MMS-MCP

拼多多商家后台(mms.pinduoduo.com)自动化工具集,以 MCP server 形式提供:

  • 经营数据查询:经营总览、商品数据、单品分析、商品领航员、推广数据

  • 评价管理:评价列表查询(可筛 1-3 星待举报)

  • 客服聊天:按客服/订单/商品查询聊天记录

  • 买家端商品详情与素材:商品主图/详情图/SKU、商品评价、评价晒图/精选晒图、评价 SKU/评分/图片原始元数据

任何支持 MCP 的客户端(ZCode、Claude Desktop 等)都能调用纯数据接口;带文件产出的操作由 scripts/ 下的独立脚本完成。

公开仓库边界

本仓库只保留通用 MCP 能力层与通用测试。以下内容不应提交:店铺登录配置(config/shops.json)、本地导出/抓包/调试工件、包含真实业务数据的 JSON/NDJSON/XLSX,以及带店铺身份、外部系统标识或固定业务话术的编排脚本。发布前应执行全历史敏感信息扫描。

Related MCP server: Dianping MCP Server

工作原理

MCP 客户端 → 本 server(stdio)→ CDP(127.0.0.1:9222) 接管已登录的 Chrome
  → 在 mms.pinduoduo.com 页面主世界调用 window.__mms.fetch(拼多多后台自带的请求封装)
  → anti-content 风控签名由拼多多页面代码自己生成,本地不做任何签名/请求头伪造

商品详情/素材工具使用已登录买家端商品页(mobile.yangkeduo.com)的页面上下文和登录态:商品详情读取页面 React/rawData,评价实际复用页面发起的 /proxy/api/reviews/{goods_id}/list。不要把移动端评价接口改成商家后台 __mms.fetch,也不要在 MCP 中伪造 anti-content。

环境要求

  • Node.js ≥ 18

  • Chrome 136+(高版本禁止在默认用户目录开调试端口,本项目使用专用 profile 规避)

  • Windows(启动脚本为 bat/cmd;核心代码不依赖平台)

快速开始

ℹ️ config/shops.json 含店铺登录明文账密,不入库(已 gitignore,且已从全部历史清除)。克隆后复制 config/shops.example.json 为 config/shops.json,再填入真实账密。

npm install
  1. 启动调试 Chrome:双击 scripts\start-chrome-debug.bat(或在 ZCode 对话里让 skill 自动完成)

    • 专用 profile(%LOCALAPPDATA%\pdd-mcp\chrome-profile),与日常 Chrome 隔离

    • 首次在打开的窗口里登录商家后台(支持账密自动登录 scripts/auto-login.js),之后保持登录

  2. 配置店铺:复制 config/shops.example.json 为 config/shops.json,填入各店铺的调试端口与登录账密

  3. 注册 MCP(以 ZCode 用户级配置 ~/.zcode/cli/config.json 为例):

    { "mcp": { "servers": { "pdd-mms-mcp": {
        "command": "node",
        "args": ["<本项目路径>/src/index.js"]
    } } } }
  4. 对话里说"检查拼多多环境"(pdd_status)确认就绪。

MCP 工具清单(纯数据接口,返回 JSON,不产出文件)

工具

数据

pdd_status

检查 CDP 连接/登录态/请求通道,排障第一步

pdd_reviews_list

评价列表(跨页拉取,可只看待举报、关键词过滤、导出 CSV)

pdd_overview_data

经营总览(成交/转化/退款环比、店铺评分五维、GMV 进度、客服质量;前一日)

pdd_goods_data

商品数据(昨日全天 + 今日实时 + 活动推荐)+ 推广汇总

pdd_goods_detail

单品深度分析(分时销量趋势/售后质量/领航员得分/体检/评价概况)

pdd_goods_navigator

商品领航员列表(综合得分百分位/描述分/质量退款率/拼差率)

pdd_promotion_data

推广数据(单元花费/ROI/GMV/订单/日限额,默认昨日)

pdd_promotion_operations

单推广链接操作记录(只读、按广告与日期范围)

pdd_promotion_creative_daily

单链接创意图片日报(只读,不请求小时数据)

pdd_promotion_export

原生推广报表导出与解析(只读)

pdd_promotion_list

全量商品推广列表(只读、店铺身份绑定)

pdd_promotion_detail

单链接推广日报、分时与创意日报(只读)

pdd_chat_users

客服账号列表(mmsId,配合 pdd_chat_data)

pdd_chat_data

聊天记录查询(按客服 ≤31 天 / 按订单 / 按商品 ≤7 天,纯 JSON)

pdd_capture_reviews_template

抓取评价接口请求体模板(排障用)

pdd_goods_upload_images

按调用方顺序上传商品图片

pdd_goods_capture_template

捕获商品编辑提交模板(只读)

pdd_goods_property_template

读取商品属性模板与平台选项(只读)

pdd_goods_commit

保存草稿或提交商品;submit 为真实上架操作

pdd_pdd_mobile_goods

买家端商品详情与素材元数据

pdd_pdd_mobile_reviews

买家端评价分页与买家秀

pdd_pdd_selected_prints

买家端图/视频评价筛选

pdd_pdd_expert_notes

行家心得探测;无可验证 endpoint 时返回明确空结果

pdd_pdd_mobile_bundle

一次性汇总买家端商品、评价和素材

业务编排边界

日报、聊天导出、评价举报、外部报表回填等带店铺身份或业务口径的流程不属于本公开能力层,保留在本地 skill 或部署目录中。公开仓库只保留通用 MCP 工具、平台接口适配和不含真实数据的测试。

安全设计

  • 逐条间隔 1 秒(可调但不建议低于 500ms)、单条失败默认停止——不做并发轰炸

  • 审计日志:每次真实举报提交追加记录到 logs/pdd_audit.jsonl

  • reviewId 用字符串传:19 位 ID 超出 JS 安全整数,转数字会丢精度导致举报错对象

  • 所有请求带自己的商家登录态,只能操作本店数据

  • output/(导出的聊天/评价数据)与 logs/ 一律不入库

风险提示(务必阅读)

自动化操作拼多多后台属于平台规则灰色地带,风控/处罚风险由账号自担 调试 Chrome 的 9222 端口对本机所有程序开放(能完全控制该浏览器),不要在不可信环境跑,不用时关掉该 Chrome 窗口

目录结构

src/               MCP server 代码
  index.js           工具注册与入口(stdio)
  cdp.js / bridge.js CDP 连接与页面内请求调用桥
  config.js / shops.js  配置与多店铺管理
  overview.js / goods.js / promotion.js / reports.js  经营/商品/推广/报表接口
  promotion-*.js     只读推广列表、详情、操作记录与原生报表适配
  goods-create.js    商品图片、属性、草稿/提交能力
  pdd-mobile-*.js    买家端商品与评价读取能力
  reviews.js / chat.js   评价与聊天接口
  font-decrypt.js    商品字体反爬解密
  excel.js / audit.js    Excel 产出与审计日志
scripts/           通用启动、测试与接口验证脚本
config/            shops.example.json(占位模板);shops.json 存真实账密,不入库
test/              不依赖真实店铺数据的单元测试
docs/api-notes.md  拼多多后台接口笔记(不含店铺数据)
output/  logs/     运行时产物,不入库

排障

  • 所有工具报"无法连接 Chrome 调试端口" → 配置本地调试 Chrome 后重试

  • 登录态过期 → 在调试 Chrome 窗口里重新登录

  • 评价列表报错/筛选条件变了 → pdd_reviews_list 传 refreshTemplate:true

  • 运行测试:npm test

Available Tools

15 tools
pdd_capture_reviews_template抓取评价接口模板A

调试用:驱动浏览器依次打开评价管理候选页,抓取页面自身 /saturn/reviews/list 请求体并保存为模板(pdd_reviews_list 首次会自动做,一般无需手动调)。

Inputs: shop.

pdd_chat_data聊天数据查询A

按客服账号/订单号/商品ID 查询聊天记录(纯数据 JSON;时间跨度限制与后台一致:按客服/订单 ≤31 天、按商品 ≤7 天)。如需导出 Excel 文件,用 pdd-chat-export skill。

Inputs: mode (required), endDate (required), startDate (required), shop, +6 more.

pdd_chat_users客服账号列表A

列出店铺的客服账号(mmsId + 名称),配合 pdd_chat_export 的 mmsId 参数使用。

Inputs: shop.

pdd_goods_data商品数据A

拉取商品维度数据(纯 JSON):全部商品列表,每商品含昨日全天指标、今日实时指标、活动推荐;附带推广数据(昨日,单元花费/ROI/商品ID)与店铺级今日实时。withYesterdayFullDay=true 时逐商品拉取更精确的昨日数据(较慢)。如需 Excel 报表,用 pdd-daily-report skill。

Inputs: shop, withYesterdayFullDay.

pdd_goods_detail单品销量分析A

单品深度分析(全部明文接口):今日/昨日完整指标+分时销量趋势、售后质量(平台介入/质量退款)、商品领航员得分、商品体检分、评价概况。goodsId 从 pdd_goods_data 的结果里拿。

Inputs: goodsId (required), shop.

pdd_goods_navigator商品领航员A

全店商品领航员列表:每商品的综合得分百分位/层级、描述平均分、质量退款率、拼差率、中差评率、库存、在售状态。用于找出拖后腿的商品。

Inputs: shop, pageNo, pageSize, goodsName.

pdd_overview_data经营总览数据A

拉取经营总览数据(纯 JSON,数据为最近已就绪日即前一日):成交金额/订单/转化率/退款等核心指标+环比、店铺评分与五维能力、GMV升级进度、客服质量。如需 Excel 报表,用 pdd-daily-report skill。

Inputs: shop.

pdd_promotion_creative_daily单链接创意图片日报(不请求小时)A
Read-only

从当前推广列表核验店铺/广告/商品,仅读取该ad创意日报;保留null抑制指标,无创意小时或单品小时请求。

Inputs: adId (required), expectedMallId (required), date, shop, +1 more.

pdd_promotion_data推广数据A

拉取营销中心推广数据(默认昨日):全部推广单元(花费/ROI/GMV/订单/目标投产比/日限额/商品ID/分组/托管状态)+ 账户汇总 + 近几日每日花费。均为明文。会临时打开营销中心页采集,耗时约30秒。

Inputs: date, shop.

pdd_promotion_detail单品推广日报、分时及创意图日报(只读)A
Read-only

按adId读取单个稳定成本推广的昨日/指定日数据:dailyReport、24小时原始指标、创意图片及日指标。强制expectedMallId核验店铺;创意小时明确unsupported,平台抑制的null指标不是零。仅已验证scenesMode=1。

Inputs: adId (required), expectedMallId (required), date, shop, +1 more.

pdd_promotion_export原生商品推广报表下载(不改投放)A
Read-only

生成只读报表任务并下载原始XLS/XLSX、解析JSON及身份/日期/覆盖/总计manifest;不改预算出价。shop-hourly全店单日小时通常数秒至数分钟,默认最多60轮每轮间隔2秒另加网络下载时间;超时从同一taskId/输出目录恢复,不反复生成。unit-hourly单商品单日、unit-daily单商品日期区间直接下载。全店文件只含有数据商品,缺行不补零;创意不在此报表。依赖python openpyxl/xlrd。

Inputs: expectedMallId (required), adId, date, mode, +6 more.

pdd_promotion_list全量商品推广昨日列表(只读、身份绑定)A
Read-only

按明确CDP端点读取商品推广scenesMode=1全量列表及汇总,分页去重与店铺身份核验;配合pdd_promotion_detail逐单元读取小时和创意昨日数据。

Inputs: expectedMallId (required), date, shop, cdpUrl.

pdd_promotion_operations单推广链接操作记录(只读)A
Read-only

真实商品推广抽屉操作记录接口;参数化日期范围,核验店铺/广告/商品,逐页校验total,按事件ID去重;保留秒级操作时间及原始变更文案,操作人匿名化,类型未返回时为null;早于平台窗口明确报错。不请求小时、不改投放。

Inputs: adId (required), endDate (required), startDate (required), expectedMallId (required), +2 more.

pdd_reviews_list拉取店铺评价A

跨页拉取 mms 后台评价列表(自动复用页面自身请求体模板)。可只看待举报、关键词过滤、导出 CSV。

Inputs: shop, pages, outCsv, keyword, +3 more.

pdd_status拼多多环境检查A

检查 Chrome 调试端口连接、mms.pinduoduo.com 标签页、登录态与页面内请求通道是否可用。其他工具报错时先调这个。

Inputs: shop.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 15 tools

    Disambiguation3/5

    Most tools target distinct resources, but the promotion cluster has several overlapping surfaces (e.g. pdd_promotion_list vs pdd_promotion_data both pull all units/summaries, and pdd_promotion_detail vs pdd_promotion_creative_daily both include creative daily metrics). Long descriptions help, but an agent can easily misselect among these.

    Naming Consistency4/5

    All names are lowercase snake_case with a pdd_ prefix and a predictable domain prefix, but the suffix style is mixed: status, list, data, detail, export, capture_reviews_template. This is mostly consistent and readable, with minor ordering deviations such as pdd_capture_reviews_template versus pdd_reviews_list.

    Tool Count4/5

    15 tools is at the upper edge of the typical range and covers multiple domains, so the count is reasonable. However, the promotion sub-domain uses six tools and there is a debug-only template capture tool, making the surface slightly heavier than necessary.

    Completeness4/5

    The read-only analytics scope is well covered: status, reviews, chat, overview, goods, and promotion all have query/export paths. Minor gaps exist (e.g. no direct chat export tool and no review detail/reply action), but these are either outside the read-only intent or covered by external skills.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    • Kalodata MCP server for ChatGPT, Claude and any AI agent: search categories, list top products, get product details, list top shops, get shop details, list top creators, list top videos and follow shop in your own Kalodata account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Kalodata yourself; Cotlet does not store your password and you need no Kalodata API key. About the official Kalodata API: Yes, Kalodata has an Open API with ranking and detail endpoints for Category, Shop, Creator, Product, Video and Livestream data, billed per credit (checked 5 Nov 2026). It has no official MCP server yet: Kalodata lists MCP as coming soon. Setup and FAQ: https://cotlet.dev/integrations/kalodata-api-mcp-server

    • Judge.me MCP server for ChatGPT, Claude and any AI agent: list reviews, reply to review, send private reply, hide review, publish review, send review request and export reviews in your own Judge.me account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Judge.me yourself; Cotlet does not store your password and you need no Judge.me API key. About the official Judge.me API: Judge.me has a REST API with a private API token and an OpenAPI file, but no official MCP server (checked 23 Oct 2026). The API lists, creates, publishes and hides reviews and sends public and private replies. Setup and FAQ: https://cotlet.dev/integrations/judge-me-api-mcp-server

    • Okendo MCP server for ChatGPT, Claude and any AI agent: list pending reviews, publish review, reject review, reply to review, answer product question and get product performance in your own Okendo account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Okendo yourself; Cotlet does not store your password and you need no Okendo API key. About the official Okendo API: Okendo has an official API, but with limits (checked 23 Oct 2026). The Merchant REST API reads and updates reviews, replies, loyalty customers and webhooks, and Okendo's spec calls it available to enterprise customers. Setup and FAQ: https://cotlet.dev/integrations/okendo-api-mcp-server

      https://cotlet.dev/mcp/v1/okendo
    • Privy MCP server for ChatGPT, Claude and any AI agent: list campaigns, create segment, duplicate campaign, create email campaign, send or schedule campaign, pause display, launch display and tag contacts in your own Privy account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Privy yourself; Cotlet does not store your password and you need no Privy API key. About the official Privy API: Privy has a public API on paid plans and a read-only MCP server (checked 23 Oct 2026). The API reads contacts, campaigns, flows, displays, segments, coupons, orders and reports, and writes contacts, order events and custom events. Setup and FAQ: https://cotlet.dev/integrations/privy-api-mcp-server

      https://cotlet.dev/mcp/v1/privy

    Related MCP Servers