MCP 服务器

parsee-mcp

MCP server that enables AI assistants to interact with the PARSE app for collecting and monitoring products on Ozon and Wildberries, with tools for search, parsing, group management, analytics, and scheduling.

README

ПАРСИ · MCP

Подключение ИИ-ассистента к ПАРСИ — приложению для сбора и мониторинга товаров на Ozon и Wildberries.

После подключения ассистент (Claude, Kimi, Cursor и любой другой с поддержкой MCP) умеет искать товары, запускать сбор, читать собранные данные, вести группы мониторинга и сравнения, считать СПП и ставить проверки по расписанию — по-человечески, без кнопок и таблиц.

Обязательное условие

Нужно установленное и запущенное приложение ПАРСИ — parsee.ru

Это не прихоть, а устройство продукта: сервер MCP входит в состав приложения и слушает только 127.0.0.1. Сбор идёт с компьютера продавца и под его сессиями Ozon и Wildberries — так устроена защита от блокировок маркетплейсов. Отдельно, без приложения, подключаться просто не к чему: порт закрыт, ключа не существует.

Проверить, что всё на месте:

curl http://127.0.0.1:7317/health

Ответ {"ok":true,"name":"parsee-mcp"} означает, что приложение запущено и готово. Если ответа нет — откройте ПАРСИ.

Подключение

Ключ доступа выдаёт само приложение: Подключение ИИ → строка вида psk_…. Ключ локальный, никуда не отправляется, отзывается одной кнопкой.

Claude Code

claude mcp add parsee --transport http http://127.0.0.1:7317/mcp --header "Authorization: Bearer ВАШ_КЛЮЧ"

Claude Desktop, Kimi, Cursor и другие

{
  "mcpServers": {
    "parsee": {
      "url": "http://127.0.0.1:7317/mcp",
      "headers": { "Authorization": "Bearer ВАШ_КЛЮЧ" }
    }
  }
}

При подключении сервер сам отдаёт ассистенту инструкцию: порядок работы, чем отличаются группы, чего делать нельзя. Отдельно её можно перечитать инструментом parsee_help.

Что умеет ассистент

28 инструментов, 15 из них только читают данные. Полный машиночитаемый список — tools.json.

Найти и собрать

Инструмент	Что делает
`parsee_browser_search`	Поиск словами. Отдаёт только ссылки — ни цен, ни рейтинга
`parsee_parse_category`	Категория, выдача, бренд или продавец целиком — одной ссылкой
`parsee_parse_urls`	Сбор карточек по списку ссылок или артикулов
`parsee_wait`	Дождаться конца сбора и только потом ответить
`parsee_get_results`	Прочитать собранное: цена, цена с картой, рейтинг, отзывы, наличие
`parsee_export`	Выгрузить в Excel, CSV, JSON или ZIP

Группы

Инструмент	Что делает
`parsee_list_groups`	Все группы: мониторинг, сравнение, СПП
`parsee_create_group`	Создать группу и сразу наполнить
`parsee_add_to_group` / `parsee_remove_from_group`	Дополнить или почистить
`parsee_rename_group` / `parsee_delete_group`	Переименовать, удалить (только с подтверждением)
`parsee_run_check`	Проверить группу сейчас

Аналитика

Инструмент	Что делает
`parsee_get_prices`	Цены по группе: витрина и цена с картой
`parsee_monitor_changes`	Что изменилось с прошлой проверки: цена, наличие, схема, рейтинг
`parsee_compare_diff`	Моя карточка против конкурента — кто дешевле
`parsee_spp_changes`	Где сдвинулась скидка постоянного покупателя
`parsee_price_history`	Как менялась цена товара

Настройка

Инструмент	Что делает
`parsee_status`	Что происходит сейчас, сколько собрано
`parsee_get_options` / `parsee_set_options`	Фото, отзывы, характеристики, режим скорости
`parsee_get_region` / `parsee_set_region`	Город, из которого смотрятся цены — они разные по стране
`parsee_get_schedule` / `parsee_set_schedule`	Запуск по дням недели или каждые N часов
`parsee_wb_cabinet`	Цены, переданные площадке — основа расчёта СПП
`parsee_stop`	Остановить сбор

Как ассистенту работать правильно

parsee_status — не идёт ли уже сбор.
parsee_set_options — выключить фото и отзывы, если нужна только цена: сбор идёт в разы быстрее.
parsee_parse_category — взять рынок целиком. Либо parsee_browser_search, если нужен поиск словами.
parsee_wait — дождаться конца, а не опрашивать статус в цикле.
parsee_get_results — прочитать данные и только теперь делать выводы.

Главное правило: выдача поиска — это не данные. В ней нет ни точных цен, ни рейтинга, ни наличия. Выводы делаются по собранным карточкам.

Безопасность

Сервер слушает только 127.0.0.1 — снаружи недоступен.
Ключ обязателен на каждом запросе и сравнивается за постоянное время.
Встроенный браузер ходит только на ozon.ru и wildberries.ru — белый список.
Кабинет продавца ассистенту недоступен: переданные цены приложение читает само, по ключу, который вводит владелец.
Удаление групп — только после явного подтверждения пользователя.
Каждое действие видно в журнале приложения, в реальном времени.

Облачный сервер: справка + удалённый доступ

В репозитории есть server.py — один сервер, два режима на одном адресе (https://parsee-mcp.fastmcp.app/mcp):

Без ключа — справка: parsee_cloud_about, parsee_cloud_setup, parsee_cloud_tools, parsee_cloud_manual. Данных продавца здесь нет, сервер ничего не собирает — только рассказывает, что такое ПАРСИ и как подключиться. Приставка parsee_cloud_ не даёт модели спутать эти инструменты с настоящими.
С Bearer-ключом удалённого доступа — работают настоящие 28 инструментов (parsee_*, без cloud_). Ключ выдаёт приложение (окно «Подключить ИИ» → «Удалённый доступ»). Каждый вызов пересылается на relay.parsee.ru, тот держит связь с приложением на компьютере продавца и выполняет команду там же — теми же функциями, что и обычный локальный сбор. Без ключа эти инструменты отвечают понятной ошибкой, а не выдумывают данные.

Так ассистенту не нужно выбирать, какой из двух адресов добавлять — сервер один, дальше решает наличие ключа.

Ссылки

Приложение: parsee.ru
Инструкция для моделей: llms.txt
Каталог инструментов: tools.json
Манифест реестра: server.json