Cn Commerce MCP server
Read-only merchant data from 8 Chinese e-commerce platforms: orders, products, after-sales, ads
66 stars
Reviews
Write oneNobody has reviewed Cn Commerce yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Cn Commerce tools (53, 5 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
export_dataExport a JSON array of records to a CSV or JSON string.
get_account_balanceGet the account balance for an advertiser.
get_ad_detail广告创意详情 (Ad creative detail).
get_ad_detail_reportGet ad-level detail report with per-ad performance metrics (impressions, clicks, cost, conversions).
get_advertiser_infoGet basic advertiser account information including name, balance, and status.
get_after_sale_detailGet full details of a single after-sale (return/refund/exchange) record.
get_after_sale_listQuery after-sale (return/refund/exchange) list by time range and optional status.
get_alertsEvaluate alert rules against current metrics; return firing alerts.
get_audience_report人群分析报表 (Audience analysis report).
get_bid_suggestion出价建议 (Bid suggestion).
get_bill_list账单/资金流水 — 获取抖店资金流水列表。
get_campaign_detail广告计划详情 (Campaign detail).
get_campaign_reportGet campaign-level advertising report with impressions, clicks, cost, conversions, CTR, CPC, etc.
get_creative_report素材/创意报表 (Creative/materials report).
get_diagnosis广告诊断 (Ad diagnosis).
get_feige_messages飞鸽客服消息列表 — 获取与指定用户的飞鸽客服聊天记录。
get_increment_ordersQuery incrementally modified orders by time range.
get_inventoryQuery current inventory/stock levels for given ware IDs.
get_live_data直播间数据 — 获取抖店单个直播间数据(观看/互动/成交)。
get_logistics_tracking物流轨迹追踪 — 查询订单的物流配送状态和轨迹。
get_metricsReturn request metrics (per-endpoint latency, success/error counts).
get_order_detailwrite action获取抖店单个订单详情。
get_order_listwrite action获取抖店订单列表。
get_price_infoGet real-time price information for given SKUs, including promotion overlay.
get_product_detailGet full details of a single product by item ID.
get_product_list获取抖店商品列表。
get_qianchuan_campaign_list千川广告计划列表 (Qianchuan campaign list).
get_qianchuan_report千川电商广告报表 (Qianchuan ecommerce ad report).
get_refund_detailwrite actionGet full details of a single refund record.
get_refund_listwrite action获取抖店售后/退款单列表。
get_review_detail评价详情 — 获取抖店单个评价的详细信息。
get_review_list评价列表 — 获取抖店商品评价列表。
get_seller_infoGet authenticated seller (user) information including seller credit and profile.
get_shop_info获取抖店基本信息。
get_shop_score店铺评分详情 — 获取抖店DSR评分、商品体验、服务体验、物流体验等详细评分。
get_short_video_data短视频数据 — 获取抖店短视频的流量和转化数据。
get_star_report星图达人投放报表 (Star influencer marketing report).
get_supply_order_listwrite actionQuery supply chain order (供货订单) list, unique to WeChat Store.
get_tracesReturn a summary of recent request traces (spans, durations, status).
get_traffic_data流量来源分析 — 获取抖店流量来源数据。
list_ads广告创意列表 (Ad creative list).
list_audience_packagesDMP 人群包列表 (DMP audience package list).
list_brands品牌列表 — 获取抖店已入驻的品牌列表。
list_campaignsList campaigns under an advertiser account with optional status filtering.
list_categories商品类目列表 — 获取抖店商品类目树。
list_coupons优惠券列表 — 获取抖店优惠券列表。
list_live_rooms直播间列表 — 获取抖店直播场次列表。
list_logistics_companies物流公司列表 — 获取抖店支持的物流/快递公司列表。
list_materials素材库列表 (Material library list).
list_promotions营销活动列表 — 获取抖店促销活动列表。
list_star_tasks星图任务列表 (Star task list).
search_affiliate_goodsSearch affiliate (多多客) goods by keyword.
search_productsSearch products by keyword.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan24 source files scanned20/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 5 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (1)
- mediumsubprocess with shell=True
exec.shell-truemcp_cn_commerce-0.1.5/pyproject.toml: …not used "B602", # subprocess with shell=True — not used "B603", # subprocess wi…
What the publisher says
From the Cn Commerce repository's README, as published. We do not edit it. Read it on GitHub
mcp-cn-commerce — 中国电商平台 MCP Server
🛒 让 AI Agent 直接读取中国电商平台的商家经营数据。 不做内容发布,只做经营数据的 MCP 连接器。
面向中国电商商家经营场景的开源 MCP Server 套件。通过支持 stdio MCP 的客户端接入。
搜索关键词: MCP Server, Model Context Protocol, 电商 MCP, AI Agent, 电商数据, 抖店 MCP, 京东 MCP, 巨量引擎 MCP, 淘宝 MCP, 拼多多 MCP, Python MCP, MCP 中国电商, 商家经营数据, 电商经营分析, AI 电商, Claude MCP
English | 简体中文
2026-09-11 状态:修复代码和文档已合入公开 main。Core 0.1.6 工程候选的源码与 main CI 已通过;PyPI / 公开稳定 Release 仍是 0.1.5,普通 pip install 不会取得本轮全部修复。体验新候选请使用下方固定提交安装。真实店铺验收尚未执行。
项目与咨询进展 · 工程/发布证据 · 更新记录
目录
- 这是什么?
- 为什么选择这个项目?
- 平台覆盖
- 快速开始
- 工具参考
- 架构
- 安全
- 使用示例 — 使用示例和场景
- 常见问题
- 参与贡献
- 路线图
这是什么?
一个 MCP (Model Context Protocol) Server 套件(Monorepo),让 AI Agent 能够结构化地访问中国电商平台的商家经营数据。每个平台是一个独立的 MCP Server,按需安装使用:
- 抖店、淘宝 — 已核订单与售后只读合同,优先进行真店样本核对。
- 京东 — 已核订单、店铺和两项售后专项查询;完整退款采集仍有缺口。
- 快手、小红书、微信小店 — 已核部分订单/售后读操作;主体绑定、采集范围及真实授权分别验收。
- 巨量引擎 / 巨量千川 — 当前 SDK 已核广告主信息和账户余额;广告报表及授权账户树仍待补齐。
- 拼多多 — 已保留平台入口,经营 SDK 查询因完整官方业务 schema 未取得而关闭;其他历史 MCP 入口不属已核支持。
这是 8 个 MCP 平台入口、155 个已注册工具的目录,包含历史兼容及明确不支持的入口。注册数量不代表已核合同或真店可用数量;当前 SDK 范围见逐操作能力表,有赞另提供 SDK-only 接入。
所有工具默认只读 — AI Agent 可以分析你的经营数据,但无法修改任何内容。
为什么选择这个项目?
本项目聚焦商家已授权的经营数据,提供平台适配、只读查询和确定性日报汇总。
- 各平台独立 stdio 服务,按店铺已有授权配置。
- 共享连接池、限流、重试、指标与脱敏。
- 统一金额与时间处理;日报明确标记缺失数据和不完整分页。
平台开放 API、平台官方 MCP 与本项目的第三方 MCP 适配器是不同层次;详见官方接入核查。
当前可安排验证的场景:
- 在应用确有权限时读取已核订单/售后接口,并与店铺后台样本核对。
- 对已完成分页和归一化的记录生成确定性日报,明确金额未知与覆盖限制。
- 先用模拟模板确认分析形式,再按操作合同安排真实只读验收。广告 ROAS、库存和评价等模板不证明对应数据源已经可用。
平台覆盖
本表是 SDK 摘要,不将历史 MCP 商品、库存、物流等入口全部标为当前已核合同。工具注册、合同已读、SDK 可调用、真实店铺通过分别记录;所有 SDK live_verified 仍为 false。当前证据见平台说明、官方接入核查与候选验收状态。CI 配置覆盖 Python 3.11/3.12/3.13,实际结果绑定具体提交。
快速开始
安装
体验已验证的 0.1.6 候选源码
使用 Python 3.11+;以下以已有 Python 3.12 为例,在项目虚拟环境安装。固定提交 c32e0049b55ed4e600aecd0a862d46ab9ba7ac9e 已经完成工程验收,不代表商家 API live 通过:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
claude mcp add mcp-cn-commerce -- uvx mcp-cn-commerce
Cn Commerce: common questions
- Is Cn Commerce MCP server safe?
- Mostly: it is graded B (75/100). Read the Cn Commerce safety report
- How do I install Cn Commerce?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does Cn Commerce need an API key?
- Yes. The registry entry asks for
OCEANENGINE_APP_KEY,OCEANENGINE_APP_SECRET,OCEANENGINE_ACCESS_TOKEN,DOUDIAN_APP_KEYand 5 more. - Is Cn Commerce maintained?
- The last commit was 5 days ago (2026-09-21). The latest release is v0.1.5.
- What can I use instead of Cn Commerce?
- Servers from other publishers that do the same job: A1 Yandex KIT MCP server, Shopware MCP server and WebCake Storefront MCP server. Compare all Cn Commerce alternatives.
Alternatives to Cn Commerce
Same job from other publishers: the closest match first, then the best rated.
- A1 Yandex KIT MCPA1 Yandex KIT MCP server for the Yandex KIT e-commerce API: products, orders, discounts, webhooks.not reviewedGrowingB
- ShopwareQuery and safely manage a Shopware 6 shop: products, orders, customers, stock, audits, reports.not reviewedEstablishedB
- WebCake StorefrontBuild pages and manage products, orders, and content on the WebCake/StoreCake storefront builder.not reviewedGrowingA
InstantClipsCreate branded vertical video ads from ecommerce product URLs or product photos.not reviewedGrowingA
Ergora Specialists17 business specialists — sales, marketing, ads, ecommerce, finance, HR, legal, PR… Cited insights.not reviewedGrowingA