Skip to main content
Glama
deenesjakoruzh
theYahia

@theyahia/wildberries-mcp

by theYahia
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

🗄 リポジトリはアーカイブされました

開発は theYahia/WWmcp に移転しました — 非西洋API向けMCPサーバーのモノレポ: CIS、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

Wildberries Seller API 用のMCPサーバー — 商品、価格、在庫、注文、売上、FBS供給、分析、フィードバック、質問、返品、広告にわたる 30ツール。カテゴリ別ホストルーティング、レート制限、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アクセス で取得できます。

1つのトークンに複数の カテゴリスコープ を持たせることができます。各ツールは異なるAPIホストと通信するため、スコープが不足しているトークンは その ホストから 401 を返しますが、他のツールは引き続き動作します。必要なスコープを有効にしてください:

スコープ

対象ツール

コンテンツ

list_products, get_product

価格・割引

update_prices

マーケットプレイス

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

統計

get_sales, get_incomes, get_fbw_stocks, get_statistics, get_abc_analysis

アナリティクス

get_funnel, get_paid_storage

料金 (共通)

get_commission, get_tariffs

フィードバック・質問

get_feedbacks, reply_feedback, get_questions, reply_question

返品

get_returns

広告

get_balance, list_campaigns, get_campaign_stats

呼び出しが失敗すると、エラーメッセージにホスト名とWBの requestId が含まれるため、スコープ不足やホスト違いの問題が明確にわかります (例: WB API GET advert-api.wildberries.ru/adv/v1/balance → 401: ...)。

アーキテクチャ — カテゴリ別ホスト

Wildberries Seller API は 単一の ゲートウェイではありません。seller.wildberries.ru はWeb管理画面であり、APIはカテゴリ別ホストに分割されています。各リクエストは適切なホストにルーティングされます:

カテゴリ

ホスト

コンテンツ

content-api.wildberries.ru

価格・割引

discounts-prices-api.wildberries.ru

マーケットプレイス (FBS)

marketplace-api.wildberries.ru

統計

statistics-api.wildberries.ru

アナリティクス

seller-analytics-api.wildberries.ru

共通 / 料金

common-api.wildberries.ru

フィードバック・質問

feedbacks-api.wildberries.ru

返品

returns-api.wildberries.ru

広告

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 (パレート計算)

get_funnel

POST

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

get_paid_storage

GET

analytics · /api/v1/paid_storage (非同期レポート)

価格リファレンス

ツール

メソッド

ホスト · エンドポイント

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 を返します。クライアントは ホストごとに 1つのトークンバケットリミッターを保持し、最も厳しいエンドポイントにはさらに細かいバケットを用意しています:

  • リクエスト間の最小間隔を持つホスト別トークンバケット。

  • 409 ペナルティ処理: X-Ratelimit-Retry-After / X-Ratelimit-Remaining を読み取り、ペナルティトークンを差し引き、指定された時間待機してから再試行します — ペナルティは問題のカテゴリにのみ適用されます。

  • エンドポイントごとの厳格な上限 (paid-storage 作成/ダウンロード 1/分、ステータス 1/5秒、価格 ~10/6秒)。

デフォルト値は意図的に控えめに設定されており、アカウントの実際の制限を確認したら安全に引き上げられます。設定は不要です。

設定

変数

必須

説明

WB_API_TOKEN

はい

Wildberries Seller API トークン (JWT)。

WB_TIMEOUT_MS

いいえ

リクエストごとのタイムアウト (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