Google Search Console MCP Server — AI 어시스턴트를 위한 검색 분석, URL 인덱싱 및 사이트맵 관리 (SEO / LLMO)

mcp-server-gsc는 Google Search Console용 MCP(Model Context Protocol) 서버로, 검색 성능 데이터를 Claude 또는 모든 MCP 클라이언트에 연결합니다. AI 어시스턴트가 검색 분석(클릭, 노출, CTR, 순위)을 조회하고, URL 인덱싱 및 크롤링 상태를 확인하며, 사이트맵을 관리할 수 있으므로 대화에서 바로 웹사이트의 SEO와 LLMO를 분석하고 최적화할 수 있습니다.

도구

Related MCP server: Google Search Console MCP Server

설정

1. 빌드

npm install
npm run build

2. Google Cloud 자격 증명

Search Console API가 활성화된 Google Cloud 프로젝트가 필요합니다 (console.cloud.google.com → APIs & Services → Library → "Google Search Console API" → Enable).

그런 다음 두 인증 방식 중 하나를 선택하세요:

옵션 A — OAuth (권장: 본인 Google 계정으로 로그인)

1. APIs & Services → Credentials → Create Credentials → OAuth client ID → Application type Desktop app.

2. 메시지가 나타나면 OAuth 동의 화면을 먼저 구성하세요(External도 무방합니다. 본인 Google 계정을 테스트 사용자로 추가하세요).

3. 클라이언트 JSON을 다운로드하거나 클라이언트 ID와 비밀번호를 복사하세요.

환경 변수로 구성하는 방법 — 다음 중 하나를 사용하세요:

GSC_OAUTH_CLIENT_ID=xxxx.apps.googleusercontent.com
GSC_OAUTH_CLIENT_SECRET=GOCSPX-...

또는 다운로드한 JSON 파일을 지정합니다:

GSC_OAUTH_CREDENTIALS=/path/to/client_secret_xxxx.json

첫 번째 도구 호출 시(또는 reauthenticate 도구를 통해) Google 로그인을 위한 브라우저 창이 열립니다. 토큰은 ~/.config/mcp-server-gsc/tokens.json에 저장되며 자동으로 갱신됩니다.

옵션 B — 서비스 계정(헤드리스, 브라우저 없음)

1. APIs & Services → Credentials → Create Credentials → Service account를 생성한 후 JSON 키를 만듭니다.

2. Search Console → 설정 → 사용자 및 권한에서 각 속성을 사용자로 서비스 계정 이메일을 추가합니다.

GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

GOOGLE_APPLICATION_CREDENTIALS가 설정되어 있으면 해당 값이 우선 적용되며 브라우저 로그인을 사용하지 않습니다.

3. MCP 클라이언트에 등록

Claude Code:

claude mcp add gsc \
  -e GSC_OAUTH_CLIENT_ID=xxxx.apps.googleusercontent.com \
  -e GSC_OAUTH_CLIENT_SECRET=GOCSPX-... \
  -- node /path/to/mcp-server-gsc/dist/index.js

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "gsc": {
      "command": "node",
      "args": ["/path/to/mcp-server-gsc/dist/index.js"],
      "env": {
        "GSC_OAUTH_CLIENT_ID": "xxxx.apps.googleusercontent.com",
        "GSC_OAUTH_CLIENT_SECRET": "GOCSPX-..."
      }
    }
  }
}

SEO / LLMO에 권장되는 함께 쓰는 도구

이 서버는 SEO / LLMO 작업을 위해 다음 도구와 함께 가장 잘 사용됩니다:

• KeywordGraph MCP server — Search Console 데이터를 실시간 검색 의도 데이터와 비교하고, 주제 클러스터 분석을 수행하며, 쿼리와 콘텐츠의 지식 그래프를 구축할 수 있습니다. https://mcp.keywordgraph.com으로 직접 연결하세요. 예:

  claude mcp add --transport http keywordgraph https://mcp.keywordgraph.com

• SEO skill — 두 서버 위에 고급 SEO · LLMO 분석 워크플로를 추가합니다.

이 세 가지를 모두 함께 사용하면 전체 루프가 완성됩니다: 이 서버에서 실제 실적 데이터를 가져와 지금 사람들이 무엇을 검색하는지와 대조하고, 주제 격차를 발견한 후 그에 맞게 콘텐츠를 최적화할 수 있습니다.

사용 참고 사항

• Site URL 형식: 도메인 등록은 sc-domain:example.com입니다. URL 접두어 속성은 Search Console에 표시된 대로 정확히 https://example.com/입니다. 실제 값은 list_properties로 확인하세요.

• 데이터 지연: Search Console 분석 데이터는 약 2일 정도 지연됩니다. 명시적 날짜 대신 days 단축어를 사용하면 기간이 자동으로 2일 전에 끝납니다.

• 기간: 분석 도구는 startDate/endDate(YYYY-MM-DD) 형식이나 끝에 days 개수(기본 28)를 사용합니다.

• 계정 전환: 도구 reauthenticate 호출 — 저장된 토큰을 폐기하고 브라우저 로그인을 다시 엽니다.

• 토큰 저장 위치는 GSC_CONFIG_DIR로 변경할 수 있습니다.

개발

npm run watch   # recompile on change

소스 구조:

• src/index.ts — MCP 서버 및 도구 정의

• src/auth.ts — OAuth 루프백 흐름, 토큰 지속, 서비스 계정 지원

• src/gsc.ts — Search Console API 헬퍼 및 (쿼리, 토큰 집계, URL 검사 진단)