Back to search
ru-marketplace-mcp
MarketplaceGitHub
ru-marketplace-mcp для Claude Code: 12 маркетплейсов РФ и Китая и недвижимость Циан как MCP-серверы и 14 навыков без ключей API.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/vladimir-human--ru-marketplace-mcp)HTML
<a href="/listings/vladimir-human--ru-marketplace-mcp"><img src="/api/listings/vladimir-human--ru-marketplace-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 16 lines
- {
- "$schema": "https://www.schemastore.org/claude-code-marketplace.json",
- "name": "ru-marketplace-mcp",
- "owner": {"name": "Vladimir-Human", "url": "https://github.com/Vladimir-Human"},
- "description": "ru-marketplace-mcp для Claude Code: 12 маркетплейсов РФ и Китая и недвижимость Циан как MCP-серверы и 14 навыков без ключей API.",
- "plugins": [
- {
- "name": "ru-marketplace-mcp",
- "source": "./",
- "description": "Двенадцать площадок РФ и Китая (Wildberries, Ozon, Яндекс Маркет, Авито, Циан, AliExpress, Taobao, Детский мир, Мегамаркет, Lamoda, DNS, Ситилинк) как MCP-серверы и 14 навыков. Сравнение цен без ключей API.",
- "version": "2.11.0",
- "license": "MIT",
- "keywords": ["mcp", "wildberries", "ozon", "yandex-market", "avito", "cian", "aliexpress", "taobao", "price-comparison", "russia"]
- }
- ]
- }
README.md · README · 555 lines
- # ru-marketplace-mcp — MCP-серверы для маркетплейсов России и Китая
- <!-- mcp-name: io.github.Vladimir-Human/ru-marketplace-mcp -->
- **Русский** · [English](README.en.md) · [Установка для ИИ-агентов](llms-install.md) · [llms.txt](llms.txt)
- [](https://github.com/Vladimir-Human/ru-marketplace-mcp/actions/workflows/ci.yml)
- [](https://pypi.org/project/ru-marketplace-mcp/)
- [](https://www.npmjs.com/package/ru-marketplace-mcp-dsh)
- [](https://www.python.org/downloads/)
- [](https://modelcontextprotocol.io)
- [](LICENSE)
- Живые цены, остатки, рейтинги, отзывы и реквизиты продавцов с 12 площадок РФ и
- Китая: **Wildberries**, **Ozon**, **Яндекс Маркет**, **Авито**, **AliExpress**,
- **Taobao**, **DNS**, **Ситилинк**, **Мегамаркет**, **Lamoda**, **Детский мир** и
- недвижимость с **Циана**.
- `compare_prices` сравнивает цены по всем товарным площадкам одним вызовом,
- отсеивает флешки и чехлы по цене смартфона (`cheapest_comparable`) и не выдаёт
- скидку по WB Кошельку, Яндекс Пэй или купону за обычную цену. Только чтение, без
- ключей API и кабинета продавца: открытые площадки отвечают по HTTP, закрытые
- анти-ботом — через ваш отдельный Chrome (для Taobao и Мегамаркета в нём нужен
- обычный покупательский вход).
- <p align="center">
- <img src="docs/assets/demo-compare.svg" width="560"
- alt="compare_prices("iphone 16 128gb"): флешка 1 531 ₽ и цена по WB Кошельку 56 833 ₽ не побеждают; лидер comparable — Apple iPhone 16 за 64 990 ₽ на AliExpress">
- </p>
- <sub>Реальный разбор из раздела <a href="#настоящий-ответ">«Настоящий ответ»</a> (`c1-iphone16-128gb.json`).</sub>
- ## Быстрый старт
- Нужны **Python 3.12+** и [uv](https://docs.astral.sh/uv/). Клонировать репозиторий
- не нужно: одна команда скачает пакет с PyPI, найдёт установленные MCP-клиенты и
- настроит подключение (`--dry-run` только покажет план):
- ```bash
- uvx ru-marketplace-mcp setup
- ```
- Или установка в один клик:
- [](https://vscode.dev/redirect/mcp/install?name=marketplace&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22--from%22%2C%22ru-marketplace-mcp%22%2C%22compare-mcp%22%5D%7D)
- [](https://cursor.com/en/install-mcp?name=marketplace&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJydS1tYXJrZXRwbGFjZS1tY3AiLCJjb21wYXJlLW1jcCJdfQ==)
- Для **Claude Desktop** без терминала — бандл `ru-marketplace-mcp-compare-<версия>.mcpb` в [GitHub Releases](https://github.com/Vladimir-Human/ru-marketplace-mcp/releases) (проверено на Windows, на macOS не проверялось).
- ### Какой профиль выбрать
- Описания подключённых инструментов уходят модели в каждом запросе, поэтому
- `setup` и `install` по умолчанию ставят компактный профиль `compare`:
- | Профиль | Объём | Когда выбирать |
- | --- | --- | --- |
- | **`compare`** *(по умолч.)*<br>`compare-mcp` | 4 · ≈1.7k | Сравнить цены по площадкам и проверить карточку лидера |
- | **`decision`**<br>`decision-mcp` | 5 · ≈2.0k | Всё из `compare` плюс осмотр шортлиста с отзывами |
- | **`full`**<br>`marketplace-mcp` | 39 · ≈13.1k | Прямой поиск, отзывы, продавцы, категории и Циан |
- | Одна площадка<br>`--per-source` | 2–8 · мин. | Нужен только один маркетплейс |
- > **Безопасность и границы:** не включайте эти серверы в одну сессию агента с инструментами, которые читают личные данные и могут отправить их наружу без вашего подтверждения, и держите отдельный профиль Chrome без почты и банка ([SECURITY.md](SECURITY.md)).
- [Первый успешный запрос](docs/QUICKSTART.md) · [Справочник инструментов](docs/TOOLS.md) ·
- [Архитектура](docs/ARCHITECTURE.md) · [Про анти-бот](docs/ANTI_BOT.md)
- ---
- ## Поддерживаемые площадки (12 источников)
- | Площадка | Доступ | Что умеет |
- | --- | --- | --- |
- | **Wildberries** (8) | HTTP (403 → Chrome) | Поиск, карты, отзывы, Q&A, seller ID, каталог |
- | **Яндекс Маркет** (2) | прямой HTTP | Цены и отзывы, оценки по звёздам |
- | **Детский мир** (3) | прямой HTTP | Детские товары, остатки, каталог |
- | **Ozon** (3) | Chrome / HTTP | Поиск, карты, отзывы |
- | **Авито** (3) | Chrome + паузы | Лоты, карты, рейтинг продавца |
- | **Taobao** (2) | Chrome + вход | Поиск, карты, цены в юанях |
- | **Мегамаркет** (2) | Chrome + вход | Поиск и карты через API |
- | **Lamoda** (2) | HTTP → Chrome | Поиск, карты, размеры |
- | **DNS** (2) | Chrome (Qrator) | Поиск и карты техники |
- | **Ситилинк** (2) | Chrome (Qrator) | Поиск и карты техники |
- | **AliExpress** (2) | Chrome (x5sec) | Поиск и карты в рублях |
- | **Циан** (2) | Chrome (WAF IP) | Жильё: продажа, аренда, сутки |
- | **Сравнение** (4) | по площадкам | «Где дешевле?», сверка, снимок |
- Без браузера работают Wildberries, Яндекс Маркет и Детский мир (если API
- Wildberries отвечает 403, поиск и карточки сами перечитываются через ваш Chrome).
- Карточки Lamoda сначала идут по HTTP GraphQL и обращаются к Chrome (CDP) только
- при отказе. Остальным нужен ваш Chrome с CDP, а Taobao и Мегамаркету — ещё и вход
- в аккаунт площадки: без него Taobao упирается в страницу входа, а Мегамаркет
- возвращает пустую выдачу. Авито режет датацентровые адреса и отвечает с обычного
- (не облачного) подключения при спокойном темпе запросов. К браузерным источникам
- коннекторы ходят с паузой: очередь без передышки роняет сессию (так на проверках
- отваливались DNS и Taobao). Точное состояние из вашей среды покажет
- `marketplace-mcp doctor`.
- Аналитика MPStats переехала на официальный MCP-сервер MPStats (`https://mcp.mpstats.io/mcp?token=<ваш токен MPStats>`) и в текущий состав `ru-marketplace-mcp` не входит.
- Всего 37 инструментов в 13 серверах на общем рантайме `mcp-core`, плюс
- промежуточный `decision-mcp` (5 инструментов) и объединённый `marketplace-mcp`,
- который монтирует всё под одной записью в конфиге клиента и добавляет два своих
- инструмента — `marketplace_sources` (какие коннекторы поднялись, а какие
- пропущены и почему) и `marketplace_health` (жив ли Chrome, какие хосты остывают,
- какую страницу открыть человеку) — итого 39 инструментов.
- ### Настоящий ответ
- `compare_prices(query="iphone 16 128gb")`. Ответы площадок записаны в Chrome на машине владельца 17 ноября 2026 года в 01:29 UTC (аудит, цикл 1, запись [c1-iphone16-128gb.json](packages/compare-connector/tests/benchmark/recordings/c1-iphone16-128gb.json)) и пропущены через код `2.11.0` (коммит `f39a786f`). Ниже оставлены ключевые поля и по одному предупреждению каждого типа; полный ответ ещё содержит `source_outcomes` и все 25 предложений в `offers`.
- ```json
- {
- "query": "iphone 16 128gb",
- "sources_queried": [
- "aliexpress", "citilink", "dns",
- "taobao", "wildberries", "yandex_market"
- ],
- "sources_ok": [
- "aliexpress", "dns", "taobao", "wildberries", "yandex_market"
- ],
- "complete": false,
- "total_offers": 25,
- "cheapest": {
- "source": "aliexpress",
- "product_id": "1005009110731940",
- "title": "MOVESPEED флешка USB Type C 64/128/256/512 ГБ",
- "price_rub": 1531.0,
- "currency": "rub",
- "rating": 4.8,
- "url": "https://aliexpress.ru/item/1005009110731940.html"
- },
- "cheapest_comparable": {
- "source": "aliexpress",
- "product_id": "1005008110020734",
- "title": "Смартфон Apple iPhone 16, 8/128ГБ",
- "price_rub": 64990.0,
- "currency": "rub",
- "rating": 5.0,
- "url": "https://aliexpress.ru/item/1005008110020734.html"
- },
- "price_spread_rub": 93459.0,
- "warnings": [
- "partial: 1 of 6 marketplaces did not answer (citilink) ...",
- "conditional_price: wildberries/1415238452: 56833 RUB requires WB Wallet; not ranked",
- "info:conditional_price_available: yandex_market/103530694148: 72825 RUB with Yandex Pay",
- "price_outlier: the cheapest offer is 1531.0 ₽ against a median of 70299.0 ₽ across 17 offers ...",
- "comparable_price: the raw cheapest listing is an accessory, a different condition, variant or model; cheapest_comparable is the safer like-for-like candidate",
- "foreign_currency: 5 offer(s) are priced in cny, not roubles ... excluded from the ranking"
- ],
- "server_version": "2.11.0"
- }
- ```
- <details>
- <summary>Полный список <code>warnings</code> из этой записи (15 строк)</summary>
- ```json
- [
- "partial: 1 of 6 marketplaces did not answer (citilink) — prices below cover only aliexpress, dns, taobao, wildberries, yandex_market",
- "source_warning:aliexpress: 2 tile(s) advertise a coupon price; price_rub carries the regular price and the coupon value is not part of the response — treat 'cheapest' ranking with care",
- "source_warning:wildberries: dom_fallback: WB API refused this address (HTTP 403); read through the scraping Chrome, in the WB region set in that browser rather than dest",
- "source_warning:wildberries: wb_dom_search: price_rub is the WB Wallet price on search tiles (the regular card price is equal or a few % higher and shows only on the product page — verify leaders with wb_card)",
- "conditional_price: wildberries/1415238452: 56833 RUB requires WB Wallet; not ranked",
- "conditional_price: wildberries/580725150: 76922 RUB requires WB Wallet; not ranked",
- "conditional_price: wildberries/580725161: 76922 RUB requires WB Wallet; not ranked",
- "info:conditional_price_available: yandex_market/103572173063: 71800 RUB with Yandex Pay",
- "info:conditional_price_available: yandex_market/103530694148: 72825 RUB with Yandex Pay",
- "info:conditional_price_available: yandex_market/4775394349: 68107 RUB with Yandex Pay",
- "info:conditional_price_available: yandex_market/5302780524: 66699 RUB with Yandex Pay",
- "info:conditional_price_available: yandex_market/4775394347: 69323 RUB with Yandex Pay",
- "price_outlier: the cheapest offer is 1531.0 ₽ against a median of 70299.0 ₽ across 17 offers — check it is the same product and configuration",
- "comparable_price: the raw cheapest listing is an accessory, a different condition, variant or model; cheapest_comparable is the safer like-for-like candidate",
- "foreign_currency: 5 offer(s) are priced in cny, not roubles — their price is in price_native and they are excluded from the ranking and from cheapest"
- ]
- ```
- </details>
- Самым дешёвым формально оказалась флешка: в её названии есть «128». Поэтому ответ отдельно называет `cheapest_comparable`, то есть сам телефон, и предупреждает о выбросе цены. Цена Wildberries, которая действует только с WB Кошельком, показана, но в сравнении не участвует. Ситилинк в этом вызове ответил отказом, и ответ говорит, что он неполный.
- ## Подключение к MCP-клиенту
- Самый короткий путь — `uvx ru-marketplace-mcp setup` (или `uv run marketplace-mcp setup`
- из клона репозитория): команда находит установленные клиенты (**Claude Desktop**,
- **Cursor**, **Claude Code**, **VS Code**, **Windsurf**, **Antigravity**,
- **Gemini CLI**, **Codex CLI**), прописывает профиль `compare`, запускает
- отдельный Chrome для парсинга, проверяет источники через `doctor` и предлагает
- `unblock`, если площадка просит вход или капчу (`--dry-run` только показывает
- шаги и файлы; `--no-browser` и `--no-doctor` пропускают браузер и сетевые вызовы).
- Настроить один конкретный клиент (поддерживаются все **9 целей**):
- ```console
- uvx ru-marketplace-mcp install <client> --write --profile compare
- ```
- | Клиент (`<client>`) | Что обновляет `--write` |
- | --- | --- |
- | **Claude Desktop**<br>`claude` | `mcpServers.marketplace` в конфиге Claude Desktop + `.bak`; есть и `.mcpb` в [Releases](https://github.com/Vladimir-Human/ru-marketplace-mcp/releases) |
- | **Cursor**<br>`cursor` | `mcpServers.marketplace` в `~/.cursor/mcp.json` + `.bak` |
- | **VS Code**<br>`vscode` | **`servers.marketplace`** (`"type": "stdio"`) в `Code/User/mcp.json` + `.bak` |
- | **Windsurf**<br>`windsurf` | `mcpServers.marketplace` в конфиге Windsurf + `.bak` |
- | **Antigravity**<br>`antigravity` | `mcpServers.marketplace` в конфиге Antigravity + `.bak` |
- | **Gemini CLI**<br>`gemini` | `mcpServers.marketplace` в `~/.gemini/settings.json` + `.bak` |
- | **Claude Code**<br>`claude-code` | Печатает `claude mcp add marketplace --scope user -- ...` |
- | **Codex CLI**<br>`codex` | Печатает `codex mcp add marketplace -- ...` |
- | **DeepSeek Harness**<br>`dsh` | Печатает `cordis.patch.yml` (плагин — в спойлере и [dsh/README.md](dsh/README.md)) |
- <sub>Пути конфигов: **Claude Desktop** — `%APPDATA%\Claude\claude_desktop_config.json` (Win), `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS), `~/.config/Claude/claude_desktop_config.json` (Linux); **Windsurf** — `~/.codeium/windsurf/mcp_config.json`; **Antigravity** — `~/.gemini/config/mcp_config.json`. Перед записью создаётся копия `.bak-<метка>`.</sub>
- По умолчанию ставится профиль `compare` (`compare-mcp`). `--profile decision`
- переключает запись на `decision-mcp`, `--profile full` — на полный
- `marketplace-mcp` (при перезаписи существующей записи добавьте `--force`;
- `--write --dry-run` показывает дифф без записи; `--per-source` печатает или
- пишет отдельные серверы по площадкам и с `--profile` не сочетается). Неизвестное
- имя клиента команда отклоняет с кодом возврата `2`.
- Управление браузером и разблокировкой:
- - `marketplace-mcp browser start` — запустить отдельный Chrome для парсинга (по умолчанию окно видно, `--hidden` — за экраном);
- - `marketplace-mcp browser status` — доступен ли CDP, версия Chrome, вкладки и положение окна;
- - `marketplace-mcp browser show` — вывести окно на экран (на Windows автозапуск паркует его за экраном);
- - `marketplace-mcp unblock <source>` — открыть страницу входа или проверки в новой вкладке, подождать, пока вы пройдёте её сами, и перепроверить только этот источник (капчу за человека команды не решают).
- <details>
- <summary><b>Ручная настройка JSON и выбор площадок (<code>MARKETPLACE_SOURCES</code>)</b></summary>
- Для клиентов с `mcpServers` (Claude Desktop, Cursor, Windsurf, Antigravity, Gemini CLI, Cline, OpenCode) без клона репозитория:
- ```json
- {
- "mcpServers": {
- "marketplace": {
- "command": "uvx",
- "args": ["--from", "ru-marketplace-mcp", "compare-mcp"]
- }
- }
- }
- ```
- Для **VS Code** (`Code/User/mcp.json` использует корневой ключ `"servers"` и `"type": "stdio"`):
- ```json
- {
- "servers": {
- "marketplace": {
- "type": "stdio",
- "command": "uvx",
- "args": ["--from", "ru-marketplace-mcp", "compare-mcp"]
- }
- }
- }
- ```
- Из локального клона (пути с прямыми слешами `/` или двойными обратными `\\`):
- ```json
- {
- "mcpServers": {
- "marketplace": {
- "command": "uv",
- "args": ["run", "--directory", "C:/путь/к/ru-marketplace-mcp", "compare-mcp"]
- }
- }
- }
- ```
- Полный список из 15 консольных точек входа: `wb-mcp`, `ozon-mcp`, `yandex-mcp`,
- `detmir-mcp`, `avito-mcp`, `taobao-mcp`, `megamarket-mcp`, `lamoda-mcp`,
- `dns-mcp`, `citilink-mcp`, `aliexpress-mcp`, `cian-mcp`, `compare-mcp`,
- `decision-mcp`, `marketplace-mcp`. Все серверы общаются по JSON-RPC через stdin
- и stdout, а диагностику пишут в stderr.
- ### Только нужные площадки в полном режиме: `MARKETPLACE_SOURCES`
- Объединённый `marketplace-mcp` монтирует все источники сразу. Переменная
- `MARKETPLACE_SOURCES` оставляет только перечисленные и экономит контекст:
- ```json
- {
- "mcpServers": {
- "marketplace": {
- "command": "uv",
- "args": ["run", "--directory", "C:/путь/к/ru-marketplace-mcp", "marketplace-mcp"],
- "env": {
- "MARKETPLACE_SOURCES": "wildberries,ozon,yandex_market,avito,aliexpress,dns,compare"
- }
- }
- }
- }
- ```
- Имена канонические (`wildberries`, `ozon`, `yandex_market`, `detsky_mir`,
- `avito`, `taobao`, `megamarket`, `lamoda`, `dns`, `citilink`, `aliexpress`,
- `cian`, `compare`); короткие псевдонимы `wb`, `ym`/`yandex`, `detmir`, `ali`
- тоже принимаются. Опечатка в имени остановит старт сервера со списком допустимых
- площадок. Отключённые источники видны в `marketplace_sources` в поле `skipped`.
- `compare_prices` опрашивает только выбранные товарные источники с текстовым
- поиском (Детский мир и Циан туда не входят); явный `sources` для отключённой
- площадки вернёт `bad_request`.
- </details>
- <details>
- <summary><b>Claude Code</b> — плагин с 14 навыками или <code>claude mcp add</code></summary>
- Установка плагина (14 навыков + MCP) одной командой:
- ```text
- /plugin install ru-marketplace-mcp --marketplace Vladimir-Human/ru-marketplace-mcp
- ```
- Или подключение компактного профиля `compare-mcp` через CLI:
- ```bash
- claude mcp add marketplace --scope user -- uvx --from ru-marketplace-mcp compare-mcp
- ```
- </details>
- <details>
- <summary><b>DeepSeek Harness (dsh)</b> — плагин-бандл</summary>
- В dsh это не запись `mcpServers`, а слой профиля. Бандл лежит в подкаталоге
- [`dsh/`](dsh/README.md) и ставится штатным менеджером плагинов (`pnpm` нужен на PATH):
- ```console
- dsh plugin --profile web add ru-marketplace-mcp-dsh
- # или напрямую из GitHub:
- dsh plugin --profile web add github:Vladimir-Human/ru-marketplace-mcp#path:/dsh
- ```
- Сразу после установки появляются 14 навыков и **ни одного** MCP-инструмента: все три
- строки MCP выключены, пока не задана переменная `RU_MARKETPLACE_MCP_DIR` с путём к
- клону.
- <!-- tools-cost:start -->
- Так сделано потому, что смонтированный сервер платится в каждом запросе:
- рекомендуемый режим сравнения цен стоит ≈1.7k токенов, режим с инспекцией
- карточки — ≈2.0k, полный набор — ≈13.1k (оценка по `tools/list`;
- подробности в [docs/TOOLS.md](docs/TOOLS.md)).
- <!-- tools-cost:end -->
- Включение и полный режим описаны в [dsh/README.md](dsh/README.md).
- </details>
- После подключения перезапустите клиент и проверьте доступность источников
- командой `marketplace-mcp doctor` (подробнее в [docs/QUICKSTART.md](docs/QUICKSTART.md)):
- код `0` — выбранные проверки здоровы, `1` — дрейф парсера, `2` — площадка
- закрыта анти-ботом, ждёт Chrome/входа или лимита бюджета (`budget_refused`), `3` —
- не записался `--status-file`, `4` — сбой самой проверки или неверные аргументы.
- Тревогу поднимают коды `1` и `4`, а при `2` следуйте подсказке `next:` в выводе.
- ## Инструменты
- Сгенерированный справочник по инструментам с параметрами и ценой контекста:
- [docs/TOOLS.md](docs/TOOLS.md).
- Канарейки `*_selfcheck` в этом перечне не значатся намеренно: они не публикуются
- по MCP, потому что диагностика оператора стоила бы модели ~7,5 тыс. токенов в
- каждом запросе. Запускает их `marketplace-mcp doctor` — все разом, из командной
- строки.
- Подробно по каждой площадке, с таблицами инструментов и примерами, — в
- [docs/TOOLS.ru.md](docs/TOOLS.ru.md):
- - [Wildberries — `wb_*`](docs/TOOLS.ru.md#wildberries--wb_)
- - [Яндекс Маркет — `yandex_*`](docs/TOOLS.ru.md#яндекс-маркет--yandex_)
- - [Детский мир — `detmir_*`](docs/TOOLS.ru.md#детский-мир--detmir_)
- - [Ozon — `ozon_*`](docs/TOOLS.ru.md#ozon--ozon_)
- - [Авито — `avito_*`](docs/TOOLS.ru.md#авито--avito_)
- - [Taobao — `taobao_*`](docs/TOOLS.ru.md#taobao--taobao_)
- - [Мегамаркет, Lamoda, DNS, Ситилинк](docs/TOOLS.ru.md#мегамаркет-lamoda-dns-ситилинк)
- - [AliExpress — `aliexpress_*`](docs/TOOLS.ru.md#aliexpress--aliexpress_)
- - [Циан — `cian_*`](docs/TOOLS.ru.md#циан--cian_)
- - [Сравнение цен — `compare_*`](docs/TOOLS.ru.md#сравнение-цен--compare_)
- ## Навыки для агента
- У каждого коннектора — свой навык в `skills/`: четырнадцать штук, по одному
- на источник плюс общий `marketplace`. Навык это не пересказ README: он объясняет агенту, когда за этот
- источник вообще браться, чего у источника нет, и каким его ответам нельзя верить
- без второго взгляда.
- | Навык | Сервер |
- | ----------------------------- | ----------------- |
- | `skills/wb-connector` | `wb-mcp` |
- | `skills/ozon-connector` | `ozon-mcp` |
- | `skills/yandex-connector` | `yandex-mcp` |
- | `skills/detmir-connector` | `detmir-mcp` |
- | `skills/avito-connector` | `avito-mcp` |
- | `skills/taobao-connector` | `taobao-mcp` |
- | `skills/megamarket-connector` | `megamarket-mcp` |
- | `skills/lamoda-connector` | `lamoda-mcp` |
- | `skills/dns-connector` | `dns-mcp` |
- | `skills/citilink-connector` | `citilink-mcp` |
- | `skills/aliexpress-connector` | `aliexpress-mcp` |
- | `skills/cian-connector` | `cian-mcp` |
- | `skills/compare-prices` | `compare-mcp` |
- | `skills/marketplace` | `marketplace-mcp` |
- `mcp-core` — общий рантайм под остальными серверами. Своего навыка у него нет.
- Соответствие проверяется тестом
- ([test_skills_parity.py](packages/marketplace-connector/tests/test_skills_parity.py)): новый коннектор
- без навыка роняет прогон, как и навык, который называет несуществующий
- инструмент или забыл существующий. До этого теста навык DNS почти год советовал
- формат ссылки `/product/<24-hex>/` — тот самый шаблон, который чинили как баг.
- Скиллы едут в Docker-образ (`/app/skills/`), но в колёсах их нет: `skills/`
- лежит в корне репозитория. При установке release-wheel или пакета
- `ru-marketplace-mcp` с PyPI возьмите навыки из репозитория отдельно.
- ## Настройка
- Все параметры задаются переменными окружения с префиксом коннектора. Все
- необязательные.
- При проверке в браузере `CHROME_CHALLENGE_HANDOFF_S=120` придерживает открытую
- вкладку: когда вы пройдёте проверку, повтор того же запроса от того же клиента
- (в той же MCP-сессии или к тому же stdio-процессу сервера) дочитает эту вкладку
- без новой навигации. Поддержка и ограничения описаны в
- [настройке Chrome](docs/CDP_SETUP.md#optional-challenge-handoff).
- | Префикс | Основные параметры |
- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
- | `WB_` | `TIMEOUT`, `MIN_GAP`, `DEFAULT_DEST`, `NET_RETRIES`, `MAX_BODY_BYTES`, `CACHE_TTL`, `PROXY`, `TRANSPORT`, `DOM_FALLBACK` |
- | `YANDEX_` | `TIMEOUT`, `MIN_GAP`, `CACHE_TTL`, `PROXY` |
- | `DETMIR_` | `REGION` (`RU-MOW`, `RU-SPE` и другие), `CACHE_TTL`, `PROXY` |
- | `OZON_` | `TIMEOUT`, `MIN_GAP`, `IMPERSONATE`, `CACHE_TTL`, `PROXY`, `CHROME_COMPAT` |
- | `AVITO_` | `TIMEOUT`, `MIN_GAP`, `IMPERSONATE`, `CACHE_TTL`, `PROXY`, `LOCATION_ID` |
- | `TAOBAO_` | `TIMEOUT`, `MIN_GAP`, `CACHE_TTL` |
- | `ALI_` | `TIMEOUT`, `MIN_GAP`, `CACHE_TTL` |
- | `MEGAMARKET_` | `TIMEOUT`, `MIN_GAP`, `CACHE_TTL`, `USE_PROFILE_ADDRESS` (0/1, по умолчанию 0 — приватный список адресов профиля не читается; 1 = адрес по умолчанию из залогиненного профиля, цены «как видит оператор») |
- | `LAMODA_` | `TIMEOUT`, `MIN_GAP`, `CACHE_TTL`, `PROXY` |
- | `DNS_` / `CITILINK_` | `TIMEOUT`, `MIN_GAP`, `CACHE_TTL` |
- | `CIAN_` | `TIMEOUT`, `MIN_GAP`, `CACHE_TTL`, `MAX_BODY_BYTES`, `REGION` |
- | `CHROME_` | `CDP_HOST`, `CDP_PORT`, `SCRAPING_PROFILE`, `BINARY`, `HEADLESS`, `STEALTH`, `NAV_TIMEOUT_MS`, `CHALLENGE_HANDOFF_S` |
- | `COMPARE_` | `SOURCE_TIMEOUT` |
- | `MCP_` | `TRANSPORT` (`stdio` по умолчанию, либо `http`), `HTTP_HOST`, `HTTP_PORT` |
- `CHROME_CDP_HOST` указывает, куда дозвониться CDP-клиенту (по умолчанию
- `127.0.0.1`). Из контейнера ставьте `chrome` (сайдкар) или `host.docker.internal`
- — это открывает tier-2 источники (Ozon, Авито, Taobao, Мегамаркет, Lamoda,
- DNS, Ситилинк, AliExpress, Циан) в Docker без host networking. Подробности в
- [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md).
- `*_CACHE_TTL=0` выключает кэш. `*_PROXY` перекрывает стандартные `HTTPS_PROXY` и
- `ALL_PROXY` — свой префикс есть у шести коннекторов: `WB_`, `YANDEX_`, `DETMIR_`,
- `OZON_`, `AVITO_` и `LAMODA_`. У Taobao своего нет намеренно: поиск там
- подписан и ходит через собственный клиент. У Мегамаркета, DNS и Ситилинка тоже нет:
- их трафик идёт через ваш Chrome, а его egress — дело настроек браузера. Кэшируются
- только удачные ответы: запомнить сбой значило бы растянуть секундную помеху на весь
- TTL.
- У Ozon прокси применяется к первому уровню. Второй идёт через ваш собственный Chrome,
- и его трафик — дело настроек этого браузера.
- ## Разработка
- ```bash
- git clone https://github.com/Vladimir-Human/ru-marketplace-mcp.git
- cd ru-marketplace-mcp
- uv sync --all-packages
- uv run pytest -q -m "not live and not cdp" # офлайн-тесты, сеть не нужна (то, что гоняет CI)
- uv run pytest -q -m "not live and not cdp" --cov --cov-fail-under=80 # покрытие, порог 80% в CI
- uv run ruff check . && uv run ruff format --check .
- uv run mypy # что проверять — в [tool.mypy] files
- uv run mypy --platform win32 # ловит ошибки, видимые только на Windows
- uv run python scripts/check_no_print.py # запись в stdout ломает JSON-RPC
- uv run python scripts/check_versions.py # единая версия во всех отслеживаемых файлах
- ```
- Публикация на PyPI (для владельца): [DEPLOYMENT.md — PyPI](docs/DEPLOYMENT.md#pypi-maintainer). Справочник по устройству добавления коннектора — [docs/ADDING_A_SOURCE.md](docs/ADDING_A_SOURCE.md).
- Проверка живого эндпоинта:
- ```bash
- uv run python -c "
- import asyncio
- from wb_connector.server import wb_selfcheck
- print(asyncio.run(wb_selfcheck()).status) # ждём success
- "
- ```
- Часть тестов прогоняет **настоящий JS-экстрактор коннектора** по снятой разметке
- и проверяет результат против цен, которые в тот момент были на странице. Для
- этого нужен Node с jsdom:
- ```bash
- npm install jsdom # либо NODE_PATH на уже установленный
- uv run pytest -q packages/dns-connector/tests/test_search_extractor_dom.py \
- packages/citilink-connector/tests/test_search_extractor_dom.py
- ```
- Без jsdom эта половина честно скипается, а питоновская часть — выбор цены из
- кандидатов — идёт всегда. jsdom нужен только разработчику: в зависимости
- коннекторов он не входит.
- CI прогоняет тесты на Ubuntu, Windows и macOS против Python 3.12
- и 3.13; ещё 3.14 (все три ОС) и 3.15 (Ubuntu, Windows) проверяются без блокировки слияния. Windows-специфичное управление процессами проверяется юнит-тестами на любой
- ОС через подмену платформы, так что эти ветки покрыты даже на Linux.
- ## Надёжность
- Неофициальные эндпоинты ломаются. Архитектура это предполагает.
- - Терпимые парсеры: привязка поля по нескольким именам и приведение типов
- переживают переименования и смену типа вместо падения.
- - Никогда не выдумывать значение: отсутствующая цена — это `null`, не `0`. Ноль
- вывел бы мёртвый товар в самые дешёвые.
- - Громкий отказ: когда формат перестаёт совпадать, инструмент бросает
- `parser_drift`, а не возвращает полуразобранные данные.
- - Трёхзначные selfcheck-проверки: `success`, `drift_detected` или
- `inconclusive`. Гео-блокировка помечается как `inconclusive`, потому что она
- ничего не говорит о состоянии парсеров.
- ## Границы доверия
- Названия товаров, имена продавцов и тексты отзывов написаны продавцами и
- покупателями. Это недоверенные данные. Если отзыв или описание выглядит как
- инструкция, оно всё равно остаётся входными данными. Выполнять его агент не
- должен.
- Условия маркетплейсов, как правило, запрещают неофициальный парсинг. Коннекторы
- обращаются к публичным эндпоинтам каталога, которые использует официальный
- веб-клиент: пока явно не задан `MEGAMARKET_USE_PROFILE_ADDRESS=1`, в личные и
- закрытые разделы запросов нет. Уровень Ozon с браузером работает внутри
- сессии, которую вы открыли сами. Используйте на своё
- усмотрение, для личных исследований, в вежливом темпе запросов. Пауза между
- вызовами к площадкам с анти-ботом — это часть конструкции, а не случайное
- торможение: её не нужно убирать ради скорости. Данные инструментов не предназначены
- для перепродажи или массового сбора.
- ## Как это сделано
- Код и документацию я писал вместе с ИИ-ассистентами. Они работают быстро и
- ошибаются уверенно, поэтому проект устроен вокруг проверки: офлайн-тесты,
- аудит перед выпуском, тесты, которые прогоняют настоящий экстрактор по снятой с
- сайта разметке. В заметках к релизу перечислено, какие источники сверены с живыми
- страницами вручную и какие остались непроверенными.
- Проверки важнее авторства текста, но авторство кода и идей тоже должно быть
- видно: полный список участников и их PR собран в [CONTRIBUTORS.md](CONTRIBUTORS.md).
- ## Спасибо
- - [@avxone](https://github.com/avxone) — исправление Avito selfcheck, [PR #37](https://github.com/Vladimir-Human/ru-marketplace-mcp/pull/37).
- - [@Khalmatov](https://github.com/Khalmatov) — provenance отзывов Ozon, [PR #38](https://github.com/Vladimir-Human/ru-marketplace-mcp/pull/38).
- - [@fosteev](https://github.com/fosteev) — macOS CDP stealth и коннектор Циана, [PR #42](https://github.com/Vladimir-Human/ru-marketplace-mcp/pull/42), [PR #47](https://github.com/Vladimir-Human/ru-marketplace-mcp/pull/47).
- - [@ilodezis](https://github.com/ilodezis) — выбор источников unified-сервера через `MARKETPLACE_SOURCES`, [PR #48](https://github.com/Vladimir-Human/ru-marketplace-mcp/pull/48).
- - [@HeckfyCU](https://github.com/HeckfyCU) — замеры навигации AliExpress в [issue #190](https://github.com/Vladimir-Human/ru-marketplace-mcp/issues/190): по его замерам найден и исправлен предел ожидания страницы.
- - [@XaruStar](https://github.com/XaruStar) — разбор живого ответа Ozon `webListReviews` со строковым `itemId`, [issue #214](https://github.com/Vladimir-Human/ru-marketplace-mcp/issues/214): по нему исправлен учёт `own_reviews` и проверка `item_id` в `ozon_selfcheck`.
- ## Лицензия
- MIT, файл [LICENSE](LICENSE).
scripts/routing_eval.py · Bundled script · 90 lines
- """Deterministic DSH routing contract evaluation.
- This is a model-facing acceptance fixture: route selection must send explicit
- cross-market price requests to ``compare-prices`` and full-mount/setup requests
- to ``marketplace`` while leaving single-source requests to that source skill.
- It intentionally tests both positive and negative examples and emits JSON for CI.
- """
- from __future__ import annotations
- import argparse
- import json
- from dataclasses import dataclass
- from pathlib import Path
- @dataclass(frozen=True)
- class Case:
- query: str
- expected: str
- should_not: tuple[str, ...] = ()
- CASES = (
- Case("где дешевле купить iphone 15", "compare-prices", ("marketplace", "wb-connector")),
- Case("сравни цены на стиральную машину", "compare-prices", ("marketplace",)),
- Case("сколько стоит на вайлдберриз", "wb-connector", ("compare-prices",)),
- Case("отзывы на озоне", "ozon-connector", ("compare-prices",)),
- Case("покажи все источники и настрой marketplace", "marketplace", ("compare-prices",)),
- Case("marketplace_sources", "marketplace", ("compare-prices",)),
- )
- def route(query: str) -> str:
- q = query.casefold()
- if any(
- token in q for token in ("где дешевле", "сравни цены", "сравнить цены", "самую низкую цену", "compare prices")
- ):
- return "compare-prices"
- if any(token in q for token in ("marketplace_sources", "все источники", "настрой marketplace", "full marketplace")):
- return "marketplace"
- for source, tokens in {
- "wb-connector": ("вайбeрриз", "wildberries", "на wb", "на вайлдберриз"),
- "ozon-connector": ("озон", "ozon"),
- "yandex-connector": ("яндекс маркет", "на яндекс"),
- }.items():
- if any(token in q for token in tokens):
- return source
- return "marketplace"
- def evaluate(cases: tuple[Case, ...] = CASES) -> dict[str, object]:
- rows = []
- for case in cases:
- actual = route(case.query)
- passed = actual == case.expected and actual not in case.should_not
- rows.append(
- {
- "query": case.query,
- "expected": case.expected,
- "actual": actual,
- "passed": passed,
- "forbidden": list(case.should_not),
- }
- )
- passed = sum(1 for row in rows if row["passed"])
- return {
- "version": 1,
- "total": len(rows),
- "passed": passed,
- "accuracy": passed / len(rows) if rows else 1.0,
- "ok": passed == len(rows),
- "cases": rows,
- }
- def main() -> int:
- parser = argparse.ArgumentParser(description=__doc__)
- parser.add_argument("--json-out", type=Path)
- args = parser.parse_args()
- report = evaluate()
- print(json.dumps(report, ensure_ascii=False, indent=2))
- if args.json_out:
- args.json_out.parent.mkdir(parents=True, exist_ok=True)
- args.json_out.write_text(json.dumps(report, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
- return 0 if report["ok"] else 1
- if __name__ == "__main__":
- raise SystemExit(main())
scripts/test_build_changelog.py · Bundled script · 410 lines
- """R-CHANGELOG-FRAGMENTS: temporary-tree folding, in-memory PR/Markdown and CI checks.
- The Markdown below is deliberately hand-written release input, not captured marketplace
- content. No transport, clock, filesystem or subprocess is faked or monkeypatched.
- """
- from __future__ import annotations
- import re
- import shutil
- import subprocess
- import sys
- from pathlib import Path
- import pytest
- sys.path.insert(0, str(Path(__file__).resolve().parent))
- import build_changelog as builder
- OLD_RELEASE = "## [2.9.3] - 2026-11-15\n\n### Fixed\n- Старое.\n- Old.\n"
- HEADER = "# Changelog\n\nРусский первый, английский ниже.\n\n## [Unreleased]\n\n"
- ENTRY = "### Fixed\n- Исправлено (#12).\n- Fixed (#12).\n"
- RELEASE_ARGS = ["--version", "3.0.0", "--date", "2026-11-16"]
- def _tree(tmp_path: Path, hand: str = "") -> Path:
- (tmp_path / "CHANGELOG.md").write_text(HEADER + hand + OLD_RELEASE, encoding="utf-8", newline="\n")
- (tmp_path / "changes").mkdir()
- (tmp_path / "changes" / ".gitkeep").write_bytes(b"")
- return tmp_path
- def _fragment(root: Path, name: str = "12.md", text: str = ENTRY) -> Path:
- path = root / "changes" / name
- path.write_text(text, encoding="utf-8", newline="\n")
- return path
- def _snapshot(root: Path) -> dict[str, bytes]:
- return {path.relative_to(root).as_posix(): path.read_bytes() for path in root.rglob("*") if path.is_file()}
- # START_BLOCK_RELEASE_TESTS
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.dry-run", "R-CHANGELOG-FRAGMENTS.fold")
- def test_two_fragments_fold_in_section_and_numeric_pr_order(tmp_path: Path) -> None:
- root = _tree(tmp_path)
- _fragment(
- root, "100.md", "### Fixed\n- Сто (#100).\n- Hundred (#100).\n\n### Added\n- Новое (#100).\n- New (#100).\n"
- )
- _fragment(
- root,
- "12.md",
- "### Fixed\n- Двенадцать (#12).\n- Twelve (#12).\n\n### Security\n- Защита (#12).\n- Security (#12).\n",
- )
- assert builder.main(RELEASE_ARGS, root=root) == 0
- expected = (
- "## [3.0.0] - 2026-11-16\n\n"
- "### Added\n- Новое (#100).\n- New (#100).\n\n"
- "### Fixed\n- Двенадцать (#12).\n- Twelve (#12).\n\n- Сто (#100).\n- Hundred (#100).\n\n"
- "### Security\n- Защита (#12).\n- Security (#12).\n\n"
- )
- assert (root / "CHANGELOG.md").read_text(encoding="utf-8") == HEADER + expected + OLD_RELEASE
- assert list((root / "changes").iterdir()) == [root / "changes" / ".gitkeep"]
- assert b"\r" not in (root / "CHANGELOG.md").read_bytes()
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.fold")
- def test_hand_text_is_preserved_before_fragment_entries(tmp_path: Path) -> None:
- hand = "Заметка вручную.\nManual note.\n\n### Fixed\n- Ручное.\n- Manual.\n\n"
- root = _tree(tmp_path, hand)
- _fragment(root)
- assert builder.main(RELEASE_ARGS, root=root) == 0
- text = (root / "CHANGELOG.md").read_text(encoding="utf-8")
- assert text.startswith(HEADER + "## [3.0.0] - 2026-11-16\n\n" + hand + "- Исправлено (#12).\n- Fixed (#12).\n\n")
- assert text.count("### Fixed") == 2 # one new section, one untouched old release
- assert text.endswith(OLD_RELEASE)
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.fold")
- def test_all_keep_a_changelog_sections_use_the_standard_order(tmp_path: Path) -> None:
- root = _tree(tmp_path)
- sections = ["Added", "Changed", "Deprecated", "Removed", "Fixed", "Security"]
- _fragment(
- root, text="\n".join(f"### {section}\n- RU {section}.\n- EN {section}.\n" for section in reversed(sections))
- )
- assert builder.main(RELEASE_ARGS, root=root) == 0
- text = (root / "CHANGELOG.md").read_text(encoding="utf-8").split(OLD_RELEASE)[0]
- positions = [text.index(f"### {section}") for section in sections]
- assert positions == sorted(positions)
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.dry-run")
- def test_dry_run_prints_the_same_section_and_touches_nothing(
- tmp_path: Path, capsys: pytest.CaptureFixture[str]
- ) -> None:
- root = _tree(tmp_path, "Ручной текст.\nHand text.\n\n")
- _fragment(root)
- before = _snapshot(root)
- assert builder.main([*RELEASE_ARGS, "--dry-run"], root=root) == 0
- section = capsys.readouterr().out
- assert section.startswith("## [3.0.0] - 2026-11-16\n\nРучной текст.\nHand text.\n\n### Fixed\n")
- assert ENTRY in section
- assert _snapshot(root) == before
- assert builder.main(RELEASE_ARGS, root=root) == 0
- assert (root / "CHANGELOG.md").read_text(encoding="utf-8") == HEADER + section + "\n" + OLD_RELEASE
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.validation")
- @pytest.mark.parametrize(
- ("text", "line"),
- [
- ("### Unknown\n- Entry.\n", 1),
- ("### Added\nOnly prose.\n", 1),
- ("### Added\n- Entry.\n## [3.0.0]\n", 3),
- ("### Added\n- Entry.\n\n### Fixed\n", 4),
- ("", 1),
- ("- No section.\n", 1),
- ],
- )
- def test_bad_fragment_names_the_file_and_line_without_writing(
- tmp_path: Path, capsys: pytest.CaptureFixture[str], text: str, line: int
- ) -> None:
- root = _tree(tmp_path)
- _fragment(root, "1.md") # a valid earlier fragment must not be consumed on failure
- _fragment(root, "12.md", text)
- before = _snapshot(root)
- assert builder.main(RELEASE_ARGS, root=root) == 1
- assert f"changes/12.md:{line}:" in capsys.readouterr().err
- assert _snapshot(root) == before
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.fold", "R-CHANGELOG-FRAGMENTS.validation")
- def test_odd_bullet_counts_and_continuations_are_kept(tmp_path: Path) -> None:
- root = _tree(tmp_path)
- fragment = "### Changed\n- Нечётная заметка (#12).\n continuation with `code`.\n - nested detail\n"
- _fragment(root, text=fragment)
- assert builder.main(RELEASE_ARGS, root=root) == 0
- assert fragment in (root / "CHANGELOG.md").read_text(encoding="utf-8")
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.validation")
- @pytest.mark.parametrize("dry_run", [False, True])
- def test_an_existing_version_is_refused_without_writing(
- tmp_path: Path, capsys: pytest.CaptureFixture[str], dry_run: bool
- ) -> None:
- root = _tree(tmp_path)
- _fragment(root)
- before = _snapshot(root)
- args = ["--version", "2.9.3", *(["--dry-run"] if dry_run else [])]
- assert builder.main(args, root=root) == 1
- assert "2.9.3" in capsys.readouterr().err
- assert _snapshot(root) == before
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.dry-run")
- def test_no_fragments_builds_an_empty_section(tmp_path: Path, capsys: pytest.CaptureFixture[str]) -> None:
- root = _tree(tmp_path)
- assert builder.main([*RELEASE_ARGS, "--dry-run"], root=root) == 0
- assert capsys.readouterr().out == "## [3.0.0] - 2026-11-16\n"
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.validation")
- @pytest.mark.parametrize("name", ["oops.md", "0.md"])
- def test_non_pr_fragment_names_are_refused(tmp_path: Path, capsys: pytest.CaptureFixture[str], name: str) -> None:
- root = _tree(tmp_path)
- _fragment(root, name)
- before = _snapshot(root)
- assert builder.main(RELEASE_ARGS, root=root) == 1
- assert name in capsys.readouterr().err
- assert _snapshot(root) == before
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.validation")
- @pytest.mark.parametrize("args", [["--version", "1.2"], ["--version", "1.2.3", "--date", "2026-02-30"]])
- def test_bad_release_arguments_are_refused(tmp_path: Path, args: list[str]) -> None:
- root = _tree(tmp_path)
- before = _snapshot(root)
- assert builder.main(args, root=root) == 1
- assert _snapshot(root) == before
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.validation")
- def test_missing_unreleased_heading_is_refused(tmp_path: Path, capsys: pytest.CaptureFixture[str]) -> None:
- root = _tree(tmp_path)
- (root / "CHANGELOG.md").write_text("# Changelog\n\n" + OLD_RELEASE, encoding="utf-8", newline="\n")
- before = _snapshot(root)
- assert builder.main(RELEASE_ARGS, root=root) == 1
- assert "Unreleased" in capsys.readouterr().err
- assert _snapshot(root) == before
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.fold")
- @pytest.mark.parametrize("fence", ["```", "~~~~"])
- def test_fenced_manual_headings_stay_inside_their_example(fence: str) -> None:
- """R-CHANGELOG-FRAGMENTS.fold: Markdown examples must not split or reorder hand text."""
- hand = f"### Fixed\n- Ручное.\n- Manual.\n\n{fence}markdown\n## Migration details\n### Added\n- Example only.\n{fence}\n\n"
- fragment = "### Added\n- Новое.\n- New.\n"
- section, updated = builder.build_release(
- HEADER + hand + OLD_RELEASE, [("changes/12.md", fragment)], "3.0.0", "2026-11-16"
- )
- expected = "## [3.0.0] - 2026-11-16\n\n" + fragment + "\n" + hand.rstrip("\n") + "\n"
- assert section == expected
- assert updated == HEADER + expected + "\n" + OLD_RELEASE
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.validation")
- @pytest.mark.parametrize("fence", ["```", "~~~~"])
- def test_fenced_fragment_examples_are_not_headings_or_top_level_bullets(fence: str) -> None:
- """R-CHANGELOG-FRAGMENTS.validation: literal code is neither a section nor a bullet."""
- example = f"{fence}markdown\n# comment\n## Example\n### Added\n- Example only.\n{fence}\n"
- text = "### Changed\n- Изменено.\n- Changed.\n\n" + example
- assert builder.parse_fragment(text, "changes/12.md") == {"Changed": text.split("\n", 1)[1].rstrip("\n")}
- with pytest.raises(ValueError, match=r"changes/12\.md:1:.*bullet"):
- builder.parse_fragment(f"### Changed\n{fence}\n- Example only.\n{fence}\n", "changes/12.md")
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.pr", "R-CHANGELOG-FRAGMENTS.validation")
- @pytest.mark.parametrize("mode", ["release", "pr"])
- def test_invalid_utf8_fragment_reports_its_name_and_line(
- tmp_path: Path, capsys: pytest.CaptureFixture[str], mode: str
- ) -> None:
- """R-CHANGELOG-FRAGMENTS.validation: decoding errors retain actionable diagnostics."""
- root = _tree(tmp_path)
- (root / "changes" / "12.md").write_bytes(b"### Fixed\n- \xff\n")
- changed = root / "changed-paths"
- changed.write_bytes(b"packages/demo/file\0changes/12.md\0")
- before = _snapshot(root)
- args = (
- RELEASE_ARGS
- if mode == "release"
- else [
- "--check-pr",
- "--pr-number",
- "12",
- "--changed-files",
- str(changed),
- "--labels",
- "[]",
- "--author",
- "contributor",
- ]
- )
- assert builder.main(args, root=root) == 1
- error = capsys.readouterr().err
- assert "changes/12.md:2:" in error
- if mode == "pr":
- assert "no-changelog" in error and len(error.splitlines()) == 1
- assert _snapshot(root) == before
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.validation")
- @pytest.mark.parametrize("indent", ["", " ", " ", " "])
- @pytest.mark.parametrize("marker", ["-", "+", "*"])
- def test_top_level_bullet_indentation_uses_markdown_rules(indent: str, marker: str) -> None:
- """R-CHANGELOG-FRAGMENTS.validation: up to three spaces is still a top-level list."""
- body = f"{indent}{marker} RU.\n{indent}{marker} EN."
- assert builder.parse_fragment("### Fixed\n" + body + "\n", "changes/12.md") == {"Fixed": body}
- with pytest.raises(ValueError, match=r"changes/12\.md:1:.*bullet"):
- builder.parse_fragment(f"### Fixed\n {marker} Only indented code.\n", "changes/12.md")
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.fold", "R-CHANGELOG-FRAGMENTS.validation")
- @pytest.mark.parametrize("fence", ["```", "~~~~"])
- def test_fences_in_list_items_keep_their_literal_headings(fence: str) -> None:
- """R-CHANGELOG-FRAGMENTS.fold/validation: a list-item example is not a new section."""
- body = f"- RU.\n- EN.\n- {fence}markdown\n ### Added\n - example\n {fence}"
- assert builder.parse_fragment("### Changed\n" + body + "\n", "changes/12.md") == {"Changed": body}
- section, _ = builder.build_release(
- HEADER + "### Changed\n" + body + "\n\n" + OLD_RELEASE, [], "3.0.0", "2026-11-16"
- )
- assert section == "## [3.0.0] - 2026-11-16\n\n### Changed\n" + body + "\n"
- # END_BLOCK_RELEASE_TESTS
- # START_BLOCK_PR_TESTS
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.pr")
- @pytest.mark.parametrize(
- ("paths", "labels", "author", "fragment", "passes"),
- [
- (["docs/guide.md", "packages-other/file"], [], "contributor", None, True),
- (["packages/demo/file"], [], "dependabot[bot]", None, True),
- (["packages/demo/file"], ["no-changelog"], "contributor", None, True),
- (["packages/demo/file", "changes/12.md"], [], "contributor", ENTRY, True),
- (["packages/demo/file"], [], "contributor", None, False),
- (["packages/demo/file", "changes/13.md"], [], "contributor", ENTRY, False),
- (["packages/demo/file", "changes/12.md"], [], "contributor", "### Wrong\n- Entry.\n", False),
- (["packages/demo/file", "changes/12.md"], [], "contributor", None, False),
- (["packages/demo/file"], ["No-changelog"], "dependabot", None, False),
- ],
- )
- def test_pure_pr_decision_branches(
- paths: list[str], labels: list[str], author: str, fragment: str | None, passes: bool
- ) -> None:
- problem = builder.check_pr(12, paths, labels, author, fragment)
- assert (problem is None) == passes
- if not passes:
- assert problem is not None
- assert "changes/12.md" in problem and "no-changelog" in problem
- assert "\n" not in problem
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.pr")
- @pytest.mark.parametrize(
- ("paths", "labels", "author", "fragment", "expected"),
- [
- (["docs/guide.md"], "[]", "contributor", None, 0),
- (["packages/demo/file"], "[]", "dependabot[bot]", None, 0),
- (["packages/demo/file"], '["no-changelog"]', "contributor", None, 0),
- (["packages/demo/file", "changes/12.md"], "[]", "contributor", ENTRY, 0),
- (["packages/demo/file"], "[]", "contributor", None, 1),
- (["packages/demo/file", "changes/13.md"], "[]", "contributor", ENTRY, 1),
- (["packages/demo/file", "changes/12.md"], "[]", "contributor", "### Fixed\nNo bullet.\n", 1),
- ],
- )
- def test_check_pr_cli_inputs(
- tmp_path: Path,
- capsys: pytest.CaptureFixture[str],
- paths: list[str],
- labels: str,
- author: str,
- fragment: str | None,
- expected: int,
- ) -> None:
- root = _tree(tmp_path)
- if fragment is not None:
- _fragment(root, "13.md" if "changes/13.md" in paths else "12.md", fragment)
- changed = root / "changed-paths"
- # git diff -z keeps spaces, Unicode and even newlines inside a path intact.
- changed.write_bytes(("\0".join([*paths, "docs/имя с\nпереносом.md"]) + "\0").encode("utf-8"))
- before = _snapshot(root)
- code = builder.main(
- ["--check-pr", "--pr-number", "12", "--changed-files", str(changed), "--labels", labels, "--author", author],
- root=root,
- )
- assert code == expected
- output = capsys.readouterr()
- if expected:
- assert "changes/12.md" in output.err and "no-changelog" in output.err
- assert len(output.err.splitlines()) == 1
- assert _snapshot(root) == before
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.dry-run")
- def test_real_cli_uses_its_copied_tree(tmp_path: Path) -> None:
- root = _tree(tmp_path)
- _fragment(root)
- scripts = root / "scripts"
- scripts.mkdir()
- script = scripts / "build_changelog.py"
- shutil.copyfile(builder.__file__, script)
- before = _snapshot(root)
- result = subprocess.run(
- [sys.executable, str(script), *RELEASE_ARGS, "--dry-run"],
- cwd=root,
- capture_output=True,
- text=True,
- encoding="utf-8",
- )
- assert result.returncode == 0, result.stdout + result.stderr
- assert ENTRY in result.stdout
- assert _snapshot(root) == before
- # END_BLOCK_PR_TESTS
- # START_BLOCK_WORKFLOW_TESTS
- def _assert_ci_fragment_step(text: str) -> None:
- trigger = re.search(r"^ pull_request:\n(.*?)(?=^ \S)", text, re.M | re.S)
- assert trigger is not None
- assert "types: [opened, synchronize, reopened, labeled, unlabeled]" in trigger.group(1)
- lint = re.search(r"^ lint:\n(.*?)(?=^ \S)", text, re.M | re.S)
- assert lint is not None
- body = lint.group(1)
- assert "fetch-depth: 0" in body
- step = body[body.rindex(" - name:") :]
- assert step.startswith(" - name: CHANGELOG fragment\n")
- assert "if: github.event_name == 'pull_request'" in step
- assert 'git diff --name-only --no-renames -z "$PR_BASE_SHA...$PR_HEAD_SHA"' in step
- assert "--check-pr" in step and "build_changelog.py" in step
- for source in ("number", "base.sha", "head.sha", "labels.*.name", "user.login"):
- assert f"github.event.pull_request.{source}" in step
- for option in ("--pr-number", "--changed-files", "--labels", "--author"):
- assert option in step
- @pytest.mark.req("R-CHANGELOG-FRAGMENTS.pr")
- def test_ci_fragment_step_and_label_events() -> None:
- """The workflow gathers git/PR inputs only and reruns the final lint step for labels."""
- workflow = Path(__file__).resolve().parent.parent / ".github" / "workflows" / "ci.yml"
- _assert_ci_fragment_step(workflow.read_text(encoding="utf-8"))
- # END_BLOCK_WORKFLOW_TESTS
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.