AM

aminforou/mcp-gsc

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

2천 stars 267 forks 품질 87 트렌드 41MIT

Claude AI를 통한 구글 서치 콘솔 인사이트(SEO)

개요

Google Search Console(GSC)을 AI 어시스턴트와 연결하여 자연어 대화를 통해 SEO 데이터를 분석할 수 있게 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. , , , 그리고 기타 MCP 호환 클라이언트와 함께 작동합니다. 보다 고급 호스팅 버전으로, 원클릭 로그인, 추가 GA4 도구. 클로드 데스크톱, 클로드 코드, Claude.ai, 코덱스, 커서 및 모든 MCP 클라이언트에서 작동합니다. 오직 . → - — macOS에서 MCP 서브프로세스로 실행 시 브라우저 로그인 창이 열리지 않게 했던 isatty 블록을 제거했습니다. OAuth는 이제 UVX와 함께 기본 작동하여 수동 터미널 실행이 필요 없습니다. - — 이 기능을 호출하면 사용 가능한 도구와 현재 인증 상태를 한 번에 확인할 수 있습니다. AI 어시스턴트가 어떤 도구가 사용 가능한지 확신하지 못할 때 유용합니다. - — 모든 도구가 이제 자격 증명이 누락되었거나 만료되었을 때 무엇을 해야 하는지 정확히 알려줍니다.

개요(AI 번역)

Google Search Console(GSC)을 AI 어시스턴트와 연결하여 자연어 대화를 통해 SEO 데이터를 분석할 수 있게 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. Claude Desktop, Cursor, Codex CLI, Gemini CLI, Antigravity 및 기타 MCP 호환 클라이언트와 호환됩니다.

설정 건너뛰기, 더 보기 보다 고급 호스팅 버전으로, 원클릭 로그인, 추가 GA4 도구. Claude Desktop, Claude Code, Claude.ai, Codex, 커서 및 모든 MCP 클라이언트에서 작동합니다. 좌석 수는 단 100석입니다. → 고급 GSC MCP (호스팅)


새로운 소식

[0.4.1] — 2026년 9월

  • check_indexing_issues 동시 실행 — #31과 동일한 수정으로, 10-URL 배치 시 sc-domain:* 속성에 대해 타임아웃되지 않습니다. 감사합니다@kuldiph. (#55)
  • **get_search_by_page_query에서 남은 죽은 orderBy**를 제거했습니다 (검색 분석 API가 이를 무시함). 감사합니다@kuldiph. (#55)

[0.4.0] — 2026년 9월

  • 리치 결과 이슈가 이제 드러난다 — inspect_url_enhanced와 batch_url_inspection는 올바른 API 경로에서 리치 결과 이슈를 읽어, 마크업 문제가 조용히 삭제되는 대신 보고됩니다. 감사합니다@patrickweh. (#46, #48)

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Google Search Console MCP Server for SEOs

A Model Context Protocol (MCP) server that connects Google Search Console (GSC) to AI assistants, allowing you to analyze your SEO data through natural language conversations. Works with Claude Desktop, Cursor, Codex CLI, Gemini CLI, Antigravity, and any other MCP-compatible client.

Skip setup, get more. A more advanced hosted version — one-click sign-in, added GA4 tools. Works with Claude Desktop, Claude Code, Claude.ai, Codex, Cursor, and any MCP client. Only 100 seats. → Advanced GSC MCP (hosted)


What’s New

[0.4.1] — September 2026

  • check_indexing_issues runs concurrently — same fix as #31, so it no longer times out on 10-URL batches against sc-domain:* properties. Thanks @kuldiph. (#55)
  • Removed a leftover dead orderBy in get_search_by_page_query (the Search Analytics API ignores it). Thanks @kuldiph. (#55)

[0.4.0] — September 2026

  • Rich-result issues now surface — inspect_url_enhanced and batch_url_inspection read rich-result issues from the correct API path, so markup problems are reported instead of silently dropped. Thanks @patrickweh. (#46, #48)
  • batch_url_inspection runs concurrently — 10-URL batches no longer time out on sc-domain:* properties. Thanks @remotesensei. (#31)
  • compare_search_periods deltas fixed — Period 1 is now the analyzed period and Period 2 the baseline, so growth reads as growth (not decline). Thanks @JKdreaming. (#42)
  • get_advanced_search_analytics sorting works — sort_by/sort_direction are now applied instead of silently ignored. Thanks @kuldiph. (#54)
  • Hardened error handling — replaced bare except: clauses so fatal signals aren’t swallowed. Thanks @kuldiph. (#53)
  • Note: batch_url_inspection renames the per-URL verdict field to index_verdict to distinguish it from the rich-result verdict.

[0.3.3] — July 2026

  • Fixed fresh installs broken by mcp 2.0 — pinned mcp[cli]<2.0.0. The mcp SDK 2.0.0 (released 2026-07-28) removed the mcp.server.fastmcp module, so every fresh uvx mcp-search-console install crashed on startup with ModuleNotFoundError: No module named 'mcp.server.fastmcp'. New installs now resolve a working 1.x SDK again — no --with "mcp<2" workaround needed.

[0.3.2] — April 2026

  • OAuth browser flow fixed for uvx — removed the isatty block that prevented the browser login window from opening when running as an MCP subprocess on macOS. OAuth now works out of the box with uvx, no manual terminal run needed.
GitHub에서 전체 README 보기

설치

docker run \
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "gscServer": { "command": "/FULL/PATH/TO/uvx", "args": ["mcp-search-console"], "env": { "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json" } } } }