gsc-mcp

Google Search Console 데이터에 직접적이고 읽기 전용으로 접근할 수 있는 무료 오픈소스 Model Context Protocol 서버입니다. Claude(또는 다른 MCP 클라이언트 -- ChatGPT, Codex, Cursor)가 검색 분석(클릭수/노출수/CTR/순위), 사이트맵 상태, URL 검사 기능을 사용할 수 있게 해줍니다.

GrowthLever가 만든 이유는, 마케터로서 저는 Google 제품들(Search Console, GA4, Ads 포함)의 인터페이스가 마음에 들지 않기 때문입니다. 이 도구를 사용하면 원시 데이터 위에 제 나름의 변환 레이어를 얹고, Google UI를 뒤지는 대신 Claude에게 직접 인사이트를 요청할 수 있습니다. 무료인 이유는 도구 자체가 제품이 아니라, 그 위에서 실행하는 워크플로우가 제품이기 때문입니다(이 페이지 하단 참조).

나만의 Google 자격 증명 사용

이 서버는 전적으로 여러분의 머신에서 실행되며, 여러분이 자신의 Google Cloud 계정에서 직접 만든 Google OAuth 클라이언트를 사용합니다. 리프레시 토큰은 여러분의 디스크를 절대 떠나지 않으며, Search Console 데이터가 GrowthLever가 운영하는 서버를 통과하는 일은 없습니다. 저희에게 계정을 만들 필요도, 가입할 것도, 신뢰할 것도 없습니다. 자세한 내용은 SECURITY.md와 PRIVACY.md를 참조하세요.

Related MCP server: Google Search Console Audit MCP

제공 기능

네 가지 읽기 전용 도구:

여기서 Search Console 설정을 변경하거나 무엇이든 제출/삭제할 수 없습니다 -- 모든 호출은 GET 또는 읽기 전용 query/inspect 요청입니다.

시작하기

QUICKSTART.md -- 10분 설정, 대부분은 Google 콘솔을 기다리는 시간입니다. 요약:

npx -y @growthlever/gsc-mcp auth --credentials ~/Downloads/client_secret.json
npx -y @growthlever/gsc-mcp doctor

그런 다음 Claude 설정을 npx -y @growthlever/gsc-mcp로 지정하고(examples/claude-desktop-config.json에 예시 있음), 무언가를 물어보세요 -- PROMPTS.md에서 스타터 팩을 확인하세요. 제로에서 시작하는 창업자용과 성장 단계에서 최적화하는 스케일업용으로 나뉘어 있습니다.

문제가 있나요? 먼저 gsc-mcp doctor를 실행한 다음 TROUBLESHOOTING.md를 확인하세요.

로컬 개발

npm install
node bin/gsc-mcp.js auth --credentials <path to client_secret.json>
node bin/gsc-mcp.js doctor
node bin/gsc-mcp.js            # runs the MCP server over stdio
node test/smoke.js             # spawns the server and verifies tool registration

문서

• QUICKSTART.md -- 처음부터 끝까지 설정

• PROMPTS.md -- 스타터 프롬프트 팩

• SECURITY.md -- 이 도구가 접근하는 것, 할 수 없는 것, 접근 권한을 취소하는 방법

• PRIVACY.md -- 수집되는 것(없음)과 데이터를 보는 사람

• TROUBLESHOOTING.md -- 일반적인 Google/OAuth 오류에 대한 쉬운 해결 방법

• examples/ -- Claude Desktop 및 Codex CLI용 설정, 주간 리뷰 프롬프트 템플릿

왜 무료인가

저는 프랙셔널 Head of Growth입니다 -- 제가 대화하는 대부분의 창업자와 운영자는 처음부터 시작하는 분들이고, 마케팅을 배우려고 사업을 시작한 게 아닙니다. 초기 최선의 선택은 거의 항상 유기적 기반을 다지면서 추천과 입소문이 나머지를 채우게 하는 것입니다. 유료 채널에 쓸 예산이 아직 없기 때문입니다. 스케일업 기업은 다른 문제가 있습니다: 어떤 페이지와 콘텐츠가 실제로 효과가 있는지 파악해서 추측 대신 집중 투자하는 것입니다.

어느 쪽이든, 장애물은 보통 데이터 접근이 아닙니다 -- Search Console은 무료입니다 -- 데이터를 "다음에 무엇을 할까"로 변환하는 것입니다. 이 도구와 적절한 프롬프트가 바로 그 역할을 합니다. 도구를 무료로 제공하는 이유는 도구를 만드는 것이 어렵지 않기 때문입니다. 출력 결과로 무엇을 할지에 대한 판단이 실제 가치가 있는 부분이고, 그것이 제가 글을 쓰고 구독자에게 더 깊이 다루는 내용입니다.

적용 레이어가 필요하다면 -- 사용 사례별 프롬프트 팩, 주간 리뷰 및 고객 보고 템플릿, 이 도구가 기반으로 하는 창업자/스케일업 워크플로우 -- Substack에서 확인하세요(구독자 콘텐츠).

라이선스

MIT. 포크하고, 자체 호스팅하고, 그 위에 구축하세요.