Wildberries Analytics MCP server

Wildberries Analytics MCP

A Wildberries seller-analytics MCP server: sales funnel, search reports, warehouse stock and CSV exports

dias-zhanabayev/wildberries_mcpAuthor:dias-zhanabayev

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/wildberries-analytics-mcp

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Assembled automatically, review before installing.

Run in a terminal

claude mcp add --transport stdio --env 'WILDBERRIES_TOKEN=<your WILDBERRIES_TOKEN>' wildberries -- uvx --directory '/полный/путь/к/wildberries-mcp' run main.py

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<your WILDBERRIES_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

WILDBERRIES_TOKENsecret, required: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in Cursor

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<your WILDBERRIES_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

WILDBERRIES_TOKENsecret, required: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in VS Code

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Run in a terminal

code --add-mcp '{"name":"wildberries","type":"stdio","command":"uvx","args":["--directory","/полный/путь/к/wildberries-mcp","run","main.py"],"env":{"WILDBERRIES_TOKEN":"<your WILDBERRIES_TOKEN>"}}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "wildberries": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<your WILDBERRIES_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

WILDBERRIES_TOKENsecret, required: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add wildberries --env 'WILDBERRIES_TOKEN=<your WILDBERRIES_TOKEN>' -- uvx --directory '/полный/путь/к/wildberries-mcp' run main.py

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.wildberries]
command = "uvx"
args = ["--directory", "/полный/путь/к/wildberries-mcp", "run", "main.py"]
env = { WILDBERRIES_TOKEN = "<your WILDBERRIES_TOKEN>" }

If the file already exists, append the block to the end.

Keys and settings

WILDBERRIES_TOKENsecret, required: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<your WILDBERRIES_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

WILDBERRIES_TOKENsecret, required: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<your WILDBERRIES_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

WILDBERRIES_TOKENsecret, required: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<your WILDBERRIES_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

WILDBERRIES_TOKENsecret, required: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<your WILDBERRIES_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

WILDBERRIES_TOKENsecret, required: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "wildberries": {
      "type": "local",
      "command": [
        "uvx",
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "environment": {
        "WILDBERRIES_TOKEN": "<your WILDBERRIES_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

WILDBERRIES_TOKENsecret, required: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<your WILDBERRIES_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

WILDBERRIES_TOKENsecret, required: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "wildberries": {
      "command": "uvx",
      "args": [
        "--directory",
        "/полный/путь/к/wildberries-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "WILDBERRIES_TOKEN": "<your WILDBERRIES_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

WILDBERRIES_TOKENsecret, required: Токен WB (обязательно). Кабинет продавца → Настройки → Доступ к API

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: uv

Checked against the repository on Sep 26, 2026, commit 10e4bce.

Text for your agent

Install uv, clone wildberries_mcp, run uv sync, copy example.env to .env and add WILDBERRIES_TOKEN from the seller dashboard, then add the server to your client config running uv run main.py.

Other ways from the author

git clone https://github.com/dias-zhanabayev/wildberries_mcp && cd wildberries_mcp && uv sync

Clones the repo and installs dependencies with uv.

This is third-party code. Review the repository files before installing.

What it does

The server connects Wildberries analytics reports to Claude Desktop and Cursor. Tools are split into four groups: a sales funnel by product card over a period or by day, search reports with SERP position and top queries per product, stock by product, size and warehouse, and CSV report creation with status checks and a ZIP download available for 48 hours. All tools are read-only; the underlying Wildberries API itself is capped at three requests per minute. The server installs via uv and runs locally with uv run main.py or in Docker.

Who it is for. For Wildberries sellers and analysts who want sales and search analytics in a conversational form.

Good fit when

You want to compare the sales funnel across periods or products
You need a product's search position and the top queries driving orders
You need stock by warehouse and size without opening the seller dashboard

Not a fit when

You need to operate on prices, supplies or ad bids: the server does not offer that
The Wildberries API's three-requests-per-minute cap does not fit your workload

Example request

Compare this month's sales funnel with last month and show the top 20 queries for product 123456

Limitations

You need a Wildberries seller token with analytics access. It requires Python 3.12 and the uv package manager. The Wildberries API caps analytics requests at three per minute, so reports for many products build up slowly. The project has no PyPI release, only a source install.

How to disable. Remove the wildberries entry from your MCP client configuration and stop the process or container.

MCP

Transport: stdio
Authentication: API key

Environment variables
Environment variables
WILDBERRIES_TOKEN required, secret	A seller token from the WB dashboard, API access section

Security check

Every tool only reads analytics, the funnel, search data and stock, with no changes to prices, bids or orders

README in short

The README gives a three-step quick start, Python 3.12 and uv requirements, config examples for Cursor and Claude Desktop with and without Docker, plain-language example requests, and a reference of every tool across four groups noting the three-requests-per-minute API cap.

FAQ

Can the server change prices or bids?

No, every tool only reads analytics, the funnel, search data and stock.

How long until a CSV report downloads?

The report is built as a job, its status is checked with a separate tool, and the finished ZIP is downloadable for 48 hours.

DataLens Skills

Official

Official DataLens (Yandex) skills for Claude Code, Codex and OpenCode: SDK, HTML reports and RLS resolution

SkillMedium riskRussian stackNo VPN needed12

Yandex Metrika MCP Server

Editors’ pick

A Yandex Metrika MCP server generated from the API spec: 108 methods, 10 tools declared by default, transparent filters and response metadata

MCP serverMedium riskRussian stackNo VPN needed2

OpenSEO

Official

An open MCP server and agent skill set for SEO: keyword research, competitors, backlinks and site audits powered by DataForSEO

MCP serverMedium risk21.5K

Claude SEO

A Claude Code plugin for SEO audits: technical SEO, E-E-A-T, schema, local and AI search via parallel subagents

PluginHigh risk17.9K

Install

What it does

Good fit when

Not a fit when

Example request

Limitations

MCP

Security check

README in short

FAQ

Related

DataLens Skills

Yandex Metrika MCP Server

OpenSEO

Claude SEO