Wildberries and Ozon search for Hermes MCP
hermes-marketplace-tools
An MCP server that searches Wildberries and Ozon product cards for the Hermes agent, no keys, no side-side comparison logic
- 2 ★ on the repository
- Last commit
Extended access
Why this level
- Reads the Wildberries catalog via unofficial endpoints through your proxy
- Launches the camoufox headless browser for Ozon
- No seller or buyer account login
Install
- Works in
- Services
Manual install
uv venv && uv pip install -e . && uv run python -m camoufox fetchCore install plus fetching the headless browser for Ozon.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads the Wildberries catalog via unofficial endpoints through your proxy
- Launches the camoufox headless browser for Ozon
- No seller or buyer account login
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 bothMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
PROXY_URLrequired, secret- SOCKS5 proxy with a Russian IP to reach Ozon and Wildberries
Limitations
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.
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.
Discussion
No questions or reviews yet.
Related
All Ozon toolsRead-only search across Ozon, WB, Yandex Market and Avito
Marketplace MCP
A read-only MCP server: product search and comparison across Ozon, Wildberries, Yandex Market and Avito, plus Ozon Travel flights and hotels
Best Ozon product picker for Hermes
Ozon Product Picker
A Hermes Agent skill that searches Ozon products via Apify and picks the best option plus one or two alternatives by price, rating and seller
MCP servers for marketplace search via Apify
Marketplaces MCP Servers
Three MCP servers that search products on Wildberries, Ozon and Yandex Market through Apify actors, with caching and compact output for agent context
MCP servers for Wildberries, Ozon, Yandex Market and Avito seller accounts via official APIs with write confirmation
Unofficial buyer-side Ozon MCP server: product search, prices, specs and reviews without Seller API keys
Ozon MCP Server for buyer-side search
Ozon MCP Server
Buyer-side Ozon MCP server: product search, product pages with prices and stock, customer reviews
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Wildberries and Ozon search for Hermes (this card) | no | not required | 2 | |
| Semantic search over Jivo and SaluteBot docs | no | not required | 0 | search over SaluteBot, Jivo and SberSalute docs |
| Local search over Bitrix24 chat history | no | API key | 0 | search over portal chat history |
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.