Agent Bridge

Обзор

Agent Bridge позволяет AI-агентам (Claude Code, Cursor, Cowork и др.) удалённо управлять расширением Web2MD для Chrome, чтобы пакетно преобразовывать URL — особенно страницы Reddit, страницы с JS-рендерингом и страницы, защищённые авторизацией, которые блокируют серверный доступ к API. Вместо обращения к API Web2MD (которое блокирует Reddit) AI-агент отправляет команды вашему локальному расширению Chrome через Native Messaging. Расширение открывает каждую страницу в фоновой вкладке, используя вашу реальную сессию браузера — с вашими cookies и данными авторизации, — извлекает содержимое, преобразует его в Markdown и возвращает результат.

Для Agent Bridge требуется тариф PRO и установленный на вашем компьютере native messaging host. Расширение должно быть открыто в Chrome.

Архитектура

AI Agent ←MCP/stdio→ MCP Server ←TCP:12315→ Native Host ←NM→ Chrome Extension → Any Website

Компонент	Роль
AI Agent	Claude Code, Cursor, Cowork — вызывает инструменты MCP
MCP Server	Преобразует вызовы инструментов MCP в TCP-сообщения
Native Host	Передаёт данные между TCP и Chrome Native Messaging
Chrome Extension	Открывает вкладки, извлекает HTML, преобразует в Markdown

Всё взаимодействие происходит локально — ничего не покидает ваш компьютер. Native Host прослушивает только localhost:12315.

Настройка

Шаг 1. Соберите MCP Server

cd packages/mcp-server
pnpm build

Шаг 2. Установите Native Messaging Host

cd packages/mcp-server
./install.sh <your-extension-id>

Найдите ID вашего расширения на странице chrome://extensions с включённым режимом разработчика. Найдите Web2MD и скопируйте строку ID (например, ijmgpkkfgpijifldbjafjiapehppcbcn).

После установки необходимо полностью закрыть Chrome (Cmd+Q на Mac) и снова открыть его. Chrome считывает манифесты Native Messaging только при запуске — перезагрузки расширения недостаточно.

Скрипт установки:

Копирует файлы host в ~/.web2md/ (во избежание ограничений macOS TCC на ~/Desktop)
Определяет абсолютный путь к node (Chrome запускается с минимальным PATH)
Записывает манифест NM в каталог NativeMessagingHosts браузера Chrome

Шаг 3. Настройте MCP

Claude Code
Cursor
Claude Desktop

Добавьте в ~/.claude/settings.json:

{
  "mcpServers": {
    "web2md-agent": {
      "command": "node",
      "args": ["/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "WEB2MD_API_KEY": "w2m_your_key_here"
      }
    }
  }
}

Добавьте в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "web2md-agent": {
      "command": "node",
      "args": ["/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "WEB2MD_API_KEY": "w2m_your_key_here"
      }
    }
  }
}

Добавьте в конфигурацию Claude Desktop:

{
  "mcpServers": {
    "web2md-agent": {
      "command": "node",
      "args": ["/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "WEB2MD_API_KEY": "w2m_your_key_here"
      }
    }
  }
}

Шаг 4. Проверка

В Chrome откройте chrome://extensions → нажмите на ссылку «Service Worker» рядом с Web2MD → проверьте консоль:

[Web2MD] Service worker started
[Web2MD] Connected to native host
[Web2MD] Native host TCP relay ready on port 12315

Если вы видите эти три строки, Agent Bridge работает корректно.

Доступные инструменты

Agent Bridge предоставляет три инструмента MCP — выбирайте в зависимости от транспорта и потребности в batch-обработке. Все три подробно описаны на странице MCP Server; здесь приведено краткое сравнение.

Инструмент	Транспорт	Batch-обработка
`bridge_convert_url`	HTTP (расширение получает HTML, сервер конвертирует)	Один URL
`agent_convert`	Native messaging (архитектура этой страницы)	Один URL, необязательный параметр `skill`
`agent_batch_convert`	Native messaging	До 50 URL, последовательно

agent_convert

Преобразование одного URL с помощью расширения Chrome по native messaging.

Параметр	Тип	Описание
`url`	string	URL для преобразования
`skill`	string (опционально)	Id или имя Skill — его содержимое добавляется к возвращённому Markdown

Возвращает: содержимое Markdown с заголовком, исходным URL, количеством слов и временем чтения. Лучше всего подходит для: тредов Reddit, страниц, защищённых авторизацией, сайтов с JS-рендерингом.

agent_batch_convert

Пакетное преобразование до 50 URL. URL обрабатываются последовательно — расширение открывает каждую страницу в фоновой вкладке, извлекает содержимое, закрывает вкладку, затем переходит к следующей.

Параметр	Тип	Описание
`urls`	string[]	Массив URL для преобразования (максимум 50)

Возвращает: результаты по каждому URL, передаваемые потоково по мере готовности, а также итоговую сводку. Лучше всего подходит для: исследовательских задач — пакетного преобразования тредов Reddit, обсуждений на HN или страниц конкурентов для AI-анализа.

bridge_convert_url

Преобразование одного URL путём получения его HTML через расширение по локальному HTTP-мосту (вместо native messaging), с последующей конвертацией на стороне сервера. Функционально похож на agent_convert для разовых преобразований, но не требует установки native messaging host — достаточно, чтобы расширение было установлено и запущено.

Параметр	Тип	Описание
`url`	string	URL для преобразования
`extensionId`	string (опционально)	Переопределить ID расширения (по умолчанию определяется автоматически по вашему API-ключу)

Все успешные преобразования автоматически сохраняются в вашей истории на панели управления вместе со сгенерированными AI резюме и тегами.

Примеры использования

Преобразование треда Reddit

Вы: Преобразуй этот тред Reddit в Markdown: https://www.reddit.com/r/LangChain/comments/1siwh6q/…Агент: (вызывает agent_convert) Вот преобразованный тред с 7 комментариями, обсуждающими точность RAG для юридических документов…

Пакетное преобразование для исследования

Вы: Преобразуй эти 5 ссылок Reddit и обобщи ключевые выводы:

Агент: (вызывает agent_batch_convert) Успешно преобразовано 5 из 5 ссылок. Вот ключевые выводы…

Преобразование страниц с ограниченным доступом

Вы: Преобразуй страницу внутренней wiki моей компании по адресу https://wiki.internal.com/architectureАгент: (вызывает agent_convert) Поскольку вы авторизованы на этом сайте в Chrome, мне удалось извлечь полное содержимое…

Поддерживаемые сайты

Agent Bridge использует те же 27 специализированных экстракторов для конкретных сайтов, что и расширение — каждый умеет извлекать чистое содержимое из DOM или API сайта, вместо того чтобы откатываться на сырой HTML страницы.

Соцсети и обсуждения (7)

Reddit · Hacker News · Twitter/X · Quora · Xiaohongshu (小红书) · Zhihu (知乎) · Instagram

Экспорт AI-чатов (2)

Диалоги Claude · Другие платформы AI-чатов (ChatGPT, Gemini и др. через общий DOM-экстрактор)

Документация и базы знаний (6)

Wikipedia · arXiv · OpenAI Docs · сайты документации на базе Mintlify · Notion · Google Docs

Разработка и код (3)

GitHub Issues/PRs · Stack Overflow · dev.to

Публикации (3)

Medium · Substack · Product Hunt

Платформы CJK (4)

WeChat (微信公众号) · Bilibili (哔哩哔哩) · Feishu (飞书) — плюс Xiaohongshu и Zhihu выше. В коде вся эта категория помечена как группа экстракторов с наивысшей дифференциацией — мало кто из конкурентов вообще поддерживает эти платформы.

Видео и медиа (1)

YouTube (извлечение транскрипта)

Работа и продуктивность (5)

Gmail · LinkedIn · Amazon (страницы товаров) · Canvas LMS · форумы XenForo

Любой URL без выделенного экстрактора обрабатывается через извлечение полного HTML страницы — это по-прежнему работает, просто без специфичной для сайта очистки (удаления навигационного «шума», рекламы, виджетов комментариев и т. д.), которую применяют специализированные экстракторы. Сайты, предоставляющие публичный API (Reddit, Hacker News, GitHub, Stack Overflow), по возможности загружаются через этот API — это быстрее и надёжнее, чем открытие фоновой вкладки. Всё остальное открывается в фоновой вкладке, и содержимое извлекается из отрендеренного DOM.

Устранение неполадок

«Native host not installed» или «not found»

Chrome не загрузил манифест NM. Полностью закройте Chrome (Cmd+Q) и откройте снова. Простой перезагрузки расширения недостаточно.

«Native host has exited» сразу же

Chrome не может выполнить скрипт host. Частые причины:

node не найден — повторно запустите ./install.sh, который использует абсолютный путь к node
Host находится в директории, защищённой TCC (~/Desktop, ~/Documents) — повторно запустите установку, чтобы переместить его в ~/.web2md/

«Agent connection error» от MCP

TCP-сервер Native Host не запущен. Убедитесь, что:

Chrome открыт
Расширение Web2MD загружено
В консоли Service Worker отображается «TCP relay ready on port 12315»

«Failed to extract content from the page»

Расширение не авторизовано. Откройте попап Web2MD в Chrome и войдите в свой аккаунт PRO.

«Tab load timeout»

Целевая страница загружается слишком долго. Это нормально для медленных сайтов. Расширение ожидает до 15 секунд на вкладку. Reddit использует экстрактор JSON API и не нуждается во вкладке, поэтому таймауты на Reddit обычно означают, что URL публикации недействителен (404).

Преобразования не отображаются в истории на панели управления

Для сохранения истории расширение должно быть авторизовано в аккаунте PRO. Сохранение выполняется по принципу fire-and-forget — если вызов API завершается неудачей молча, преобразования не появятся. Проверьте, действителен ли ваш токен авторизации.

Отличия от MCP Server

Функция	`convert_url`	`bridge_convert_url`	`agent_convert` / `agent_batch_convert`
Где выполняется	Серверный вызов API	Расширение получает HTML, сервер конвертирует	Ваш локальный браузер Chrome (native messaging)
Поддержка Reddit	❌ Блокируется Reddit	✅ Использует реальную сессию браузера	✅ Использует реальную сессию браузера
Страницы с ограниченным доступом	❌ Нет доступа	✅ Использует ваши cookies	✅ Использует ваши cookies
Страницы с JS-рендерингом	❌ Без JavaScript	✅ Полный рендеринг Chrome	✅ Полный рендеринг Chrome
Необходимая настройка	Только API-ключ	Расширение установлено и запущено	Установлены расширение и native messaging host
Batch-обработка	—	Только один URL	До 50 URL (`agent_batch_convert`)
Требуется открытый Chrome	Нет	Да	Да

Общее правило: используйте convert_url для публичных страниц. Используйте bridge_convert_url, когда нужна сессия браузера расширения, но не хочется устанавливать native messaging host. Используйте agent_convert / agent_batch_convert для Reddit, страниц с авторизацией, сайтов с активным JS или когда нужна batch-обработка — либо когда нужно применить Skill через параметр skill у agent_convert.

Начало работы

Основные функции

Дополнительно

Тарифы

Обзор

Архитектура

Настройка

Шаг 1. Соберите MCP Server

Шаг 2. Установите Native Messaging Host

Шаг 3. Настройте MCP

Шаг 4. Проверка

Доступные инструменты

agent_convert

agent_batch_convert

bridge_convert_url

Примеры использования

Поддерживаемые сайты

Устранение неполадок

Отличия от MCP Server

​Обзор

​Архитектура

​Настройка

​Шаг 1. Соберите MCP Server

​Шаг 2. Установите Native Messaging Host

​Шаг 3. Настройте MCP

​Шаг 4. Проверка

​Доступные инструменты

​agent_convert

​agent_batch_convert

​bridge_convert_url

​Примеры использования

​Поддерживаемые сайты

​Устранение неполадок

​Отличия от MCP Server

Обзор

Архитектура

Настройка

Шаг 1. Соберите MCP Server

Шаг 2. Установите Native Messaging Host

Шаг 3. Настройте MCP

Шаг 4. Проверка

Доступные инструменты

agent_convert

agent_batch_convert

bridge_convert_url

Примеры использования

Поддерживаемые сайты

Устранение неполадок

Отличия от MCP Server