Wildberries and Ozon search for Hermes
hermes-marketplace-tools
An MCP server that searches Wildberries and Ozon product cards for the Hermes agent, no keys, no side-side comparison logic
Low risk
We rate an entry low when it mostly gives the agent instructions and reference material.
Why this level
- Only reads the public catalog, cards and reviews, no account login
- All traffic goes through a third-party proxy the user supplies
Install
Manual install
uv venv && uv pip install -e . && uv run python -m camoufox fetchCore install plus fetching the headless browser for Ozon.
This is third-party code. Review the repository files before installing.
What it does
The server exposes three tools: product search with normalized results (price, rating, reviews, link), a full product card and reviews. Comparison and conclusions are left to the LLM, the server only fetches data. Wildberries is read directly over HTTP through a proxy with a Russian IP, Ozon needs the camoufox headless browser because of its anti-bot protection. A marketplace=all query searches both platforms at once.
Who it is for. For people configuring the Hermes agent to find and compare products on Wildberries and Ozon.
Good fit when
- You need the Hermes agent to search and read WB and Ozon product cards without an account
- You want to compare a product across both platforms in one query
- You have your own proxy with a Russian IP to reach the marketplaces
Not a fit when
- You need seller or buyer account access
- You have no proxy with a Russian IP: Ozon and Wildberries are unreachable without one
- You need a ready client other than Hermes: the server targets its config format
Example request
Find this product on Wildberries and Ozon and show me the price and rating on bothLimitations
Wildberries endpoints are unofficial and shift periodically, image CDN numbers are self-healed and cached locally. Ozon works only through camoufox (about 300 MB on first fetch), playwright is pinned hard to 1.50.0. All traffic goes through a proxy with a Russian IP, without it the service does not work. The README has no separate env var list, only an example in the config.
How to disable. Remove the marketplace block from mcp_servers in ~/.hermes/config.yaml and restart Hermes.
MCP
- Transport
- stdio
- Authentication
- not required
| Environment variables | |
|---|---|
| PROXY_URL required, secret | SOCKS5 proxy with a Russian IP to reach Ozon and Wildberries |
Security check
- Only reads the public catalog, cards and reviews, no account login
- All traffic goes through a third-party proxy the user supplies
README in short
The README describes three MCP tools (marketplace_search, get_product_card, get_reviews), installation via uv and camoufox, proxy setup through the PROXY_URL variable, and connecting to Hermes via ~/.hermes/config.yaml. It separately covers Wildberries parsing quirks: prices in kopecks, bypassing card.wb.ru blocks by impersonating Safari, and self-healing the image CDN number.
FAQ
Do I need an Ozon or Wildberries API key?
No, the server reads public pages and internal APIs through a browser and HTTP, no keys required.
Why does Ozon need a browser but Wildberries does not?
Ozon is protected by an anti-bot system and needs the camoufox headless browser to pass it, Wildberries endpoints are open over HTTP.
Related
Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent
Yandex Kit skills for store management
kit-skills
Yandex's official skill set: catalog, prices, stock, orders, storefront and a weekly checkup for a Yandex Kit store, through Claude Code or Codex
YouGile MCP by Indalo
YouGile MCP
Full 65-operation YouGile API coverage with configurable permissions, write confirmation and a shared company rate limit
Bitrix24 portal MCP server
MCP-сервер портала Битрикс24
Bitrix24's official per-portal MCP: an external agent uses OAuth or a token to read and change tasks, deals, meetings and mail