taobao-seller-mcp
Provides read-only access to Taobao/Tmall seller back-office data by calling internal APIs of Shengyi Canmou (生意参谋) and Qianniu (千牛) pages opened in a logged-in store browser. Includes store overview and trends, realtime daily stats, traffic sources, product rankings and per-product analysis, search keywords driving traffic, promotion spend/ROI, market (free tier) category overview, category rankings, hot/rising search terms, competitor store monitoring, plus Qianniu order lists (status/tag filtering, pagination, item and payment details) and product listings (on sale/in warehouse, price, stock, 30-day sales, quality score). Supports multiple stores with a shop selector and auto-detects Tmall vs Taobao.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
taobao-seller-mcp
淘宝 / 天猫卖家 MCP 服务器:生意参谋的经营概况、每日走势、今日实时、流量来源、商品排行、单品分析、引流搜索词、推广花费;生意参谋「市场」免费版(普惠版)的类目大盘、类目排行(交易 / 增速 / 流量 / 加购收藏 / 新品)、价格带和各价格带热销商品的件单价、属性分析、热搜 / 飙升词;竞店监控、竞店对比、竞品流失;以及千牛的订单和商品。
所有数据都从本机紫鸟(Ziniao)店铺浏览器里已登录的页面取:在生意参谋和千牛标签页里调后台自己的接口,不走淘宝开放平台,不需要 AppKey,也不需要额外授权。请求走那家店的紫鸟代理 IP。
只读:不改价、不改商品、不发货、不联系买家。
天猫、淘宝都支持(自动识别);多店铺:一个配置连多家店,工具里用
shop选店。不打扰干活:紫鸟窗口最小化时照常工作——页面里用原生 fetch 发请求、mtop 签名在 Node 侧完成,不依赖会被 Chrome 限流的页面定时器;需要新开标签页时会自动再最小化回去,工作标签页开好后一直复用。工作标签页有自己的标记,不会接管你自己打开的生意参谋 / 千牛页面;被带到别的页面时会自己跳回去。
不输出买家信息:订单接口本身隐藏买家昵称,结果里也不带收货信息;去掉了卖家 ID(含加密 ID)和链接跟踪参数。
遇到安全验证就停:识别出淘宝安全验证(滑块 / 验证码 / RGV587)后不重试、不换接口再试,并且这家店 10 分钟内不再发请求(记在数据目录的
cooldown.json,用同一个数据目录的其他 MCP 进程也会停;删掉它可立即恢复);一次工具调用里的多个请求一个接一个发,前一个被拦就不发后面的;单次请求超时会取消浏览器里还没结束的请求。零依赖,Node.js ≥ 22。
前提
本机装了紫鸟客户端和
ziniao-cli(ziniao-cli store list能列出店铺)。用客户端自带的 Node 启动 MCP 时(如 Accio),会自动去 nvm / Homebrew / npm 全局目录找ziniao-cli,找不到可用ZINIAO_CLI指定。店铺浏览器里登录了这家店的千牛(myseller.taobao.com),生意参谋能正常打开。
店铺浏览器没开时工具会通过
ziniao-cli自动打开(会弹出一次窗口)。每家店会用两个标签页:生意参谋、千牛(订单接口只允许千牛页面跨域调用)。
Related MCP server: PDD-MMS-MCP
配置
{
"mcpServers": {
"taobao-seller": {
"command": "npx",
"args": ["-y", "taobao-seller-mcp@latest"],
"env": {
"TB_SHOPS": "[{\"name\":\"天猫店\",\"store_id\":\"12345678901234\",\"default\":true},{\"name\":\"淘宝店\",\"store_id\":\"23456789012345\"}]"
}
}
}
}环境变量 | 说明 |
| 店铺数组(JSON)。 |
| 只有一家店时可以只设紫鸟店铺 ID,代替 |
| 数据目录(冷却记录),默认 |
|
|
配置写错时服务器照常启动,调用任何工具都会返回具体哪里错了。
工具
工具 | 内容 |
| 已配置的店铺 |
| 支付金额、支付买家数、支付转化率、客单价、访客数、浏览量、UV 价值、新老访客、跳失率、加购 / 收藏人数、新老支付买家;下单金额 / 买家 / 转化;推广总花费、点击、ROI。单日 / 近 7 天 / 近 30 天,带较上期变化。单日另给支付件数、净支付、退款(金额 / 退款率)、老客复购、咨询率、物流时效,以及同行同层平均 / 优秀 |
| 近 30 天每日:支付金额、买家、转化、客单价、访客、浏览、件数、加购、净支付、退款、老买家支付,附合计;可选同行平均 / 优秀线 |
| 今天到目前为止的实时数据,带较昨天同时段变化 |
| 全店无线端各来源(推荐、手淘搜索、直通车 / 全站推广、站外…)的访客、加购、支付买家、转化;传 |
| 商品排行:按支付金额 / 访客 / 件数 / 转化率 / 加购 / 收藏排序;支付、访客、搜索引导访客和转化、加购、收藏、下单、退款、客单价、跳出率、停留时长、环比 |
| 单品(商品 360):核心指标(含推广消耗、直接 ROI、询单 / 静默转化率)、每日走势、各 SKU 成交、流量来源树 |
| 引流搜索词:买家搜哪些词进店,每个词的访客、加购、收藏、支付买家、金额、转化率 |
| 市场:这家店在「市场」里能看的类目(ID、路径、是否叶子) |
| 市场:类目大盘(支付买家数、支付金额占比、增幅、供需比)和价格段 |
| 市场:类目商品 / 店铺排行(排名变化、是否天猫、支付买家、访客、核心词、是否本店);榜单可选交易总量、交易增速、流量总量(多给搜索访客)、加购收藏(多给加购 / 收藏人数)、新品流量(店铺只有交易总量 / 增速);可按价格段筛选 |
| 市场:类目价格带(支付买家数和生意参谋的建议);指定价格带时给这个价格带里卖得最好的商品:支付单量、件单价(成交均价)、支付金额 |
| 市场:类目属性分析——可分析的属性;1~2 个属性的取值(组合)的支付买家数、支付金额占比和增速、动销商品增速;某个取值下的热销商品和件单价 |
| 市场:类目热搜词 / 飙升词(搜索词或核心词),搜索人气、点击率、支付转化率、飙升幅度,可按关键词筛选 |
| 竞店监控:生意参谋里设置的竞店,支付买家、访客和变化、标签(交易大增 / 流量大增)、动态 |
| 竞店对比:本店 vs 1~2 家监控竞店的访客、支付买家、转化率、加购、收藏,某个指标的近 30 天每日走势,竞店热门商品和动态 |
| 竞品流失:本店哪些商品的买家流失到了竞品(流失金额、人数、流失率、收藏 / 加购后流失、流失去了多少竞品 / 竞店),以及最近一天访客流失最多的竞品和竞店 |
| 千牛「已卖出的宝贝」:按标签(近 3 个月、待付款、待发货、即将 / 已经超时、已发货、退款中、成功、关闭、3 个月前)筛选翻页;订单号、下单时间、状态、实付、商品(标题、SKU、商家编码、数量、金额、状态);附待发货 / 超时计数 |
| 千牛「我的宝贝」:出售中 / 仓库中;标题、商家编码、价格、库存、近 30 天销量、类目、上架时间、基础质量分、流量标签 |
口径
生意参谋按北京时间自然日出数,最新通常到昨天;
date不填就用接口给的最新日期。金额人民币。指标中文名取自生意参谋自己的指标字典,和后台一致。
流量来源是按来源去重的访客,同一访客可能来自多个来源,不要相加。
市场数据来自生意参谋「市场」免费版(普惠版):只能看这家店经营的类目,指标是区间(如「7500 ~ 1万」),原样输出。
件单价 = 支付金额 ÷ 支付件数,是成交均价(含优惠、多个 SKU 平均),不是商品标价;价格带热销商品给的是数值,属性热销商品给的是档位(如「30+」)。
tb_market_prices的价格带来自「类目洞察 → 价格分析」,和tb_market_overview的价格段(用于tb_market_rank筛选)分法不同,不能混用。竞店对比只能选生意参谋里已经设置监控的竞店,本店是精确值、竞店是区间。竞品流失里本店商品的流失数据是精确值,流失去向是流失指数(只比较相对大小)。
竞品对比(单个竞品商品)要先在生意参谋里关注竞品,暂未接入。
速度
生意参谋 / 千牛标签页首次打开各约 5–10 秒;之后每次查询 0.1–0.6 秒(订单约 0.3–1 秒)。同一个紫鸟浏览器同一时间只跑一个任务。
短时间内大量查询(比如一小时内上百次)会触发淘宝风控,生意参谋的市场接口会要求滑块验证。日常分析的量没问题,不要拿它做批量抓取。
说明
非官方工具:用的是生意参谋 / 千牛页面自己调用的内部接口,平台改版可能导致失效。请求和你在后台手动查看一样走店铺浏览器,但请控制调用频率,遇到安全验证时先在浏览器里手动处理,不要反复重试;使用时请遵守平台规则。
开发
npm test测试不连浏览器。
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only zobrx e-commerce data: P&L, orders, inventory, marketplace, tax & shelf insights.
Read-only Amazon seller analytics: sales, Buy Box, FBA inventory, alerts, revenue and fees.
Amazon Ads, Seller Central, Vendor Central and AMC data for AI agents. Read-only by default.
Read-only Amazon shopping intelligence: Top-100 BSR, product profiles, price history, comparisons.
Related MCP Servers
- FlicenseBqualityCmaintenanceAutomates login to Tmall/Taobao seller backends and enables browser automation such as navigation, content retrieval, clicking, typing, and screenshots.8102-
- AlicenseAqualityCmaintenanceEnables querying Pinduoduo merchant backend data through a logged-in Chrome session via CDP, including reviews, customer service chat, product analytics, and promotion reports.151MIT
- AlicenseNot gradedqualityCmaintenanceEnables read-only, local browser-based access to logged-in sessions on Xianyu, Taobao/Tmall, JD, and Pinduoduo for product search, detail inspection, link building/parsing, and cookie status checks, without chat, cart, ordering, or payment actions.MIT
- AlicenseNot gradedqualityBmaintenanceProvides read-only access to JD Shop Intelligence, Business Advisor, and Wanxiangtai data through a local Chrome bridge, enabling AI assistants to query authorized stores’ operations, products, inventory, transactions, refunds, and advertising reports.4MIT