Skip to main content
Glama
deenesjakoruzh
theYahia

@theyahia/wildberries-mcp

by theYahia
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

🗄 仓库已归档

开发已迁移至 theYahia/WWmcp —— 面向非西方 API 的 MCP 服务器单体仓库：独联体、MENA、非洲、LATAM、东南亚。公共核心 @theyahia/mcp-core，统一 CI，统一发布流水线。

此处内容的当前版本位于：servers/wildberries/

npm 包不变 —— @theyahia/wildberries-mcp，安装和使用方式与之前相同。 此处不再更新任何内容。问题和 pull request 请提交到 WWmcp。

已归档 —— 开发已迁移至 theYahia/WWmcp， 这是一个面向非西方 API 的 MCP 服务器单体仓库。 该包的当前版本现位于 servers/wildberries/。 npm 包 @theyahia/wildberries-mcp 保持不变。 请在那里提交问题和 pull request。

@theyahia/wildberries-mcp

MCP 服务器，用于 Wildberries 卖家 API —— 提供 30 个工具，涵盖产品、价格、库存、订单、销售、FBS 供应、分析、反馈、问题、退货和广告。按类别进行主机路由，支持速率限制和 409 惩罚保护。支持 Stdio + Streamable HTTP 传输。

npm License: MIT

Related MCP server: Wildberries MCP Server

快速开始

npm install -g @theyahia/wildberries-mcp

# stdio transport (for Claude Desktop, Cursor, etc.)
WB_API_TOKEN=your_token wildberries-mcp

# Streamable HTTP transport
WB_API_TOKEN=your_token wildberries-mcp --http

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "wildberries": {
      "command": "npx",
      "args": ["-y", "@theyahia/wildberries-mcp"],
      "env": { "WB_API_TOKEN": "your_token_here" }
    }
  }
}

Cursor / Windsurf / VS Code (Copilot) 在其 MCP 设置中使用相同的 mcpServers 块。

Smithery

npx @smithery/cli install @theyahia/wildberries-mcp

身份验证与令牌权限范围

Authorization: Bearer {WB_API_TOKEN}（JWT，有效期 180 天）。在卖家门户的 设置 → API 访问下获取你的令牌。

单个令牌可以携带多个类别权限范围。由于每个工具与不同的 API 主机通信，缺少某个权限范围的令牌会从该主机返回 401，而其他工具继续正常工作。请启用你需要的权限范围：

权限范围

支持的工具

Content

list_products, get_product

Prices & discounts

update_prices

Marketplace

update_stocks, get_stocks, get_orders, get_new_orders, get_warehouses, get_supply, create_supply, add_orders_to_supply, deliver_supply, get_supply_barcode

Statistics

get_sales, get_incomes, get_fbw_stocks, get_statistics, get_abc_analysis

Analytics

get_funnel, get_paid_storage

Tariffs (Common)

get_commission, get_tariffs

Feedbacks & questions

get_feedbacks, reply_feedback, get_questions, reply_question

Returns

get_returns

Advertising

get_balance, list_campaigns, get_campaign_stats

当调用失败时，错误消息会指明主机并包含 WB 的 requestId，因此缺少权限范围或主机错误的问题一目了然（例如 WB API GET advert-api.wildberries.ru/adv/v1/balance → 401: ...）。

架构 —— 按类别划分的主机

Wildberries 卖家 API 不是单一网关。seller.wildberries.ru 是 Web 控制台；API 分散在多个类别主机上。每个请求都会路由到正确的主机：

类别

主机

Content

content-api.wildberries.ru

Prices & discounts

discounts-prices-api.wildberries.ru

Marketplace (FBS)

marketplace-api.wildberries.ru

Statistics

statistics-api.wildberries.ru

Analytics

seller-analytics-api.wildberries.ru

Common / Tariffs

common-api.wildberries.ru

Feedbacks & questions

feedbacks-api.wildberries.ru

Returns

returns-api.wildberries.ru

Advertising

advert-api.wildberries.ru

工具（30）

产品与内容

工具

方法

主机 · 端点

list_products

POST

content · /content/v2/get/cards/list

get_product

POST

content · /content/v2/get/cards/detail

update_prices

POST

prices · /api/v2/upload/task

update_stocks

PUT

marketplace · /api/v3/stocks/{warehouseId}

get_stocks

POST

marketplace · /api/v3/stocks/{warehouseId}

订单与销售

工具

方法

主机 · 端点

get_orders

GET

marketplace · /api/v3/orders

get_new_orders

GET

marketplace · /api/v3/orders/new

get_sales

GET

statistics · /api/v1/supplier/sales

get_incomes

GET

statistics · /api/v1/supplier/incomes

get_fbw_stocks

GET

statistics · /api/v1/supplier/stocks

仓库与 FBS 供应

工具

方法

主机 · 端点

get_warehouses

GET

marketplace · /api/v3/offices

get_supply

GET

marketplace · /api/v3/supplies

create_supply

POST

marketplace · /api/v3/supplies

add_orders_to_supply

PATCH

marketplace · /api/v3/supplies/{id}/orders/{orderId}

deliver_supply

PATCH

marketplace · /api/v3/supplies/{id}/deliver

get_supply_barcode

GET

marketplace · /api/v3/supplies/{id}/barcode

分析

工具

方法

主机 · 端点

get_statistics

GET

statistics · /api/v5/supplier/reportDetailByPeriod

get_abc_analysis

GET

statistics · reportDetailByPeriod (computed Pareto)

get_funnel

POST

analytics · /api/v2/nm-report/detail

get_paid_storage

GET

analytics · /api/v1/paid_storage (async report)

定价参考

工具

方法

主机 · 端点

get_commission

GET

common · /api/v1/tariffs/commission

get_tariffs

GET

common · /api/v1/tariffs/box

反馈与问题

工具

方法

主机 · 端点

get_feedbacks

GET

feedbacks · /api/v1/feedbacks

reply_feedback

PATCH

feedbacks · /api/v1/feedbacks

get_questions

GET

feedbacks · /api/v1/questions

reply_question

PATCH

feedbacks · /api/v1/questions

退货与广告

工具

方法

主机 · 端点

get_returns

GET

returns · /api/v1/claims

get_balance

GET

advert · /adv/v1/balance

list_campaigns

GET

advert · /adv/v1/promotion/count

get_campaign_stats

POST

advert · /adv/v2/fullstats

速率限制

Wildberries 按 API 类别计量请求，而不是作为一个全局池 —— 并对突发请求返回 409 作为惩罚。客户端为每个主机维护一个令牌桶限制器，并为最严格的端点提供更细粒度的桶：

  • 每主机令牌桶，请求之间设有最小间隔。

  • 409 惩罚处理：读取 X-Ratelimit-Retry-After / X-Ratelimit-Remaining，扣除惩罚令牌，并在重试前等待指定时长 —— 惩罚仅局限于违规类别。

  • 严格的每端点上限（付费存储创建/下载 1/分钟，状态 1/5 秒；价格约 10/6 秒）。

默认值刻意保守，在观察到你账户的实际限制后可以安全调高。无需配置。

配置

变量

必填

说明

WB_API_TOKEN

是

Wildberries 卖家 API 令牌（JWT）。

WB_TIMEOUT_MS

否

每个请求的超时时间（毫秒，默认 30000）。

PORT

否

使用 --http 运行时的 HTTP 端口（默认 3000）。

HTTP 端点（--http）：POST /mcp（请求），GET /health（{ status, version, tools }）。

示例提示

“列出我目录中前 50 个产品及其当前价格。” “对最近 30 天运行 ABC 分析 —— 哪些产品贡献了 80% 的收入？” “创建 FBS 供应 'Morning 2026-06-23'，附加订单 1001 和 1002，然后关闭它以便发货并获取其条形码。” “显示未回答的问题，并为第一个问题起草回复。” “我的广告余额是多少，哪些广告活动处于活跃状态？”

开发

git clone https://github.com/theYahia/wildberries-mcp.git
cd wildberries-mcp
npm install
npm run build
npm test

许可证

MIT —— 参见 LICENSE。

Install Server
A
license - permissive license
B
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • MoySklad MCP Server

    theYahia
    A
    license
    C
    quality
    B
    maintenance
    MCP server for MoySklad (МойСклад) warehouse and CRM management API. 21 tools covering the full order lifecycle: products, stock, counterparties, customer orders, shipments, supplies, warehouses, organizations, reports, and webhooks.
    60
    121
    5
    MIT

  • marketplaces-mcp-ru

    ilyautov
    A
    license
    A
    quality
    A
    maintenance
    AI-доступ к кабинетам Wildberries и Ozon через MCP-сервера над Seller API. Обеспечивает 793 метода для управления продажами, остатками, ценами, финансами, отзывами и рекламой с safety-гейтом и авто-пагинацией.
    58
    12
    MIT

  • wildberries-mcp

    shndo1337
    F
    license
    Not graded
    quality
    C
    maintenance
    MCP server that turns Wildberries marketplace into a toolkit for LLM agents, enabling product search, detailed card inspection, price history, reviews, and cross-product comparison.

View all related MCP servers

Related MCP Connectors

  • DataDoe MCP

    Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.

  • agentcentral

    Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.

  • ListingGood MCP

    Get recommended by Amazon's AI. Hosted MCP server for Amazon listing compliance & generation.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/theYahia/wildberries-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server