Google Search Console을 Claude·Cursor 등 AI 어시스턴트에 연결해 SEO 데이터를 자연어로 분석하는 MCP 서버
중간맛 분석
Python 기반 MCP(Model Context Protocol) 서버로, 20개의 SEO 분석 도구를 제공합니다. uvx(권장) 또는 git 클론으로 설치하며, 또는 서비스 계정 인증을 지원합니다. Claude Desktop·Cursor·Codex ·Gemini 등 모든 MCP 클라이언트에서 작동합니다. 설치 후 즉시 검색 쿼리 분석·색인 상태 확인·사이트맵 관리를 AI와 대화하며 수행할 수 있으며, Cursor Marketplace에서 한 클릭으로 설치 가능합니다.
이런 레포예요
이럴 때 쓰면 좋아요
- AI와 대화하며 SEO 성능 리포트 생성 및 분석
- 상위 검색 쿼리·클릭률·위치를 빠르게 확인하고 개선 기회 발견
- 여러 페이지의 색인 상태를 한 번에 검사하여 문제 파악
핵심 기능
대안 대비 차별점
Google의 공식 Search Console API를 직접 활용하면서 AI 자연어 상호작용을 추가하여, 상용 SEO 도구의 비용과 학습 곡선 없이 실시간 데이터에 접근 가능합니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- Google Cloud 계정 및 Search Console API 활성화
- OAuth 클라이언트 또는 서비스 계정 JSON 자격증명
- Python 3.11 이상 (클론 설치 시만)
바로 차려먹기Python (uv)
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/AminForou/mcp-gsc.git && cd mcp-gsc && uv sync
uv가 없다면: brew install uv · 실행 명령은 README를 확인하세요.
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
-
Google Cloud Console에서 OAuth 또는 서비스 계정 자격증명 JSON 생성 (튜토리얼: https://www.youtube.com/watch?v=vhIOoD7B8Ow)
-
uv 설치
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
echo 'source $HOME/.local/bin/env' >> ~/.zshrc
- uvx로 설치 (권장)
which uvx
- Claude Desktop 설정 (OAuth 예시)
파일 ~/Library/Application Support/Claude/claude_desktop_config.json 편집:
{
"mcpServers": {
"gscServer": {
"command": "/FULL/PATH/TO/uvx",
"args": ["mcp-search-console"],
"env": {
"GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
}
}
}
}
(경로는 which uvx 결과로 교체. 서비스 계정: GSC_CREDENTIALS_PATH와 GSC_SKIP_OAUTH=true 사용)
-
Claude Desktop 완전히 종료 후 재시작
-
Claude에서 테스트
AI 어시스턴트에게 "List my GSC properties" 요청
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try AminForou/mcp-gsc
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2025년 생성
「마케팅·그로스」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/AminForou/mcp-gsc)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기