{
  "markdown": "# ПАРСИ · MCP\n\nПодключение ИИ-ассистента к **ПАРСИ** — приложению для сбора и мониторинга товаров на Ozon и Wildberries.\n\nПосле подключения ассистент (Claude, Kimi, Cursor и любой другой с поддержкой MCP) умеет искать товары, запускать сбор, читать собранные данные, вести группы мониторинга и сравнения, считать СПП и ставить проверки по расписанию — по-человечески, без кнопок и таблиц.\n\n---\n\n## Обязательное условие\n\n**Нужно установленное и запущенное приложение ПАРСИ** — [parsee.ru](https://parsee.ru)\n\nЭто не прихоть, а устройство продукта: сервер MCP входит в состав приложения и слушает только `127.0.0.1`. Сбор идёт **с компьютера продавца и под его сессиями** Ozon и Wildberries — так устроена защита от блокировок маркетплейсов. Отдельно, без приложения, подключаться просто не к чему: порт закрыт, ключа не существует.\n\nПроверить, что всё на месте:\n\n```bash\ncurl http://127.0.0.1:7317/health\n```\n\nОтвет `{\"ok\":true,\"name\":\"parsee-mcp\"}` означает, что приложение запущено и готово. Если ответа нет — откройте ПАРСИ.\n\n---\n\n## Подключение\n\nКлюч доступа выдаёт само приложение: **Подключение ИИ** → строка вида `psk_…`. Ключ локальный, никуда не отправляется, отзывается одной кнопкой.\n\n### Claude Code\n\n```bash\nclaude mcp add parsee --transport http http://127.0.0.1:7317/mcp --header \"Authorization: Bearer ВАШ_КЛЮЧ\"\n```\n\n### Claude Desktop, Kimi, Cursor и другие\n\n```json\n{\n  \"mcpServers\": {\n    \"parsee\": {\n      \"url\": \"http://127.0.0.1:7317/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer ВАШ_КЛЮЧ\" }\n    }\n  }\n}\n```\n\nПри подключении сервер сам отдаёт ассистенту инструкцию: порядок работы, чем отличаются группы, чего делать нельзя. Отдельно её можно перечитать инструментом `parsee_help`.\n\n---\n\n## Что умеет ассистент\n\n28 инструментов, 15 из них только читают данные. Полный машиночитаемый список — [`tools.json`](tools.json).\n\n### Найти и собрать\n| Инструмент | Что делает |\n|---|---|\n| `parsee_browser_search` | Поиск словами. Отдаёт **только ссылки** — ни цен, ни рейтинга |\n| `parsee_parse_category` | Категория, выдача, бренд или продавец целиком — одной ссылкой |\n| `parsee_parse_urls` | Сбор карточек по списку ссылок или артикулов |\n| `parsee_wait` | Дождаться конца сбора и только потом ответить |\n| `parsee_get_results` | Прочитать собранное: цена, цена с картой, рейтинг, отзывы, наличие |\n| `parsee_export` | Выгрузить в Excel, CSV, JSON или ZIP |\n\n### Группы\n| Инструмент | Что делает |\n|---|---|\n| `parsee_list_groups` | Все группы: мониторинг, сравнение, СПП |\n| `parsee_create_group` | Создать группу и сразу наполнить |\n| `parsee_add_to_group` / `parsee_remove_from_group` | Дополнить или почистить |\n| `parsee_rename_group` / `parsee_delete_group` | Переименовать, удалить (только с подтверждением) |\n| `parsee_run_check` | Проверить группу сейчас |\n\n### Аналитика\n| Инструмент | Что делает |\n|---|---|\n| `parsee_get_prices` | Цены по группе: витрина и цена с картой |\n| `parsee_monitor_changes` | Что изменилось с прошлой проверки: цена, наличие, схема, рейтинг |\n| `parsee_compare_diff` | Моя карточка против конкурента — кто дешевле |\n| `parsee_spp_changes` | Где сдвинулась скидка постоянного покупателя |\n| `parsee_price_history` | Как менялась цена товара |\n\n### Настройка\n| Инструмент | Что делает |\n|---|---|\n| `parsee_status` | Что происходит сейчас, сколько собрано |\n| `parsee_get_options` / `parsee_set_options` | Фото, отзывы, характеристики, режим скорости |\n| `parsee_get_region` / `parsee_set_region` | Город, из которого смотрятся цены — они разные по стране |\n| `parsee_get_schedule` / `parsee_set_schedule` | Запуск по дням недели или каждые N часов |\n| `parsee_wb_cabinet` | Цены, переданные площадке — основа расчёта СПП |\n| `parsee_stop` | Остановить сбор |\n\n---\n\n## Как ассистенту работать правильно\n\n1. `parsee_status` — не идёт ли уже сбор.\n2. `parsee_set_options` — выключить фото и отзывы, если нужна только цена: сбор идёт в разы быстрее.\n3. `parsee_parse_category` — взять рынок целиком. Либо `parsee_browser_search`, если нужен поиск словами.\n4. `parsee_wait` — дождаться конца, а не опрашивать статус в цикле.\n5. `parsee_get_results` — прочитать данные и только теперь делать выводы.\n\nГлавное правило: **выдача поиска — это не данные**. В ней нет ни точных цен, ни рейтинга, ни наличия. Выводы делаются по собранным карточкам.\n\n---\n\n## Безопасность\n\n- Сервер слушает **только** `127.0.0.1` — снаружи недоступен.\n- Ключ обязателен на каждом запросе и сравнивается за постоянное время.\n- Встроенный браузер ходит **только** на `ozon.ru` и `wildberries.ru` — белый список.\n- Кабинет продавца ассистенту недоступен: переданные цены приложение читает само, по ключу, который вводит владелец.\n- Удаление групп — только после явного подтверждения пользователя.\n- Каждое действие видно в журнале приложения, в реальном времени.\n\n---\n\n## Облачный сервер: справка + удалённый доступ\n\nВ репозитории есть `server.py` — один сервер, два режима на одном адресе (`https://parsee-mcp.fastmcp.app/mcp`):\n\n- **Без ключа** — справка: `parsee_cloud_about`, `parsee_cloud_setup`, `parsee_cloud_tools`, `parsee_cloud_manual`. Данных продавца здесь нет, сервер ничего не собирает — только рассказывает, что такое ПАРСИ и как подключиться. Приставка `parsee_cloud_` не даёт модели спутать эти инструменты с настоящими.\n- **С Bearer-ключом удалённого доступа** — работают настоящие 28 инструментов (`parsee_*`, без `cloud_`). Ключ выдаёт приложение (окно «Подключить ИИ» → «Удалённый доступ»). Каждый вызов пересылается на `relay.parsee.ru`, тот держит связь с приложением на компьютере продавца и выполняет команду там же — теми же функциями, что и обычный локальный сбор. Без ключа эти инструменты отвечают понятной ошибкой, а не выдумывают данные.\n\nТак ассистенту не нужно выбирать, какой из двух адресов добавлять — сервер один, дальше решает наличие ключа.\n\n## Ссылки\n\n- Приложение: [parsee.ru](https://parsee.ru)\n- Инструкция для моделей: [`llms.txt`](llms.txt)\n- Каталог инструментов: [`tools.json`](tools.json)\n- Манифест реестра: [`server.json`](server.json)\n",
  "bytes": 6010,
  "sha": "5b8153879137c7b1863c5958483737ee21dcfdf183b98f638e57fef1e6d80e33",
  "repo_slug": "parsee-ru/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ru_parsee_parsee_d0a178c5/readme"
}