Skip to main content
Glama
deenesjakoruzh
theYahia

@theyahia/wildberries-mcp

by theYahia
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

🗄 저장소가 보관 처리되었습니다

개발은 **theYahia/WWmcp**로 이전되었습니다 — 비서구권 API(CIS, MENA, 아프리카, LATAM, 동남아시아)를 위한 MCP 서버 모노레포입니다. 공통 코어 @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 판매자 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 액세스에서 얻을 수 있습니다.

단일 토큰은 여러 카테고리 범위를 가질 수 있습니다. 각 도구는 서로 다른 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는 웹 관리자 화면이고, 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를 패널티로 반환합니다. 클라이언트는 호스트별 토큰 버킷 제한기와 가장 엄격한 엔드포인트를 위한 세부 버킷을 유지합니다:

  • 호스트별 토큰 버킷, 요청 간 최소 간격.

  • 409 패널티 처리: X-Ratelimit-Retry-After / X-Ratelimit-Remaining을 읽고, 패널티 토큰을 차감하며, 재시도 전에 지정된 시간을 대기 — 패널티는 해당 카테고리에만 격리됩니다.

  • 엄격한 엔드포인트별 상한 (유료 보관 생성/다운로드 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