Repolode
AminForou

AminForou/mcp-gsc

Google Search Console 데이터를 Claude, Cursor, Codex 같은 AI assistant에 연결해 자연어로 SEO를 분석하는 MCP 서버입니다.

스타
1,984
포크
276
열린 이슈
15
마지막 커밋
지난달

어떤 프로젝트인가요?

mcp-gsc는 Google Search Console을 AI assistant에 연결하는 Model Context Protocol(MCP) 서버입니다. Claude Desktop, Cursor, Codex CLI 또는 Gemini CLI 같은 클라이언트에 설정하면 어떤 검색어가 트래픽을 유도하는지, 어떤 페이지의 클릭 수가 줄었는지처럼 사이트 검색 실적에 관한 질문을 일상적인 언어로 할 수 있습니다.

이 서버는 속성 관리, 국가·기기·검색어·페이지별 필터를 적용한 검색 분석, 기간별 실적 비교, 색인 상태 확인을 위한 URL 검사, 최대 10개 URL의 일괄 확인, 사이트맵 조회 및 제출 등 약 20개의 도구를 제공합니다. 인증은 개인 Google 계정을 사용하는 OAuth 데스크톱 클라이언트 또는 자동화와 팀 사용을 위한 서비스 계정으로 처리할 수 있습니다. 사이트나 사이트맵 삭제 같은 파괴적 작업은 명시적으로 활성화하지 않는 한 비활성화되어 있습니다.

서버는 기본적으로 로컬에서 stdio를 통해 실행되며, 원격 사용을 위해 Docker로 SSE를 통해 배포할 수도 있습니다.

핵심 기능

  • 01국가, 기기, 검색어, 페이지별 필터와 정렬을 사용해 검색 분석 데이터를 조회합니다.
  • 02두 날짜 범위의 실적을 비교합니다.
  • 03단일 또는 일괄 방식으로 URL 색인 상태와 리치 결과 문제를 확인합니다.
  • 04사이트맵을 조회하고, 검사하고, 제출합니다.
  • 05개인 계정용 OAuth와 자동화용 서비스 계정을 지원합니다.
  • 06파괴적 작업을 수행하는 도구는 기본적으로 비활성화되어 있습니다.

활용 사례

  • AI assistant에 사이트의 주간 SEO 실적 요약을 요청합니다.
  • 여러 페이지가 경쟁하는 검색어를 찾아 어떤 페이지를 유지할지 결정합니다.
  • 중요한 페이지 여러 개의 색인 문제를 점검합니다.
  • 노출은 많지만 CTR이 낮은 검색어를 찾아 제목을 개선합니다.

빠른 시작

  1. 1

    uv를 설치합니다(설치 프로그램 실행).

    README의 공식 안내에 따라 설치
  2. 2

    Google API 사용자 인증 정보(OAuth 클라이언트 또는 서비스 계정)를 만들고 JSON 파일을 저장합니다.

  3. 3

    사용자 인증 정보 파일을 지정해 uvx 서버 설정을 AI 클라이언트(예: Claude Desktop)에 추가합니다.

  4. 4

    클라이언트를 다시 시작한 뒤 GSC 속성 목록을 요청합니다.

사용 전 알아둘 점

  • 사용하려면 Google Cloud 사용자 인증 정보를 설정하고 Search Console API를 사용 설정해야 합니다.
  • README에서 사용자 수가 제한된 유료 호스팅 버전을 홍보합니다.

토픽

자주 묻는 질문

mcp-gsc은(는) 무엇인가요?
Google Search Console 데이터를 Claude, Cursor, Codex 같은 AI assistant에 연결해 자연어로 SEO를 분석하는 MCP 서버입니다. mcp-gsc는 Google Search Console을 AI assistant에 연결하는 Model Context Protocol(MCP) 서버입니다. Claude Desktop, Cursor, Codex CLI 또는 Gemini CLI 같은 클라이언트에 설정하면 어떤 검색어가 트래픽을 유도하는지, 어떤 페이지의 클릭 수가 줄었는지처럼 사이트 검색 실적에 관한 질문을 일상적인 언어로 할 수 있습니다.
mcp-gsc은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
mcp-gsc은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
mcp-gsc은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. mcp-gsc의 마지막 커밋은 2026년 9월 15일입니다.
mcp-gsc은(는) 어디에 사용할 수 있나요?
AI assistant에 사이트의 주간 SEO 실적 요약을 요청합니다. 여러 페이지가 경쟁하는 검색어를 찾아 어떤 페이지를 유지할지 결정합니다. 중요한 페이지 여러 개의 색인 문제를 점검합니다. 노출은 많지만 CTR이 낮은 검색어를 찾아 제목을 개선합니다.
mcp-gsc는 어떻게 설치하나요?
uv를 설치합니다(설치 프로그램 실행). Google API 사용자 인증 정보(OAuth 클라이언트 또는 서비스 계정)를 만들고 JSON 파일을 저장합니다. 사용자 인증 정보 파일을 지정해 uvx 서버 설정을 AI 클라이언트(예: Claude Desktop)에 추가합니다. 클라이언트를 다시 시작한 뒤 GSC 속성 목록을 요청합니다.
mcp-gsc은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/AminForou/mcp-gsc

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트