Integrations

Enables parallel searching with multiple keywords simultaneously on Google, returning structured search results with configurable parameters for result limits, timeout settings, and locale preferences.

G-서치 MCP

여러 키워드를 동시에 사용하여 병렬 검색을 가능하게 하는 Google 검색을 위한 강력한 MCP 서버입니다.

이 프로젝트는 google-search 에서 수정되었습니다.

장점

병렬 검색 : 구글에서 여러 키워드로 동시에 검색을 지원하여 검색 효율성을 향상시킵니다.
브라우저 최적화 : 효율적인 병렬 검색을 위해 단일 브라우저 인스턴스에서 여러 탭을 엽니다.
자동 검증 처리 : 필요할 때 CAPTCHA를 지능적으로 감지하고 사용자 검증을 위해 눈에 보이는 브라우저 모드를 활성화합니다.
사용자 행동 시뮬레이션 : 검색 엔진에서 감지될 가능성을 줄이기 위해 실제 사용자 검색 패턴을 시뮬레이션합니다.
구조화된 데이터 : 쉬운 처리 및 분석을 위해 JSON 형식으로 구조화된 검색 결과를 반환합니다.
구성 가능한 매개변수 : 검색 결과 제한, 시간 초과 설정, 로캘 설정 등 다양한 매개변수 구성을 지원합니다.

빠른 시작

npx로 직접 실행:

지엑스피1

최초 설정 - 터미널에서 다음 명령을 실행하여 필요한 브라우저를 설치하세요.

npx playwright install chromium

디버그 모드

--debug 옵션을 사용하면 디버그 모드(브라우저 창 표시)에서 실행할 수 있습니다.

npx -y g-search-mcp --debug

MCP 구성

Claude Desktop에서 이 MCP 서버를 구성하세요.

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

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

특징

search - 여러 키워드로 Google 검색을 실행하고 결과를 반환합니다.
- Playwright 브라우저를 사용하여 검색을 수행합니다.
- 다음 매개변수를 지원합니다.
  - queries : 실행할 검색 쿼리 배열(필수 매개변수)
  - limit : 쿼리당 반환할 최대 결과 수, 기본값은 10입니다.
  - timeout : 페이지 로딩 시간 초과(밀리초), 기본값은 60000(60초)입니다.
  - noSaveState : 브라우저 상태를 저장하지 않을지 여부, 기본값은 false입니다.
  - locale : 검색 결과에 대한 로케일 설정, 기본값은 en-US입니다.
  - debug : 디버그 모드(브라우저 창 표시)를 활성화할지 여부, 명령줄의 --debug 플래그를 무시합니다.

사용 예 :

Use the search tool to search for "machine learning" and "artificial intelligence" on Google

응답 예시 :

{
  "searches": [
    {
      "query": "machine learning",
      "results": [
        {
          "title": "What is Machine Learning? | IBM",
          "link": "https://www.ibm.com/topics/machine-learning",
          "snippet": "Machine learning is a branch of artificial intelligence (AI) and computer science which focuses on the use of data and algorithms to imitate the way that humans learn, gradually improving its accuracy."
        },
        ...
      ]
    },
    {
      "query": "artificial intelligence",
      "results": [
        {
          "title": "What is Artificial Intelligence (AI)? | IBM",
          "link": "https://www.ibm.com/topics/artificial-intelligence",
          "snippet": "Artificial intelligence leverages computers and machines to mimic the problem-solving and decision-making capabilities of the human mind."
        },
        ...
      ]
    }
  ]
}

사용 팁

특수 웹사이트 시나리오 처리

검색 매개변수 조정

검색 결과 수량 : 더 많은 검색 결과를 보려면:
Please return the top 20 search results for each keyword
이렇게 하면 limit: 20 매개변수로 설정됩니다.
시간 초과 기간 증가 : 로딩이 느린 상황의 경우:
Please set the page loading timeout to 120 seconds
이렇게 하면 timeout 매개변수가 120000밀리초로 조정됩니다.

로케일 설정 조정

검색 지역 변경 : 다른 로케일 설정을 지정하세요.
Please use Chinese locale (zh-CN) for searching
이렇게 하면 locale: "zh-CN" 매개변수가 설정됩니다.

디버깅 및 문제 해결

디버그 모드 활성화

동적 디버그 활성화 : 특정 검색 작업 중에 브라우저 창을 표시하려면:
Please enable debug mode for this search operation
--debug 플래그 없이 서버를 시작한 경우에도 debug: true 로 설정됩니다.

설치

필수 조건

Node.js 18 이상
NPM 또는 Yarn

소스에서 설치

저장소를 복제합니다.

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

종속성 설치:

npm install

Playwright 브라우저를 설치하세요:

npm run install-browser

서버를 빌드하세요:

npm run build

개발

자동 재구축(개발 모드)

npm run watch

디버깅을 위한 MCP Inspector 사용

npm run inspector

특허

MIT 라이선스 에 따라 라이센스됨

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

search

여러 키워드를 동시에 사용하여 병렬 Google 검색을 지원하고, CAPTCHA를 처리하고 사용자 검색 패턴을 시뮬레이션하면서 구조화된 결과를 제공하는 강력한 MCP 서버입니다.

Related Resources

Reddit Discussion about this server

G-Search MCP