parsee

ПАРСИ · MCP

将 AI 助手连接到 ПАРСИ——一款用于采集和监控 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"}，说明应用已运行并准备就绪。如果没有返回内容，请打开 ПАРСИ。

---

连接

访问密钥由应用本身提供：连接 AI → 获取 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	停止采集

---

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

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