Google Search Console MCP 서버

MCP 프로토콜을 지원하는 모든 AI 어시스턴트에서 Google Search Console 데이터(순위, 클릭, 노출 및 페이지 수준 실적)를 쿼리하세요.

사전 요구 사항

• Node.js 18 이상

• Google Search Console에 액세스할 수 있는 Google 계정

Related MCP server: Google Search Console + GA4 MCP Server

설정

1. 종속성 설치

npm install

2. Google Cloud 프로젝트 생성

1. Google Cloud Console로 이동합니다.

2. 새 프로젝트를 생성하거나 기존 프로젝트를 선택합니다.

3. Search Console API를 사용 설정합니다:

   • API 및 서비스 > 라이브러리로 이동합니다.

   • "Search Console API"를 검색합니다.

   • '사용 설정'을 클릭합니다.

3. OAuth2 자격 증명 생성

1. API 및 서비스 > 사용자 인증 정보로 이동합니다.

2. '사용자 인증 정보 만들기' > 'OAuth 클라이언트 ID'를 클릭합니다.

3. 애플리케이션 유형: 데스크톱 앱(또는 웹 애플리케이션)

4. 원하는 이름을 지정합니다.

5. 클라이언트 ID와 클라이언트 보안 비밀번호를 복사합니다.

4. .env 파일 구성

cp .env.example .env

값을 입력하세요:

5. 서버 실행

npm start

처음 실행 시 OAuth 인증을 완료하기 위해 브라우저 창이 자동으로 열립니다. 그 후에는 토큰이 .tokens.json에 로컬로 저장되므로 다시 묻지 않습니다.

AI 어시스턴트에 연결

이 서버는 MCP 서버를 AI 어시스턴트에 연결하는 표준 방식인 stdio(표준 입출력)를 통해 통신합니다. AI 어시스턴트가 다음을 사용하도록 구성하세요:

node /path/to/src/index.js

/path/to를 사용 중인 머신의 실제 프로젝트 경로로 바꾸세요.

사용 가능한 도구

getTopQueries

클릭 수 기준 상위 검색 쿼리를 반환합니다.

• 매개변수: startDate (YYYY-MM-DD), endDate (YYYY-MM-DD), rowLimit (선택 사항, 기본값 10)

• 반환값: 각 행에 대한 쿼리, 클릭, 노출, CTR, 순위

getSiteSummary

사이트 전체 검색 실적 합계를 반환합니다.

• 매개변수: startDate (YYYY-MM-DD), endDate (YYYY-MM-DD)

• 반환값: 총 클릭, 노출, CTR, 평균 순위

getPagePerformance

특정 페이지로 필터링된 실적 데이터를 반환합니다.

• 매개변수: pageUrl (GSC에 표시된 정확한 URL), startDate (YYYY-MM-DD), endDate (YYYY-MM-DD)

• 반환값: 해당 페이지의 클릭, 노출, CTR, 순위

getRankingChanges

두 기간 사이의 순위 변동이 가장 큰 페이지를 찾습니다.

• 매개변수: days (비교할 일수, 기본값 28)

• 반환값: 페이지 URL, 순위 변동, 현재 순위, 이전 순위

중요

.env 또는 .tokens.json을 버전 관리 시스템에 커밋하지 마세요. 이 파일들은 .gitignore를 통해 이미 제외되어 있습니다.