Parsee MCP Server

ПАРСИ · 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.

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

Группы

Аналитика

Настройка

---

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

1. parsee_status — не идёт ли уже сбор.
2. parsee_set_options — выключить фото и отзывы, если нужна только цена: сбор идёт в разы быстрее.
3. parsee_parse_category — взять рынок целиком. Либо parsee_browser_search, если нужен поиск словами.
4. parsee_wait — дождаться конца, а не опрашивать статус в цикле.
5. 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