跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Wildberries，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
通过 AI 代理运营 Wildberries 卖家账户：FBS 订单及其状态、卖家仓库和库存、订单与销售统计、WB 仓库库存、销售报告明细、商品卡片和价格。覆盖各个 WB API 主机的 22 个工具，只需一个 API 令牌。
试试这样问
Wildberries 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Wildberries、粘贴凭证、生成 MCP API key — 完成。无 Docker、无
git clone、无本地服务器。
Wildberries + Gemini
通过 AI 代理运营 Wildberries 卖家账户：FBS 订单及其状态、卖家仓库和库存、订单与销售统计、WB 仓库库存、销售报告明细、商品卡片和价格。覆盖各个 WB API 主机的 22 个工具，只需一个 API 令牌。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
WILDBERRIES_API_TOKEN
步骤 1 — 获取凭证
一个令牌即可用于所有工具；每个工具会自行调用正确的 WB API 主机（市场、统计、分析、财务、内容、价格）。
- 在卖家门户中打开 Settings → API integrations（Настройки → Доступ к API），点击 Create token。
- 令牌类型选择 Base token。Wildberries 规定个人（Personal）令牌不得用于云服务。Base token 在统计、财务、商品卡片和价格方面的限制更低（见下文）。
- 勾选需要的类别：Marketplace（FBS 订单、仓库、库存）、Statistics、Analytics（WB 仓库库存）、Finance（销售报告）、Content（商品卡片）、Prices and Discounts。除非要让 AI 修改库存或价格，否则选择 Read only。
- 令牌只显示一次，将其不带
Bearer复制到WILDBERRIES_API_TOKEN。有效期 180 天，请在到期前创建新令牌。 - 先调用
wildberries_ping检查令牌，再用wildberries_list_new_orders查看待打包的 FBS 订单。
401 表示令牌错误或已过期；403 表示令牌缺少该部分 API 所需的类别。
速率限制很严格。 Marketplace：每分钟 300 次请求，每个 4xx 响应按 10 次计。订单和销售统计：每分钟 1 次，使用 Base token 时每 3 小时仅 1 次，所以请带上 date_from 调用一次，然后基于结果工作。销售报告明细：Base token 每天 2 次。价格：Base token 每小时 4 次。遇到 429 时，等待 X-Ratelimit-Retry 中给出的秒数。
WB 仓库库存：wildberries_get_wb_warehouse_stocks 对 Base token 返回 403。请改用报告流程：wildberries_create_stock_report，然后 wildberries_get_stock_report_status，再 wildberries_download_stock_report。
写操作：wildberries_update_stocks 会覆盖库存数量（不是累加），wildberries_set_prices 会修改线上价格。更新后请重新读取库存：字段名写错时接口仍返回 204，但不会做任何更改。
步骤 2 — 安装 adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
步骤 3 — 在 Gemini 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启
gemini。 - 在 Gemini CLI 中运行
/mcp（或在终端运行gemini mcp list）—anythingmcp应显示为已连接。 - 开始输入提示 — Gemini CLI 现在可以调用
Wildberries的工具。
可用工具
| Tool | What it does |
|---|---|
wildberries_ping | Check that the API token is valid and reaches the WB API |
wildberries_get_seller_info | Get the seller account behind the token: legal name, seller id (sid), tax number and trade mark |
wildberries_list_new_orders | List every new FBS assembly order (order to pack and ship from your own warehouse) that exists right now: id, nmId, chrtId, article, price… |
wildberries_list_orders | List FBS assembly orders created in a period (at most 30 days per call, up to 3 months back), without their current status |
wildberries_get_order_statuses | Get the current status of up to 1000 FBS assembly orders by id: supplierStatus (new, confirm, complete, cancel), wbStatus (waiting, sorted… |
wildberries_list_supplies | List FBS supplies (shipments that group assembly orders for hand-over to Wildberries): id, name, done, created and closed dates, cargo type |
wildberries_list_warehouses | List the seller's own warehouses (id, name, linked WB office, cargo and delivery type) |
wildberries_list_wb_offices | List Wildberries offices (WB warehouses and sorting centres) that a seller warehouse can be linked to: id, name, city, address… |
wildberries_get_stocks | Read the stock on one seller warehouse for up to 1000 product sizes |
wildberries_update_stocks | Overwrite the stock of up to 1000 product sizes on one seller warehouse |
wildberries_list_statistics_orders | Orders statistics from the statistics host: one row per ordered unit with date, lastChangeDate, warehouse, region, article, nmId, barcode… |
wildberries_list_statistics_sales | Sales and returns statistics: one row per sold or returned unit with saleID (S for sale, R for return), dates, warehouse, article, nmId… |
wildberries_get_wb_warehouse_stocks | Current stock on Wildberries warehouses (FBW), one row per product size per WB warehouse, updated every 30 minutes |
wildberries_create_stock_report | Start generating the WB warehouses inventory report (stock per product on Wildberries warehouses), which also works with a Base token |
wildberries_get_stock_report_status | Check whether a WB warehouses inventory report task is ready |
wildberries_download_stock_report | Download a finished WB warehouses inventory report: per product (brand, subject, vendorCode, nmId, barcode, size) the quantity on each… |
wildberries_get_sales_report_detail | Detail lines of the sales (realisation) reports for a period: sales, returns, logistics, storage, fines and payouts per line, from 29… |
wildberries_list_product_cards | List product cards (listings) with nmID, vendorCode, brand, title, subject, characteristics, photos and sizes (chrtID, barcodes) |
wildberries_list_prices | List products with their prices: nmID, vendorCode, currency, discount, WB Club discount and per-size price and discounted price |
wildberries_set_prices | Set prices and discounts for up to 1000 products in one upload |
wildberries_get_price_upload_status | Get the state of a processed price and discount upload by its id: status, upload and activation dates, total and failed product counts |
wildberries_get_card_limits | Get the free and paid limits for creating product cards |
FAQ
Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。
下一步
这份指南对你有帮助吗?
