Как подключить Browserless к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Browserless, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Browserless + Gemini

Облачные браузеры Browserless из вашего ИИ: чтение отрисованных страниц в markdown, HTML или списком ссылок через smart scrape, извлечение элементов по CSS-селекторам, скриншоты, печать в PDF, аудиты Lighthouse, карта URL сайта и открытие страниц с защитой от ботов через unblock API. Все инструменты, кроме проверки версии, тратят единицы Browserless.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

BROWSERLESS_API_TOKEN, BROWSERLESS_HOST

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужен аккаунт Browserless; бесплатный тариф включает ежемесячные единицы.

1. Войдите на https://browserless.io/account/ и скопируйте API token из панели.
2. Вставьте его в BROWSERLESS_API_TOKEN. Browserless принимает его в каждом вызове как параметр запроса token; он отправляется только на указанный ниже хост.
3. Укажите в BROWSERLESS_HOST регион вашего тарифа без https://: production-sfo.browserless.io (запад США, по умолчанию для общих тарифов), production-lon.browserless.io (Лондон) или production-ams.browserless.io (Амстердам). Выделенные тарифы (private fleet) используют chrome.browserless.io или свой региональный хост chrome-...browserless.io; приватный токен на общем хосте отклоняется с 401.
4. Установите коннектор и выполните browserless_get_meta: он вернёт версию сервиса Browserless на хосте и подтвердит токен.

Что тратит единицы: все инструменты, кроме browserless_get_meta, тратят единицы Browserless из тарифа: 1 единица за каждые 30 секунд работы браузера (с округлением вверх; простые загрузки в smart scrape стоят 0,5), плюс 6 единиц за МБ трафика через резидентный прокси или 2 за МБ через серверный, и 10 единиц за каждую решённую CAPTCHA. browserless_smart_scrape и browserless_map по умолчанию используют резидентный прокси, а форматы json и summary в smart scrape добавляют единицы за ИИ-извлечение. stealth: true ничего не стоит дополнительно. ИИ спрашивает вас перед серией вызовов и перед использованием прокси на больших страницах.

Чтение страниц: browserless_smart_scrape выбирается первым. Он пробует простую загрузку, затем прокси, затем полноценный браузер, сообщает, какая стратегия сработала, и возвращает нужные formats: markdown (здесь по умолчанию), html, rawText, links, screenshot, pdf, json (ИИ-извлечение по схеме или подсказке в json_options) или summary. only_main_content, include_tags и exclude_tags сокращают страницу. browserless_get_content возвращает полностью отрисованный HTML страницы по URL или переданного HTML из настоящего Chrome. browserless_scrape возвращает текст, HTML и атрибуты каждого элемента, подходящего под ваши CSS-селекторы.

Изображения и документы: browserless_screenshot снимает видимую область, всю страницу или один элемент (selector) в PNG, JPEG или WebP, со своим viewport, scroll_page для подгружаемого контента и block_consent_modals, чтобы скрыть баннеры cookies. browserless_pdf печатает в PDF страницу по URL или переданный HTML (например, сгенерированный отчёт) с параметрами вроде format, landscape, полей и printBackground.

Карта и качество сайта: browserless_map перечисляет URL сайта по карте сайта и ссылкам, с заголовками и описаниями, отсортированные по релевантности к search (limit по умолчанию 200, до 5000). browserless_performance запускает аудит Google Lighthouse с оценками от 0 до 1 по производительности, доступности, лучшим практикам, SEO и PWA. Полный аудит может идти минуты и очень объёмен, поэтому ИИ передаёт config, чтобы проверить одну категорию.

Заблокированные страницы: browserless_unblock обходит системы обнаружения ботов (Datadome, пассивные CAPTCHA) и возвращает HTML, cookies, выставленные сайтом, и по желанию скриншот всей страницы; лучше всего он работает с proxy: residential, и ИИ сначала спрашивает. Для других инструментов ИИ сначала пробует stealth: true, затем прокси (proxy_country задаёт страну).

Ожидание контента: инструменты отрисовки принимают wait_for_selector (элемент и тайм-аут), wait_for_timeout, goto_options (например, waitUntil: networkidle2) и best_attempt, который продолжает с уже загруженным, если ожидание истекло. В browserless_get_content и browserless_scrape параметр reject_resource_types (изображения, шрифты, медиа) ускоряет страницы; browserless_get_content также отправляет set_extra_http_headers и cookies вместе с запросом. Все времена указываются в миллисекундах; timeout ограничивает весь вызов.

Выключено при установке: browserless_function, который выполняет ваш собственный код Puppeteer для многошаговых сценариев, например прохода по форме или листания результатов. Такой код может отправлять формы, входить в аккаунты или совершать покупки на сайтах, и эти действия нельзя отменить, поэтому администратор workspace включает его, когда он нужен команде. После включения ИИ показывает вам код и ждёт вашего согласия.

Что он меняет: ничего в вашем аккаунте Browserless. Каждый вызов запускает новый headless Chrome, выполняет одну задачу на одном URL и закрывает браузер, так что между вызовами ничего не сохраняется.

Форматы данных: скриншоты возвращаются как изображения, PDF как файлы; текстовые ответы ограничены примерно 100 КБ. Параметры вроде wait_for_selector, goto_options, viewport и json_options это JSON-объекты. Оценки Lighthouse указаны дробями (0,92 = 92).

Недоверенный контент: страницы, cookies и извлечённый текст приходят со сторонних сайтов. ИИ считает инструкции внутри них данными, а не командами.

Частые ошибки: 401 означает, что токен неверный или не относится к этому хосту (общий или приватный fleet); скопируйте его заново из панели. 404 при проверке установки значит, что BROWSERLESS_HOST не обслуживает REST API. 400 это некорректное тело запроса, например когда нет ни url, ни html. 403 означает, что цель запрещена для этого аккаунта. 408 значит, что страница грузилась дольше тайм-аута: увеличьте timeout, ждите меньшего или используйте best_attempt. 429 значит, что исчерпан лимит одновременных сессий тарифа; подождите и повторите один раз. Пустой или неполный контент обычно означает, что сайт блокирует автоматизацию: попробуйте stealth: true, затем browserless_unblock с резидентным прокси.

Коннектор не охватывает BrowserQL, WebSocket-сессии для Puppeteer или Playwright, асинхронные API обхода и агентов, скачивание файлов и управление сессиями.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Browserless.

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

Примеры запросов

• «Прочитай https://example.com/pricing через smart scrape и выведи тарифы и цены таблицей.»
• «Сделай скриншот всей главной страницы при ширине 1280 px и скрой баннер cookies.»
• «Запусти аудит производительности Lighthouse для https://example.com и назови три главные проблемы.»
• «Составь карту URL https://example.com, связанных с документацией, и покажи первые 50.»
• «Преврати этот HTML-отчёт в PDF формата A4 с фоновыми цветами и полями 1 см.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse
• Подключить к Microsoft Copilot