G-Search-MCP: 무료 Google 검색을 위한 MCP 서버

2.1K 00

일반 소개

G-Search-MCP는 개발자 jae-jae가 GitHub에서 호스팅하는 오픈 소스 Google 검색 도구입니다. 구글 검색 수정되었습니다. MCP(모델 컨텍스트 프로토콜) 서버를 통해 실행되며, 핵심 기능은 Google 검색에서 동시에 여러 키워드를 지원하는 것입니다. 검색 결과는 사용자가 처리하고 분석하기 쉬운 JSON 형식으로 반환됩니다. 이 도구는 Playwright 브라우저를 사용하여 실제 사용자의 작업을 시뮬레이션하여 Google에 의해 차단 될 위험을 효과적으로 줄일 수 있습니다. 개발자, 연구원 또는 데이터 분석가와 같이 많은 양의 정보를 빠르게 확보해야 하는 사용자에게 적합합니다. 이 프로젝트는 또한 결과 수 및 언어 선택과 같은 매개 변수를 유연하게 구성할 수 있습니다.

기능 목록

다중 키워드 병렬 검색여러 키워드의 동시 검색을 지원하여 효율성을 높입니다.
브라우저 최적화: 단일 브라우저 인스턴스에서 여러 탭을 열어 리소스를 절약하세요.
캡차 자동 감지캡차가 발견되면 표시 모드로 전환하고 사용자가 인증할 때까지 기다립니다.
사용자 행동 시뮬레이션실제 사용자 작업을 모방하여 검색 엔진의 제약을 받지 않도록 합니다.
JSON 데이터 출력프로그램에서 쉽게 사용할 수 있도록 검색 결과가 구조화된 형식으로 반환됩니다.
매개변수화결과 수, 시간 초과, 언어 지역 등의 옵션을 설정할 수 있습니다.

도움말 사용

G-Search-MCP는 사용하려면 설치 및 구성이 필요한 기술 도구입니다. 설치 과정과 작동은 아래에 자세히 설명되어 있습니다.

설치 프로세스

환경 요구 사항 검사
- Node.js 18 이상, NPM 또는 Yarn이 설치되어 있어야 합니다.
- 컴퓨터에 코드 다운로드를 위한 Git이 있는지 확인하세요.
- 최신 브라우저(예: Chromium)를 준비하면 도구가 자동으로 설치됩니다.
프로젝트 코드 다운로드
- 터미널을 열고 명령을 실행합니다:
```
git clone https://github.com/jae-jae/g-search-mcp.git
```
- 프로젝트 카탈로그로 이동합니다:
```
cd g-search-mcp
```
종속성 설치
- 명령을 입력하여 필요한 패키지를 설치합니다:
```
npm install
```
Playwright 브라우저 설치
- 다음 명령을 실행하여 크롬 브라우저를 설치합니다:
```
npx playwright install chromium
```
- 이 단계는 도구가 브라우저 인스턴스를 제대로 실행하는지 확인합니다.
서버 구축
- 프로젝트를 빌드하는 명령을 입력합니다:
```
npm run build
```
빠른 시작
- 명령을 사용하여 직접 실행합니다:
```
npx -y g-search-mcp
```
- 시작 후 서버를 사용할 준비가 되었습니다.

MCP 서버 구성(선택 사항)

만약 당신이 Claude 데스크톱에서 이 도구를 사용하여 다음과 같이 구성할 수 있습니다. MCP 서버:

구성 파일 경로
- MacOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%/Claude/claude_desktop_config.json

구성 콘텐츠

JSON 파일을 편집하여 다음을 추가합니다:

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

사용 방법

기본 조작

단일 키워드 검색
- 실행 명령을 실행합니다:
```
npx -y g-search-mcp --keywords "人工智能"
```
- 브라우저에서 결과를 표시하는 탭이 열리고 터미널이 JSON 데이터를 반환합니다.
다중 키워드 검색
- 쉼표로 구분하여 여러 개의 키워드를 입력합니다:
```
npx -y g-search-mcp --keywords "人工智能,机器学习"
```
- 브라우저에서 각 키워드에 대해 하나씩 여러 개의 탭이 열립니다.

주요 기능 작동

결과 수 조정
- 활용 --limit 매개변수:
```
npx -y g-search-mcp --keywords "人工智能" --limit 20
```
- 처음 20개의 결과를 반환하며 기본값은 10개입니다.
타임아웃 기간 설정
- 활용 --timeout 매개변수:
```
npx -y g-search-mcp --keywords "人工智能" --timeout 120000
```
- 시간 제한을 120초로 설정합니다(기본값은 60초).
언어 지역 변경
- 활용 --locale 매개변수:
```
npx -y g-search-mcp --keywords "人工智能" --locale "zh-CN"
```
- 결과는 우선적으로 중국어로 표시됩니다.
디버그 모드 사용
- 증가 --debug 매개변수:
```
npx -y g-search-mcp --keywords "人工智能" --debug
```
- 브라우저 창에 표시되어 작업을 쉽게 확인할 수 있습니다.
캡차 처리
- 보안 문자가 발생하면 도구가 일시 중지되고 브라우저 창이 표시됩니다.
- 사용자가 수동으로 유효성 검사를 완료한 후에도 도구는 계속 실행됩니다.

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 인스펙터를 사용하세요.

주의

네트워크 연결Google 서비스에 대한 인터넷 액세스가 필요합니다.
리소스 점유다중 키워드 검색은 메모리를 더 많이 사용할 수 있습니다.
역량 문제터미널에 명령을 실행할 수 있는 충분한 권한이 있는지 확인합니다.

작동 예

'블록체인'과 '스마트 계약'을 검색한다고 가정해 보겠습니다:

명령을 입력합니다:

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

브라우저에서 두 개의 탭이 열리고 중국어 검색 결과가 표시됩니다.
터미널은 각 결과의 제목, 링크 및 요약이 포함된 JSON 데이터를 반환합니다.

이 도구는 기술적인 사용자가 대량으로 정보를 수집할 수 있도록 직관적이고 강력합니다.

애플리케이션 시나리오

기술 연구
개발자는 이를 사용하여 '프론트엔드 프레임워크', '백엔드 기술' 등의 키워드를 검색하여 정보를 빠르게 비교할 수 있습니다.
데이터 분석
분석가는 JSON 출력을 사용하여 '시장 동향' 및 '사용자 니즈'와 같은 키워드 결과를 분석할 수 있습니다.
교육 지원
학생들은 이를 사용하여 '물리' 및 '화학 반응'을 검색하여 학습 리소스에 빠르게 액세스할 수 있습니다.

QA

시작 시 Playwright가 누락된 경우 어떻게 해야 하나요?
움직여야 합니다. npx playwright install chromium 브라우저를 설치합니다.
검색 결과가 불완전하면 어떻게 하나요?
네트워크를 확인하거나 --timeout 시간(예: 120000밀리초)을 입력합니다.
검색 결과를 저장하려면 어떻게 하나요?
명령 뒤에 다음을 추가합니다. > 文件名.json예를 들면 다음과 같습니다. npx -y g-search-mcp --keywords "人工智能" > result.json.