parsee

ПАРСИ · MCP

Ozon と Wildberries の商品収集・モニタリングアプリ ПАРСИ に AI アシスタントを接続します。

接続すると、アシスタント（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	収集を停止

---

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

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