dsh-google-chrome-search

Плагин DeepSeek Harness (DSH), который позволяет AI-агенту выполнять реальный поиск в Google путем управления локальным браузером Chrome через CDP (Chrome DevTools Protocol) и рендерить любую страницу для извлечения её содержимого. Ключ API для поиска не нужен — используется уже установленный Chrome.

Google часто показывает страницу проверки человека (CAPTCHA / «необычный трафик») для автоматизированного и дата-центрового трафика. Когда это происходит, плагин открывает видимое окно Chrome, указывающее на страницу проверки, ждёт, пока человек её пройдёт, а затем извлекает результаты из уже доверенной сессии. Это шаг «спросить человека» — по замыслу агент никогда не пытается решить CAPTCHA самостоятельно.

Что вы получаете

Related MCP server: browser-search-mcp

Требования

• Node.js ≥ 18 (протестировано на Node 22)

• Локальный бинарник Chrome/Chromium (например, google-chrome, chromium). Автоопределение из стандартных путей; можно переопределить через CHROME_PATH или --chrome.

• Для шага видимой проверки нужен рабочий стол с дисплеем (чтобы окно Chrome можно было показать человеку). Headless/SSH по-прежнему может обнаружить CAPTCHA и сообщить о ней (со скриншотом).

Установка

git clone https://github.com/davidcastilloalvarado/dsh-google-chrome-search.git
cd dsh-google-chrome-search
npm install

Зависимости: puppeteer-core (управляет вашим Chrome — он не скачивает браузер), @modelcontextprotocol/sdk (для MCP-сервера), @mozilla/readability (извлечение содержимого) и zod (валидация схем).

При желании можно глобально связать CLI, чтобы он был в PATH:

npm link        # gives you: dsh-google-search "<query>"

Использование CLI

# Search:
node bin/google-search.mjs "nodejs streams" --max 8
# or, after npm install / npm link:
npm run search -- "nodejs streams" --json

# Search, then render + extract the top 3 result pages:
node bin/google-search.mjs "nodejs streams" --max 8 --fetch-top 3 --fetch-max-chars 8000

# Fetch one URL directly (render + extract readable content):
node bin/google-search.mjs fetch "https://nodejs.org/api/stream.html" --max-chars 8000

Коды выхода: 0 = успех (результаты / полученное содержимое), 2 = требуется проверка (CAPTCHA), 3 = нет результатов / получение заблокировано или не удалось, 1 = ошибка, 64 = использование.

Получение страницы (рендер + извлечение)

Плагин также может рендерить любой URL и извлекать его читаемое основное содержимое:

• Запускает страницу в том же выделенном профиле Chrome (поэтому сайты, которые видят согласованный, доверенный отпечаток, ведут себя лучше).

• Ждёт полной загрузки страницы (включая поздний SPA-контент).

• Извлекает статью с помощью Mozilla Readability, выполняемой внутри живой страницы. Если на странице нет отдельной статьи, используется полный текст страницы.

• Ограничение вывода (по умолчанию 8 000 символов на страницу), чтобы он оставался удобным для контекста агента.

• Обнаруживает анти-бот стены и сообщает blocked вместо мусора. Когда сайт показывает вызов проверки человека (например, стена DataDome «slide to continue»), открывается видимое окно Chrome со страницей, ожидание до verifyTimeoutMs для прохождения человеком, затем извлекается реальное содержимое — та же философия «передать человеку», что и в потоке CAPTCHA Google. Доверенный сессионный cookie сохраняется в профиле, поэтому последующие страницы этого сайта обычно проходят headless. Используйте --no-verify / autoVerify: false, чтобы просто сообщить blocked.

dsh-google-search fetch "https://example.com/article" --max-chars 10000
dsh-google-search fetch "https://example.com/article" --html --screenshot

Два способа объединить поиск и чтение:

Страницы рендерятся последовательно (один браузер, одна страница за раз) — ожидайте ~1–3 с на страницу.

Использование как нативного инструмента DSH (MCP)

Зарегистрируйте MCP-сервер с @deepseek-ai/dsh-mcp-client в конфигурации вашего профиля (пример — скорректируйте пути command и args под ваше окружение):

- insert:
    - id: mcp-google
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: google
        transport: stdio
        command: /path/to/node
        args: [ /path/to/dsh-google-chrome-search/src/server.mjs ]
        env:
          CHROME_PATH: /usr/bin/google-chrome   # optional — auto-detected if unset
        toolCallTimeoutMs: 300000

После перезапуска DSH агент получает три нативных инструмента:

Примечания:

• Вызовы сериализуются (Chrome допускает один процесс на профиль), поэтому одновременные вызовы инструментов ставятся в очередь, а не выполняются параллельно.

• search_and_fetch медленнее обычного поиска: держите toolCallTimeoutMs на 300000 (5 минут), как показано выше.

• Поток проверки человеком применяется как к поиску Google (CAPTCHA), так и к страницам результатов, которые блокируют браузер (анти-бот слайдер): открывается видимое окно Chrome для человека, и сессия сохраняется в профиле после этого.

Использование как навыка DSH

skill/SKILL.md обучает агента выполнять поиск и обрабатывать передачу CAPTCHA человеку. Для установки скопируйте его в каталог навыков DSH, например:

mkdir -p ~/.dsh/skills/google-chrome-search
cp skill/SKILL.md ~/.dsh/skills/google-chrome-search/

Перед использованием/передачей на другой машине отредактируйте заполнитель <INSTALL_DIR> внутри SKILL.md, указав путь, куда вы клонировали этот репозиторий (или добавьте CLI через npm link в PATH — и всё заработает).

Конфигурация (env / параметры)

Поток проверки человеком, шаг за шагом

1. Chrome выполняет поиск в headless-режиме (выделенный изолированный профиль — никогда ваш реальный браузер).

2. Если результаты есть → возвращаются (status: ok).

3. Если Google показывает CAPTCHA:

   • Сделать скриншот.

   • Открыть видимое окно Chrome (тот же профиль) на странице проверки.

   • Ждать до verifyTimeoutMs, пока человек решит её, опрашивая страницу.

   • Если решено → извлечь и вернуть результаты (с флагом verifiedViaHuman: true). Если время истекло → вернуть status: verification_required с последним скриншотом.

4. Проверенная сессия сохраняется в профиле, поэтому следующий поиск обычно проходит headless.

Тестирование

npm test

Запускает MCP-сервер, проверяет, что инструменты search, fetch и search_and_fetch перечислены, и — если на машине доступен бинарник Chrome — выполняет живой поиск с autoVerify: false. В средах без браузера (например, CI) живой вызов пропускается корректно.

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

Откат / очистка

• Конфигурация: удалите запись mcp-google из конфигурации профиля DSH.

• Навык: rm -rf ~/.dsh/skills/google-chrome-search

• Профиль/скриншоты: rm -rf ~/.dsh-chrome-google

Лицензия

MIT