
aminforou/mcp-gsc
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
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_issuesruns concurrently — same fix as #31, so it no longer times out on 10-URL batches againstsc-domain:*properties. Thanks @kuldiph. (#55)- Removed a leftover dead
orderByinget_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_enhancedandbatch_url_inspectionread rich-result issues from the correct API path, so markup problems are reported instead of silently dropped. Thanks @patrickweh. (#46, #48) batch_url_inspectionruns concurrently — 10-URL batches no longer time out onsc-domain:*properties. Thanks @remotesensei. (#31)compare_search_periodsdeltas 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_analyticssorting works —sort_by/sort_directionare 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_inspectionrenames the per-URLverdictfield toindex_verdictto distinguish it from the rich-result verdict.
[0.3.3] — July 2026
- Fixed fresh installs broken by
mcp2.0 — pinnedmcp[cli]<2.0.0. ThemcpSDK 2.0.0 (released 2026-07-28) removed themcp.server.fastmcpmodule, so every freshuvx mcp-search-consoleinstall crashed on startup withModuleNotFoundError: 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
isattyblock that prevented the browser login window from opening when running as an MCP subprocess on macOS. OAuth now works out of the box withuvx, no manual terminal run needed.
설치
docker run \설정
{
"mcpServers": {
"gscServer": {
"command": "/FULL/PATH/TO/uvx",
"args": ["mcp-search-console"],
"env": {
"GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
}
}
}
}