G-Search-MCP: MCP-сервер для бесплатного поиска Google

Общее введение

G-Search-MCP - это инструмент поиска Google с открытым исходным кодом, размещенный на GitHub разработчиком jae-jae и основанный на google-поиск Модифицированный. Он работает через сервер MCP (Model Context Protocol), основная функция - поддержка нескольких ключевых слов одновременно в поиске Google. Результаты поиска возвращаются в формате JSON, который легко обрабатывается и анализируется пользователями. Этот инструмент использует браузер Playwright для имитации работы реальных пользователей, что позволяет эффективно снизить риск блокировки со стороны Google. Он подходит для пользователей, которым необходимо быстро получить большой объем информации, например разработчиков, исследователей или аналитиков данных. Проект также предлагает гибкую настройку параметров, таких как количество результатов и выбор языка.

Список функций

• Параллельный поиск по нескольким словам: Поддержка одновременного поиска по нескольким ключевым словам для повышения эффективности.
• Оптимизация браузера: Экономьте ресурсы, открывая несколько вкладок в одном экземпляре браузера.
• Автоматическое определение CAPTCHA: Переключитесь в видимый режим, когда CAPTCHA будет найдена, и дождитесь подтверждения пользователя.
• Моделирование поведения пользователей: Имитируйте действия реальных пользователей, чтобы избежать ограничений со стороны поисковых систем.
• Вывод данных в формате JSON: Результаты поиска возвращаются в структурированном формате для удобства использования программы.
• параметризация: Можно установить такие параметры, как количество результатов, тайм-аут, языковой регион и т. д.

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

G-Search-MCP - это технический инструмент, который необходимо установить и настроить для использования. Процесс установки и работа подробно описаны ниже.

Процесс установки

1. Проверка соблюдения экологических требований
   • Требуется Node.js 18 или более поздняя версия, с установленными NPM или Yarn.
   • Убедитесь, что на вашем компьютере есть Git для загрузки кода.
   • Подготовьте современный браузер (например, Chromium), и инструмент будет установлен автоматически.
2. Скачать код проекта
   • Откройте терминал и выполните команду:

     git clone https://github.com/jae-jae/g-search-mcp.git
     

   • Перейдите в каталог проектов:

     cd g-search-mcp
     

3. Установка зависимостей
   • Введите команду для установки необходимых пакетов:

     npm install
     

4. Установите браузер Playwright Browser
   • Выполните следующую команду, чтобы установить браузер Chromium:

     npx playwright install chromium
     

   • Этот шаг гарантирует, что инструмент правильно запустит экземпляр браузера.
5. Построить сервер
   • Введите команду для сборки проекта:

     npm run build
     

6. быстрый старт
   • Используйте команду, чтобы запустить его напрямую:

     npx -y g-search-mcp
     

   • После запуска сервер готов к работе.

Настройка сервера MCP (необязательно)

Если вы хотите быть в Клод С помощью этого инструмента в Desktop вы можете настроить MCP Сервер:

• Путь к файлу конфигурации
  • MacOS:~/Library/Application Support/Claude/claude_desktop_config.json
  • Окна:%APPDATA%/Claude/claude_desktop_config.json
• Содержание конфигурации
  • Отредактируйте файл JSON и добавьте следующее:

    {
    "mcpServers": {
    "g-search": {
    "command": "npx",
    "args": ["-y", "g-search-mcp"]
    }
    }
    }
    

Как использовать

базовая операция

1. Поиск по одному ключевому слову
   • Выполнить команду:

     npx -y g-search-mcp --keywords "人工智能"
     

   • Браузер открывает вкладку для отображения результатов, а терминал возвращает данные в формате JSON.
2. Поиск по нескольким ключевым словам
   • Введите несколько ключевых слов, разделив их запятыми:

     npx -y g-search-mcp --keywords "人工智能,机器学习"
     

   • Браузер откроет несколько вкладок, по одной для каждого ключевого слова.

Функциональное управление

1. Настройка количества результатов
   • пользоваться --limit Параметры:

     npx -y g-search-mcp --keywords "人工智能" --limit 20
     

   • Возвращает первые 20 результатов, по умолчанию - 10.
2. Установка периода тайм-аута
   • пользоваться --timeout Параметры:

     npx -y g-search-mcp --keywords "人工智能" --timeout 120000
     

   • Установите тайм-аут на 120 секунд; по умолчанию - 60 секунд.
3. Изменить языковой регион
   • пользоваться --locale Параметры:

     npx -y g-search-mcp --keywords "人工智能" --locale "zh-CN"
     

   • Результаты отображаются на китайском языке в приоритетном порядке.
4. Включить режим отладки
   • увеличить --debug Параметры:

     npx -y g-search-mcp --keywords "人工智能" --debug
     

   • Видимый в окне браузера для удобного просмотра операции.
5. Обработка CAPTCHA
   • Если встречается CAPTCHA, инструмент приостанавливает работу и отображает окно браузера.
   • После того как пользователь завершает проверку вручную, инструмент продолжает работать.
6. Просмотр вывода JSON
   • После завершения поиска терминал отобразит результаты, аналогичные приведенным ниже:

     {
     "searches": [
     {
     "query": "人工智能",
     "results": [
     {
     "title": "人工智能简介",
     "link": "https://example.com",
     "snippet": "人工智能是..."
     }
     ]
     }
     ]
     }
     

   • Результаты можно сохранить в файл:

     npx -y g-search-mcp --keywords "人工智能" > result.json
     

Режим разработки (опционально)

• Автоматическая перестройка: Беги npm run watchКод изменяется и обновляется автоматически.
• Средства отладки: Беги npm run inspectorЧтобы проверить состояние работы, используйте MCP Inspector.

предостережение

• сетевое подключение: необходим доступ в Интернет для работы с сервисами Google.
• занятость ресурсов: Поиск по нескольким ключевым словам может занимать больше памяти.
• Вопросы компетенции: Убедитесь, что терминал обладает достаточными привилегиями для выполнения команды.

Пример работы

Допустим, вы ищете "блокчейн" и "смарт-контракты":

1. Введите команду:

npx -y g-search-mcp --keywords "区块链,智能合约" --limit 15 --locale "zh-CN"

2. Браузер открывает две вкладки и отображает результаты поиска на китайском языке.
3. Терминал возвращает данные в формате JSON, содержащие заголовок, ссылку и краткое описание каждого результата.

Этот инструмент интуитивно понятен и достаточно мощный для технических пользователей, чтобы собирать информацию в больших объемах.

сценарий применения

1. Технические исследования
   Разработчики могут использовать его для поиска по таким ключевым словам, как "front-end фреймворки" и "back-end технологии", чтобы быстро сравнить информацию.
2. анализ данных
   Аналитики могут использовать вывод JSON для анализа результатов по ключевым словам, таким как "тенденции рынка" и "потребности пользователей".
3. Образовательная поддержка
   Студенты могут использовать его для поиска "физики" и "химических реакций", чтобы получить быстрый доступ к учебным ресурсам.

QA

1. Что делать, если Playwright отсутствует при запуске?
   быть в движении npx playwright install chromium Установите браузер.
2. Что делать, если результаты поиска неполные?
   Проверьте сеть или добавьте --timeout время, например 120000 миллисекунд.
3. Как сохранить результаты поиска?
   После команды добавьте > 文件名.jsonНапример npx -y g-search-mcp --keywords "人工智能" > result.json.