ru.parsee/parsee
Цены, наличие, отзывы и СПП с Ozon и Wildberries — на компьютере продавца
Open source Repository Open in the app JSON README (API)
About
Цены, наличие, отзывы и СПП с Ozon и Wildberries — на компьютере продавца
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- ru.parsee
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 2.2.2
- Stars
- 1
- Last push
- 2026-08-05T15:49:57Z
- Repository state
- ativo
- Language
- Python
- Added
- 2026-08-29 04:01:53
- Updated
- 2026-08-29 04:01:53
- Origin id
ru.parsee/parsee
README
# ПАРСИ · MCP
Подключение ИИ-ассистента к **ПАРСИ** — приложению для сбора и мониторинга товаров на Ozon и Wildberries.
После подключения ассистент (Claude, Kimi, Cursor и любой другой с поддержкой MCP) умеет искать товары, запускать сбор, читать собранные данные, вести группы мониторинга и сравнения, считать СПП и ставить проверки по расписанию — по-человечески, без кнопок и таблиц.
---
## Обязательное условие
**Нужно установленное и запущенное приложение ПАРСИ** — [parsee.ru](https://parsee.ru)
Это не прихоть, а устройство продукта: сервер MCP входит в состав приложения и слушает только `127.0.0.1`. Сбор идёт **с компьютера продавца и под его сессиями** Ozon и Wildberries — так устроена защита от блокировок маркетплейсов. Отдельно, без приложения, подключаться просто не к чему: порт закрыт, ключа не существует.
Проверить, что всё на месте:
```bash
curl http://127.0.0.1:7317/health
```
Ответ `{"ok":true,"name":"parsee-mcp"}` означает, что приложение запущено и готово. Если ответа нет — откройте ПАРСИ.
---
## Подключение
Ключ доступа выдаёт само приложение: **Подключение ИИ** → строка вида `psk_…`. Ключ локальный, никуда не отправляется, отзывается одной кнопкой.
### Claude Code
```bash
claude mcp add parsee --transport http http://127.0.0.1:7317/mcp --header "Authorization: Bearer ВАШ_КЛЮЧ"
```
### Claude Desktop, Kimi, Cursor и другие
```json
{
"mcpServers": {
"parsee": {
"url": "http://127.0.0.1:7317/mcp",
"headers": { "Authorization": "Bearer ВАШ_КЛЮЧ" }
}
}
}
```
При подключении сервер сам отдаёт ассистенту инструкцию: порядок работы, чем отличаются группы, чего делать нельзя. Отдельно её можно перечитать инструментом `parsee_help`.
---
## Что умеет ассистент
28 инструментов, 15 из них только читают данные. Полный машиночитаемый список — [`tools.json`](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` | Остановить сбор |
---
## Как ассистенту работать правильно
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](https://parsee.ru)
- Инструкция для моделей: [`llms.txt`](llms.txt)
- Каталог инструментов: [`tools.json`](tools.json)
- Манифест реестра: [`server.json`](server.json)