SkillFoxx

Ozon buyer-side MCP with delivery city selection

ozon-customer-mcp

A Docker MCP server for the Ozon buyer side: search, product cards, reviews, questions, sellers, categories, brands, and live delivery-city selection

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Keeps a Camoufox browser in Docker that passes Ozon anti-bot checks and reads the internal API
  • Uses an anonymous session, no shopper login needed
All reasons and checks
Russian stack

raleose/ozon-customer-mcpAuthor:Raleose

Install

Services

Manual install

git clone https://github.com/Raleose/ozon-customer-mcp.git && cd ozon-customer-mcp && docker build -t ozon-customer-mcp:latest .

Building the Docker image before connecting it to an MCP client.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Keeps a Camoufox browser in Docker that passes Ozon anti-bot checks and reads the internal API
  • Uses an anonymous session, no shopper login needed

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

What it does

The server keeps a Camoufox anti-detect browser session, passes the JS anti-bot challenge once, and then reads the internal composer-api as JSON without parsing HTML. Of its 17 tools, there is search with filters, a single card and a batch read of up to 40 cards at once, reviews and Q&A with sorting, the same product's offers from other sellers together with delivery dates, comparison of 2-8 products, a seller profile and catalog, a live category tree with no hardcoding, a brand showcase, and related products. A separate tool group manages the delivery city: by default the session is anonymous and set to Moscow, ozon_search_cities looks up a city through Ozon's own live Maps suggest, ozon_set_city switches it in 20-40 seconds, after which dates in ozon_product_offers reflect the chosen region.

Who it is for. For people who want an agent to have anonymous access to the Ozon catalog with delivery-region awareness, without logging into a personal account.

Good fit when

  • You need Ozon search, comparison and product cards with delivery dates for a specific city
  • You need a seller or brand catalog with no account login
  • You are ready to run a Docker container with Camoufox per MCP session

Not a fit when

  • You need personal account, cart or order access: the server only works anonymously
  • You have no Docker or don't want to spend about 1 GB of shm on the container
  • You need it to work with no proxy or Camoufox in regions where Ozon's anti-bot is aggressive

Example request

Find this product on Ozon, show alternatives from other sellers and delivery dates to Kazan

MCP

Transport
stdio
Authentication
not required

Environment variables

OZON_HEADLESS
Runs Camoufox headless, defaults to true
OZON_CHALLENGE_WAIT_MS
Wait time for the anti-bot challenge, defaults to 15000 ms

Limitations

Needs Docker and a container that stays alive for the MCP session, it self-terminates on idle after OZON_EXIT_IDLE_MS. The category for ozon_category_browse needs a real slug specifically from ozon_list_categories or ozon_search_filters: Ozon keys on the numeric id, not the string prefix, a guessed slug can open the wrong category. On a CAPTCHA or anti-bot block the README recommends a different IP or a Russian proxy, there is no built-in bypass beyond that.

How to disable. Remove the ozon-customer block from your MCP client config and stop the Docker container.

FAQ

Do you need an Ozon account?

No, the server runs an anonymous session with no login, defaulting to Moscow as the delivery city.

How do you find the correct category slug?

Only via ozon_list_categories or ozon_search_filters, never by guessing from a name: Ozon keys on the numeric id.

Discussion

No questions or reviews yet.

All Ozon tools
Russian stack

Buyer-side Ozon MCP server: product search, product pages with prices and stock, customer reviews

MCP serverExtended access88
Russian stack

An MCP server for one ozon.ru buyer account: orders, cart, favorites, selections, and, when explicitly allowed, placing and paying for an order

MCP serverBroad access9
Russian stack

Unofficial buyer-side Ozon MCP server: product search, prices, specs and reviews without Seller API keys

MCP serverExtended access16
Russian stack

MCP server for the Ozon Seller and Performance APIs: prices, promotions, ads, orders, returns and finance across several stores

MCP serverBroad access11

README in short

The README lists all 17 tools in a table, explains the Camoufox-plus-internal-composer-api mechanism instead of HTML parsing, gives a delivery-city-change scenario example, a Docker quick start with an mcp.json example, a Node/Python bridge architecture diagram, and an environment variable table covering OZON_HEADLESS, OZON_GEOIP and OZON_CHALLENGE_WAIT_MS.

README badge

Report a problem