Skip to content

Installation and Quickstart RU

Svwergio_mel edited this page Nov 12, 2026 · 4 revisions

Установка и быстрый старт

Chat Export автономен: экспорт только расширением — без сервера. Для MCP — chat-export-server на 127.0.0.1 и опционально дашборд. Не нужны Chrome DevTools MCP и встроенные агенты.

1. Расширение (Chrome)

  1. Клонируйте chat-export-extension, выполните npm run build.
  2. Chrome → chrome://extensions → Режим разработчика → Загрузить распакованное → папка репозитория.
  3. Откройте поддерживаемый сайт и перезагрузите вкладку после обновления расширения.

2. Сервер (Node 22.13+)

git clone https://github.com/svergio/chat-export-server.git
cd chat-export-server
npm install && npm run build
chat-export-server key new
chat-export-server start

Каталог данных: ~/.chat-export (CHAT_EXPORT_HOME для переопределения).

3. Связка с расширением

  1. Попап → Дополнительно: хост 127.0.0.1, порт 8765.
  2. Подключите токен браузера (ceb_…) с сервера или дашборда.
  3. Включите нужные платформы; allowCreate / allowDestructive — только если нужны операции MCP.

4. Cursor MCP (HTTP)

{
  "mcpServers": {
    "chat-export": {
      "url": "http://127.0.0.1:8765/mcp",
      "headers": { "Authorization": "Bearer cem_ВАШ_КЛЮЧ" }
    }
  }
}

Ключи cem_: chat-export-server key new. Не публикуйте токены в git.

5. Дашборд (опционально)

Соберите chat-export-dashboard, скопируйте public/ в chat-export-server/dashboard/public/. Откройте http://127.0.0.1:8765/dashboard/.

Справка по настройке

Расширение (ce.settings)

Поле По умолчанию Заметки
serverOn false Мост WebSocket
host / port 127.0.0.1 / 8765 Как у сервера
apiKey пусто ceb_… с сервера или Браузеры в дашборде
allowDestructive false Удаление через MCP
rpcTimeoutS 60 Таймаут RPC

Подробнее: README extension — Configuration.

Каталог сервера (CHAT_EXPORT_HOME, по умолчанию ~/.chat-export)

config.json   # порт, пароль дашборда, платформы
keys.json     # только хеши MCP-ключей
audit.log
exports/
server.log

Смените dashboard.password до общего доступа к ПК. Удобнее .env (копия .env.example сервера): CHAT_EXPORT_ADMIN_PASS, CHAT_EXPORT_MCP_TOKEN, CHAT_EXPORT_BROWSER_TOKENS, CHAT_EXPORT_HOME, CHAT_EXPORT_PORT и др. перекрывают config.json при старте.

Docker + Colima (опционально)

Docker Desktop не нужен. На macOS — Colima:

colima start
docker context use colima
cp .env.example .env    # минимум CHAT_EXPORT_ADMIN_PASS
docker --context colima compose build
docker --context colima compose up -d
curl -sS http://127.0.0.1:8765/health

Данные — том Compose → /data в контейнере. Остановите контейнеры, если порт 8765 нужен локальному демону. Отдельный nginx-фронт: README сервера и дашборда + docker-compose.yml.

Cursor MCP

{
  "mcpServers": {
    "chat-export": {
      "url": "http://127.0.0.1:8765/mcp",
      "headers": { "Authorization": "Bearer cem_ВАШ_КЛЮЧ" }
    }
  }
}

Цепочка: key new → MCP config → browsers_bind → chats_list / chat_ask.

Вход в дашборд

URL: http://127.0.0.1:8765/dashboard/. Логин/пароль из config.json (admin / changeme по умолчанию). Bearer cem_ сюда не подставляется — отдельный секрет для MCP.

Фоновый деплой и связка с локальными LLM

Двухуровневое соглашение (Two-Tier ToS и LEGAL.md)

В расширении и сервере действует двухступенчатое подтверждение условий (LEGAL.md):

  1. General Legal / Account Ban Risk ToS (Базовое соглашение) — принимается при использовании расширения и ручном экспорте; пользователь осознаёт риски нарушения правил сторонних платформ и возможной блокировки аккаунта.
  2. Advanced MCP Mode ToS (Расширенный режим MCP) — отдельное согласие перед включением моста к серверу и автоматизации (allowCreate, allowDestructive, chat_ask), где риск срабатывания антибот-защиты и лимитов выше.

Clone this wiki locally