Google Search Console MCP

English | Русский

A1 Google Search Console MCP는 AI 앱을 Google Search Console에 연결합니다. 검색 실적을 조사하고, URL이 색인되었는지 확인하며, 사이트맵을 검사하고 필요할 때 사이트맵을 의도적으로 제출하거나 제거할 수 있습니다.

이 도구는 Google 계정이 액세스할 수 있는 속성과 함께 작동합니다. 중요한 세부 사항은 정확한 Search Console 속성 값을 사용한다는 점입니다. 도메인 속성과 URL 접두어 속성은 서로 다른 객체입니다.

• 12가지 도구. 일곱 개의 도구는 속성, 검색 데이터, 사이트맵 및 색인 상태를 읽고, 두 개는 속성을 추가하거나 사이트맵을 제출하며, 세 개는 데이터를 제거하거나 임의의 API 메서드를 호출할 수 있습니다.

• 정확한 속성 ID. https://example.com/, https://www.example.com/ 및 sc-domain:example.com은 서로 다릅니다. list_sites가 사용할 값을 보여줍니다.

• 맥락이 포함된 검색 데이터. 날짜, 페이지, 검색어, 국가, 기기 또는 검색 노출 형태별로 클릭수, 노출수, CTR 및 게재순위를 조회합니다.

• 게시가 아닌 색인. URL 검사는 Google의 현재 상태를 설명하며, 페이지를 색인에 강제로 포함시키지 않습니다.

읽기 전용 질문으로 시작하세요:

지난 28일 동안 내 속성의 상위 20개 검색어를 클릭수와 CTR과 함께 보여줘.

서버 연결 · 사용 사례 살펴보기 · 기술 문서 열기

1분 만에 작동 확인하기

사용자: https://example.com/pricing이 색인되었나요? 아니라면 이유는 무엇인가요?

어시스턴트: URL을 검사하여 색인 판정, 커버리지, 크롤링 정보 및 표준 URL을 보여줍니다. 아무것도 변경되지 않습니다.

사용자: 제출된 사이트맵을 확인하고 오류가 있는 사이트맵의 재제출을 준비해 주세요.

어시스턴트: 사이트맵과 경고 및 오류를 보여준 다음, 다시 제출하기 전에 확인을 요청합니다.

사용자: 확인합니다.

어시스턴트: 선택한 사이트맵을 다시 제출합니다. 페이지 콘텐츠를 변경하거나 색인을 보장하지는 않습니다.

Related MCP server: mcp-gsc

목차

• 빠른 시작

• 무엇을 요청할 수 있나요

• Search Console 속성의 작동 방식

• 변경될 수 있는 것

• 액세스 권한 얻기

• 구성

• 데이터, 제한 및 백그라운드 작업

• 기술 문서

• 지원

빠른 시작

Node.js 20+, Search Console 속성에 액세스할 수 있는 Google 계정 및 Google Cloud의 OAuth 자격 증명이 필요합니다.

1. OAuth 액세스를 준비합니다.

2. AI 앱에 서버를 추가합니다.

3. 위의 읽기 전용 질문으로 시작합니다.

앱에서: 설정 → 플러그인 → MCP 서버를 열고 서버 추가를 선택한 다음, GOOGLE_SEARCH_CONSOLE_CLIENT_ID, GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET 및 GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN과 함께 npx -y mcp-google-search-console@latest를 추가합니다.

codex mcp add google-search-console \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_ID=your_client_id \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-search-console@latest
codex mcp list

Codex MCP 문서

claude mcp add \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_ID=your_client_id \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN=your_refresh_token \
  --transport stdio --scope user google-search-console \
  -- npx -y mcp-google-search-console@latest
claude mcp list

Claude Code MCP 문서

설정 → 개발자 → 구성 편집을 열고 추가합니다:

{"mcpServers":{"google-search-console":{"command":"npx","args":["-y","mcp-google-search-console@latest"],"env":{"GOOGLE_SEARCH_CONSOLE_CLIENT_ID":"your_client_id","GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET":"your_client_secret","GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN":"your_refresh_token"}}}}

구성 편집을 사용할 수 없으면 macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json을, Windows에서는 %APPDATA%\Claude\claude_desktop_config.json을 편집합니다.

Claude Desktop MCP 문서

macOS/Linux에서는 ~/.cursor/mcp.json에, Windows에서는 %USERPROFILE%\.cursor\mcp.json에 추가합니다:

{"mcpServers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"],"env":{"GOOGLE_SEARCH_CONSOLE_CLIENT_ID":"your_client_id","GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET":"your_client_secret","GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN":"your_refresh_token"}}}}

Cursor MCP 문서

MCP: Open User Configuration을 실행하고 추가합니다:

{"servers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"],"env":{"GOOGLE_SEARCH_CONSOLE_CLIENT_ID":"${input:gsc_client_id}","GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET":"${input:gsc_client_secret}","GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN":"${input:gsc_refresh_token}"}}},"inputs":[{"type":"promptString","id":"gsc_client_id","description":"Google OAuth client ID"},{"type":"promptString","id":"gsc_client_secret","description":"Google OAuth client secret","password":true},{"type":"promptString","id":"gsc_refresh_token","description":"Google OAuth refresh token","password":true}]}

MCP: List Servers로 확인합니다. VS Code MCP 문서

무엇을 요청할 수 있나요

검색 기회 찾기

• 이번 달에 가장 많은 클릭을 가져온 검색어와 페이지는 무엇인가요?

• 이전 기간과 비교하여 클릭수가 감소한 페이지는 무엇인가요?

• 평균 게재순위가 10 미만인 mcp가 포함된 검색어를 보여주세요.

색인 상태와 사이트맵 확인

• 이 URL이 색인되었나요? 커버리지, 크롤링 및 표준 정보를 보여주세요.

• 제출된 사이트맵 중 오류나 경고가 있는 것은 무엇인가요?

• 이 사이트맵의 현재 상태를 보여준 후 다시 제출하세요.

속성을 신중하게 관리

• 액세스할 수 있는 Search Console 속성을 나열해 주세요.

• 이 정확한 속성 값을 추가하세요. 소유권은 별도로 확인하겠습니다.

• 확인 후 이 속성을 내 계정에서 제거하세요.

Search Console 속성의 작동 방식

URL 접두어 속성은 프로토콜과 끝 슬래시를 포함해야 합니다(예: https://example.com/). 도메인 속성은 sc-domain:example.com으로 작성합니다. 거의 일치하면 403 또는 404가 발생하므로 list_sites가 반환한 정확한 값을 사용하세요.

add_site는 속성만 등록합니다. 검증은 Search Console UI 또는 Site Verification API에서 이루어집니다. 검색 데이터는 태평양 시간을 사용하며, end_date는 포함되며 최종 분석 데이터는 보통 이틀에서 사흘 정도 지연됩니다. data_state: "all"은 더 최신이지만 아직 변동 중인 행을 포함할 수 있습니다.

변경될 수 있는 것

AI 클라이언트가 확인 프롬프트를 제어합니다. 서버는 읽기, 쓰기 및 파괴적 호출을 표시하여 클라이언트가 검사와 실제 변경을 구분할 수 있게 합니다.

액세스 권한 얻기

Search Console 데이터에는 Google OAuth 2.0이 필요하며 API 키만으로는 충분하지 않습니다.

1. Google Cloud 프로젝트를 만들거나 선택하고 Google Search Console API를 사용 설정합니다.

2. OAuth 동의 화면을 구성하고 데스크톱 앱 OAuth 클라이언트를 만듭니다.

3. OAuth 2.0 Playground에서 사용자 고유의 OAuth 자격 증명 사용을 선택하여 속성에 액세스할 수 있는 Google 계정을 인증하고 리프레시 토큰을 얻습니다.

4. https://www.googleapis.com/auth/webmasters를 사용하면 사이트맵과 속성 변경이 포함됩니다. 의도적으로 읽기 전용 액세스만 필요한 경우에만 https://www.googleapis.com/auth/webmasters.readonly를 사용하세요.

테스트 모드의 리프레시 토큰은 7일 후 만료될 수 있습니다. 장기 액세스를 위해 OAuth 앱을 게시하거나 Internal Workspace 앱을 사용하세요. 클라이언트 시크릿과 리프레시 토큰은 비밀번호처럼 취급하세요.

구성

* OAuth 3종 세트 또는 액세스 토큰 중 하나를 제공하세요.

데이터, 제한 및 백그라운드 작업

• 개인정보 보호. 로컬 서버는 Google을 호출하고 설치 ID, 버전 및 도구 이름과 함께 익명 원격 분석을 전송합니다. OAuth 토큰, 속성 데이터, 도구 인수 또는 프롬프트는 절대 전송하지 않습니다. 옵트아웃하려면 ASKADS_TELEMETRY=0을 설정하세요.

• API 제한. URL 검사는 속성당 하루 2,000회, 분당 600회를 허용합니다. 분석은 요청당 최대 25,000행을 반환하며, 롱테일 익명 검색어는 절대 반환되지 않습니다. 페이지네이션을 사용하고 전체 사이트를 URL 하나하나 검사하지 마세요.

• 백그라운드 모니터링 없음. 서버는 호출되는 동안에만 작동합니다. AI 앱이 예약 작업을 지원하면 사이트맵이나 중요한 URL을 주기적으로 확인할 수 있습니다.

기술 문서

• MCP 기능 카탈로그 — 모든 도구에 대한 작업 중심 페이지.

• 모든 도구와 입력

• 개발 문서

• 배포 문서

• Google Search Console API

지원

버그를 찾았거나 시나리오가 필요하신가요? 이슈 만들기를 하거나 Telegram으로 문의하세요.