GSC-MCP

원격 MCP 서버, Google Search Console 데이터를 Claude, ChatGPT, Cursor에서 사용할 수 있게 해주는 — 제한된 API 대신 Google의 전체 데이터 내보내기 기반.

도메인: gsc2mcp.drossmedia.de · 운영: netcup Root Server, 뉘른베르크, Cloudflare 앞단

상태: 구현 시작됨. 네트워크 독립적인 핵심 로직은 테스트된 패키지(core, analytics, db, gsc-client)와 MCP 서버(apps/app) 및 동기화 워커(apps/worker)의 골격이 준비되어 있습니다. 네트워크 측 연결 — MCP 전송, OAuth 제공자, Google 연동 —은 도메인과 GCP OAuth 클라이언트가 준비되면 로드맵의 Phase 0/1에 따라 진행됩니다.

개요

Search Console API는 엄격히 제한되어 있습니다: 16개월 기록, 요청당 25,000행, 검색 유형당 하루 약 50,000행. 시장에 있는 모든 도구는 예외 없이 이 API를 사용합니다 — 이후 데이터를 저장하는 도구도 마찬가지입니다. 따라서 표본만 저장하게 됩니다.

Google의 Bulk Data Export에는 이러한 제한이 없습니다: 완전한 검색 데이터, 매일, API 할당량 없음, 무제한 보관 가능. 부족한 것은 그 외의 모든 것입니다 — 인터페이스 없음, 분석 없음, 에이전트 접근 없음.

GSC-MCP는 바로 이 격차를 메우고 결정론적 분석 엔진을 추가합니다: 변경 기여도, 계절 조정 이상 탐지, 사이트 자체 CTR 곡선, 잠식 시계열. 수치는 계산 가능하며 추정치가 아닙니다.

차이가 얼마나 큰지는 측정되었습니다: sc-domain:aip.aero에서 상위 100개 검색어가 차지하는 클릭 비율은 **8.3%**에 불과합니다 — 약 92%의 활동은 행 제한이 있는 도구가 보여주는 범위 밖에 있습니다.

Related MCP server: searchconsole-mcp

문서

간략한 아키텍처

Claude / ChatGPT / Cursor
        │  Streamable HTTP + OAuth 2.1
        ▼
   Cloudflare (TLS, DDoS, WAF, Rate Limiting)
        │
        ▼
   netcup Root Server · Nürnberg
     Caddy → app (MCP + OAuth AS) · web · worker
     PostgreSQL 17 (Warehouse, pg-boss, Rate-Budget)
        │
        ├──▶ Search Console API      (einmaliger 16-Monats-Backfill)
        └──▶ BigQuery Bulk Export    (laufend, vollständig, ohne API-Quote)

두 번째 호스트 이름 gsc2mcp-direct.drossmedia.de는 Cloudflare 없이 서버에 직접 연결됩니다 — 조달 과정에서 미국 데이터 처리업체를 허용하지 않는 고객을 위해, 그리고 프록시 장애 시 대체 경로로 사용됩니다.

프로젝트 구조

Monorepo, npm 워크스페이스, TypeScript strict, Vitest.

표준 DDL은 packages/db/migrations/0001_init.sql에 있으며 실제 PostgreSQL에 대해 검증됩니다; docs/03에서 그 이유를 설명합니다.

개발

npm install
npm run typecheck   # tsc --build über alle Packages
npm test            # Vitest über packages/*/test und apps/*/test

CI (GitHub Actions)는 추가로 실제 PostgreSQL에 대한 마이그레이션, 개념 문서(링크, 일관성), 그리고 두 테마의 개요 페이지를 검사합니다. docs/10-repo-struktur.md 및 CLAUDE.md를 참조하세요.

다음 단계

중요 경로는 코드가 아니라 민감한 범위 webmasters.readonly에 대한 Google OAuth 인증입니다 — 일반적으로 몇 주가 소요되며 도메인과 개인정보처리방침이 필요합니다. 자세한 내용은 docs/02-auth.md 및 docs/09-roadmap.md를 참조하세요.

Phase 2 이전에는 Bulk Data Export가 어디로 전달될지 결정해야 합니다 — 고객의 BigQuery 프로젝트 또는 우리의 프로젝트. 이에 대한 고려 사항은 docs/12-wettbewerb-usp.md에 있습니다.