hermes-marketplace-tools
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@hermes-marketplace-tools find the cheapest iPhone 15 Pro Max on Wildberries"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
hermes-marketplace-tools
Тулы поиска/сравнения товаров на Wildberries (и Ozon — в планах) для агента Hermes. Подключаются как MCP-сервер. Сравнение и рекомендации делает сам LLM — тулы только отдают нормализованные данные.
Статус: Wildberries и Ozon — готовы оба (search/card/reviews на каждом).
Один запрос marketplace="all" ищет на обоих. См. SPEC.md.
Тулы
Тул | Что делает |
| поиск товаров → нормализованная выдача (цена, рейтинг, отзывы, ссылка, превью) |
| полная карточка: характеристики, описание, URL картинок |
| отзывы (сортировка по полезности/свежести) |
Related MCP server: wildberries-mcp
Установка
git clone <repo> hermes-marketplace-tools
cd hermes-marketplace-tools
uv venv && uv pip install -e .
uv run python -m camoufox fetch # бинарь Firefox для Ozon (~300 МБ, разово)Ozon ходит через headless-браузер (camoufox). WB работает по HTTP и браузера не требует.
playwrightзапинен на 1.50.0 — новее ломает протокол с firefox-сборкой camoufox.
Конфигурация
Прокси (SOCKS5, RU-IP) задаётся переменной окружения PROXY_URL. Не коммить креды.
export PROXY_URL="socks5h://USER:PASS@pool.proxy.market:10000"Подключение к Hermes
В ~/.hermes/config.yaml:
mcp_servers:
marketplace:
command: "/path/to/hermes-marketplace-tools/.venv/bin/python"
args: ["-m", "mcp_server.server"]
env:
PROXY_URL: "socks5h://USER:PASS@pool.proxy.market:10000"После правки конфига перезапусти Hermes — MCP-серверы загружаются на старте.
Тулы появятся как mcp_marketplace_marketplace_search и т.д.
Локальный прогон (без Hermes)
PROXY_URL="socks5h://..." .venv/bin/python -m mcp_server.server # запустит MCP по stdioДля проверки логики ядра — см. marketplace_core (можно импортировать MarketplaceService
напрямую; так же его будет использовать будущий Telegram-бот).
Заметки по WB (важно при поломках)
Весь трафик идёт через прокси (RU-IP); цены приходят в копейках.
card.wb.ru/v4отдаёт 403 на TLS-профиль Chrome — клиент используетimpersonate="safari".URL картинок собираются по схеме
basket-{NN}.wbbasket.ru/...; номерNNподбирается self-healing и кэшируется в~/.hermes/marketplace_cache.sqlite.Эндпоинты WB неофициальные и иногда меняют версии — см.
SPEC.md(Приложение A).
Available Tools
3 toolsget_product_cardC
Полная карточка: характеристики, описание, URL изображений.
Inputs: id_or_url (required), marketplace (required).
get_reviewsC
Отзывы о товаре.
Inputs: id_or_url (required), marketplace (required), sort, limit. Returns: result
marketplace_searchA
Поиск товаров на Ozon и/или Wildberries. Возвращает нормализованную выдачу.
Сформируй несколько запросов (с брендом и без, разные формулировки) для лучшего покрытия. Сравнение и выбор делай сам по полученным данным.
Inputs: query (required), brand, limit, max_price, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct function: product details (get_product_card), reviews (get_reviews), and search (marketplace_search). There is no overlap or ambiguity.
Two tools follow a 'get_' pattern, but 'marketplace_search' deviates slightly by being noun_verb. The inconsistency is minor and readability remains high.
Three tools is a reasonable number for a focused marketplace-browsing server. The scope is narrow but well-defined; no tool feels superfluous.
The set covers search, product card retrieval, and reviews, but lacks mutation operations (e.g., add to cart, compare) and entity listing (e.g., categories). Gaps exist but core browsing workflows are covered.
Maintenance
Related MCP Connectors
SEO score and checks for Wildberries, Ozon, Yandex Market product cards; AI card generation.
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Shopping infrastructure for AI agents: product search, category price overviews, price checks and seller vetting across US online retail, as structured facts over MCP.
Product search for AI shopping agents: prices and buy links from big retailers. No key needed.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables product comparison and analysis for any MCP-compatible AI assistant, with tools like compare_products and list_products.-
- FlicenseNot gradedqualityDmaintenanceMCP server that turns Wildberries marketplace into a toolkit for LLM agents, enabling product search, detailed card inspection, price history, reviews, and cross-product comparison.-
- AlicenseAqualityCmaintenanceEnables querying and comparing prices, availability, ratings, reviews, and seller details from major Russian and Chinese marketplaces (Wildberries, Ozon, Yandex Market, and others) without requiring API keys, via a unified MCP interface.2425MIT
- FlicenseAqualityBmaintenanceEnables AI assistants to retrieve a Wildberries seller's product cards and customer reviews through the official Content and Feedbacks APIs.2-