Google Search Console MCP (mcp-gsc)의 개요
Amin Foroutan이 만든 mcp-gsc는 MCP 클라이언트가 Google Search Console을 조회할 수 있게 합니다. 속성 목록 확인, 검색어·페이지·국가·기기별 클릭수, 노출수, 클릭률, 게재순위 조회, 두 기간 비교, 색인 상태·마지막 크롤링·리치 결과를 확인하기 위한 최대 10개 URL 동시 검사, 사이트맵과 그 오류 및 경고 읽기가 가능합니다. 사용자의 컴퓨터에서 stdio로 실행되며, 사용자의 Google OAuth 클라이언트나 서비스 계정으로 로그인합니다.
Google은 Search Console용 MCP 서버를 직접 공개하지 않으므로 이 서버가 이 분야의 기준점입니다. GitHub 스타 약 2,200개, 포크 283개, 지난 한 달간 PyPI에서 mcp-search-console 패키지 다운로드 약 53,000회를 기록했습니다. MIT 라이선스의 Python 프로젝트이며 2026년 11월 6일 버전 0.4.2가 나왔습니다. Google의 Indexing API는 호출하지 않으므로 Google에 페이지 크롤링이나 색인 생성을 요청할 수 없습니다.
Google Search Console MCP (mcp-gsc) 설치 방법
uvx mcp-search-consoleGoogle Search Console MCP (mcp-gsc), 쓸 만한 가치가 있습니까?
mcp-gsc의 쓸모는 SEO 담당자가 이미 Search Console 화면에서 던지는 질문을 모델이 이어서 실행할 수 있는 도구 호출로 바꾼다는 데 있습니다. 두 개의 28일 기간 사이에 클릭이 줄어든 검색어는 무엇인지, 노출은 많은데 2페이지에 머무는 페이지는 어디인지, 중요한 URL 10개가 실제로 색인되어 있는지, Google이 마지막으로 크롤링한 때는 언제인지 같은 질문입니다. 고급 분석은 API의 요청당 25,000행 한도를 넘어 페이지를 넘겨 가며 가져오고, 일괄 검사는 호출 한 번에 최대 10개 URL을 확인합니다.
권한 모델은 이제 올바릅니다. 버전 0.4.2는 GSC_ALLOW_DESTRUCTIVE=true를 설정하지 않는 한 Google의 webmasters.readonly 범위만 요청하며, 설정하면 전체 쓰기 권 한을 요청하고 속성 추가와 삭제, 사이트맵 삭제를 활성화합니다. submit_sitemap 도구는 기본 세트에 남아 있지만 읽기 전용 토큰으로는 Google이 이를 받아들일 근거가 없습니다. 이 릴리스 이전에는 서버가 기본 도구에 필요한 것보다 넓은 권한을 요청했고, 토큰 갱신에 실패하면 저장된 토큰이 삭제될 수 있었습니다. 변경 기록에 따르면 둘 다 수정되었습니다.
주의할 점: 가장 어려운 부분은 설정이며, 이는 Google 쪽 사정입니다. Google Cloud 프로젝트를 만들고 Search Console API를 활성화하고 OAuth 동의 화면을 구성한 뒤 클라이언트 보안 비밀 파일을 내려받거나, 서비스 계정을 만들어 각 속성에 전체 권한으로 추가해야 합니다. README에 단계별 영상이 따로 있는 데는 이유가 있습니다. Python 3.11이 필요하며, Claude Desktop에서는 이전 버전의 Python이 도구도 로그도 없이 조용히 실패합니다. 대형 사이트에서는 Google의 할당량도 걸림돌입니다. URL 검사는 속성당 하루 2,000회, 분당 600회로 제한되므로 모델이 50,000페이지 사이트를 한 번에 감사할 수는 없습니다.
일부 최신 경쟁 서버보다 기능이 적습니다. 오픈 소스 서버에는 Indexing API, Bing Webmaster Tools, GA4가 없으며, 작성자는 이런 기능을 유료 호스팅 버전으로 돌리고 README에 그 배너를 싣고 있습니다. FlorianBruniaux의 google-search-console-mcp 같은 서버는 색인 요청과 Bing을 추가하지만, 그만큼 공격 표면이 넓어집니다.
결론: 검색 데이터의 자격 증명을 쥔 도구에서 가장 중요한 것은 기본 읽기 전용이며, 이 서버는 이제 그것을 제대로 지킵니다. 대부분의 SEO 팀에 필요한 것은 쓰기가 아니라 분석이고, 이 서버는 정확히 그 절충을 택합니다.
제 역할을 하는 곳
2,000페이지 규모 이커머스 사이트의 사내 SEO 담당자
지난달 자연 검색 클릭이 줄어든 이유 찾기
최근 28일과 그 전 28일을 페이지별, 검색어별로 비교하게 한 뒤, 가장 많이 떨어진 10개 페이지의 색인 및 canonical 문제를 검사합니다. 오전 내내 하던 스프레드시트 작업이 몇 번의 프롬프트로 끝나며, API 자체는 무료입니다.
고객 속성 8개를 맡은 프리랜서 SEO 컨설턴트
고객별로 상위권 직전 검색어에 대한 월간 보고서 작성
각 속성에 서비스 계정을 추가하면 에이전트가 8위에서 20위 사이이면서 노출이 많은 검색어를 가져와 권고안을 작성합니다. 잘못된 프롬프트가 고객의 사이트맵을 지우지 못하도록 기본 읽기 전용 범위를 유지합니다.
블로그를 새 프레임워크로 막 옮긴 개발자
핵심 페이지가 색인되었고 사이트맵이 제대로 읽히는지 확인
가장 중요한 URL을 일괄 검사하고 사이트맵 오류 수를 확인합니다. 검사 할당량은 속성당 하루 2,000회로, 작은 사이트의 표본 점검에는 충분합니다.
도입 전 확인할 점
- 설정
- Google Cloud 프로젝트를 만들고 Search Console API와, 데스크톱 OAuth 클라이언트 또는 각 속성에 추가한 서비스 계정을 준비합니다. 그런 다음 GSC_OAUTH_CLIENT_SECRETS_FILE 또는 GSC_CREDENTIALS_PATH와 함께 클라이언트를 uvx mcp-search-console로 지정합니다. 첫 OAuth 실행 때 로그인용 브라우저가 열립니다. 처음에는 20~40분을 예상하십시오.
- 연동
- 속성, 검색 분석, 기간 비교, URL 검사, 사이트맵을 위한 약 20개 도구와 함께 Claude Code 및 Cursor용 플러그인 매니페스트와 Dockerfile이 있습니다. 기본은 stdio이며 원격 사용을 위한 SSE 모드도 있습니다.
- 데이터와 개인정보
- Search Console 데이터는 Google에서 사용자의 컴퓨터로, 다시 모델 제공업체로 전달됩니다. OAuth 토큰은 사용자 설정 폴더에 token.json으로 저장됩니다. SSE 모드는 원격 호스트에 바인딩하면 MCP SDK의 DNS 리바인딩 보호를 끄므로 반드시 별도 인증 뒤에 두어야 합니다.
- 대규모 사용 시 비용
- 무료이며 Search Console API도 요금이 없습니다. 규모가 커지면 돈이 아니라 할당량이 한계입니다. 속성당 하루 2,000회 URL 검사, 사이트당 분당 1,200회 검색 분석 조회입니다.
- 제한
- 검색 분석은 요청당 최대 25,000행을 반환합니다(그 이상은 서버가 페이지를 넘겨 가져옵니다). Indexing API가 없어 크롤링 요청은 불가능합니다. 열린 이슈와 풀 리퀘스트 8건. 서비스 계정은 검사를 위해 각 속성에 전체 권한이 필요합니다.
좋은 점
- 0.4.2부터 기본적으로 읽기 전용 Google 범위
- 기간 비교와 25,000행을 넘는 페이지 넘김
- 최대 10개 URL 일괄 검사
- OAuth 또는 서비스 계정, stdio로 로컬 실행
아쉬운 점
- 첫 조회 전에 Google Cloud 프로젝트와 OAuth 설정 필요
- 무료 서버에는 Indexing API, Bing, GA4 없음
- Python 3.11 이상 필요, 이전 버전은 Claude Desktop에서 조용히 실패
- README가 작성자의 유료 호스팅 버전을 홍보
추천 대상
쓰기 권한을 주지 않고 자신의 Search Console 성과와 색인 데이터를 어시스턴트가 분석하게 하려는 SEO 담당자와 사이트 운영자.
Google Search Console MCP (mcp-gsc) 대안
Google Search Console MCP (mcp-gsc): 자주 묻는 질문
- Google Search Console MCP (mcp-gsc), 쓸 만한 가치가 있습니까?
- 자신의 Search Console 데이터에 질문하려는 SEO 담당자에게는 합리적인 기본 선택이며, 0.4.2부터는 명시적으로 허용하지 않는 한 아무것도 바꿀 수 없습니다. 평점은 5점 만점에 4.2점입니다.
- Google Search Console MCP (mcp-gsc)의 가격은 얼마입니까?
- 무료 오픈 소스(MIT)입니다. Search Console API는 비용이 없습니다. 작성자는 GA4와 키워드 도구를 포함한 별도의 호스팅 버전도 판매하며, 가격은 작성자의 사이트에 나와 있습니다.
- Google Search Console MCP (mcp-gsc)의 단점은 무엇입니까?
- 첫 조회 전에 Google Cloud 프로젝트와 OAuth 설정 필요; 무료 서버에는 Indexing API, Bing, GA4 없음; Python 3.11 이상 필요, 이전 버전은 Claude Desktop에서 조용히 실패; README가 작성자의 유료 호스팅 버전을 홍보.
- Google Search Console MCP (mcp-gsc)에 적합한 사람은 누구입니까?
- 쓰기 권한을 주지 않고 자신의 Search Console 성과와 색인 데이터를 어시스턴트가 분석하게 하려는 SEO 담당자와 사이트 운영자.
- 팀이나 프로덕션 환경에서 Google Search Console MCP (mcp-gsc)의 비용은 얼마입니까?
- 무료이며 Search Console API도 요금이 없습니다. 규모가 커지면 돈이 아니라 할당량이 한계입니다. 속성당 하루 2,000회 URL 검사, 사이트당 분당 1,200회 검색 분석 조회입니다.
- Google Search Console MCP (mcp-gsc)에 회사 데이터를 맡겨도 안전합니까?
- Search Console 데이터는 Google에서 사용자의 컴퓨터로, 다시 모델 제공업체로 전달됩니다. OAuth 토큰은 사용자 설정 폴더에 token.json으로 저장됩니다. SSE 모드는 원격 호스트에 바인딩하면 MCP SDK의 DNS 리바인딩 보호를 끄므로 반드시 별도 인증 뒤에 두어야 합니다.
- Google Search Console MCP (mcp-gsc)의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Firecrawl MCP 및 Google Workspace MCP servers입니다.
답변 확인일: 2026년 11월 13일.
Google Search Console MCP (mcp-gsc) 개발사입니까? 이 평점을 사이트에 표시하십시오
