mcp-gsc

DigestSEO 오픈소스 SEO 도구 모음의 일부입니다.

• 제품: digestseo.com/gsc-mcp

• 지원: digestseo.com/support

• 개인정보: digestseo.com/privacy

셀프 호스팅 런처는 @digestseo/mcp-gsc로 제공됩니다:

npx -y @digestseo/mcp-gsc

Google OAuth 및 Cloudflare 배포 구성에 대해서는 SETUP.md를 따르세요.

30초 만에 연결하기

배포된 모든 인스턴스는 동일한 엔드포인트 형태를 노출합니다:

https://<your-worker>.workers.dev/mcp

DigestSEO 호스팅 인스턴스는 다음에서 사용할 수 있습니다:

https://mcp-gsc.digestseo.com/mcp

Claude Code

claude mcp add --transport http gsc https://<your-worker>.workers.dev/mcp

Cursor

ChatGPT — 사용자 지정 커넥터로 추가하세요. 아래의 AI 클라이언트에서 연결을 참조하세요.

Google Search Console용 셀프 호스팅 가능한 Model Context Protocol(MCP) 서버입니다. Claude.ai, Cursor, ChatGPT 또는 MCP 호환 클라이언트에 연결하고 AI 어시스턴트에게 내 사이트의 유기적 검색 성과(노출, 클릭, 상위 쿼리, 색인 상태, 사이트맵 상태)를 내 Google 계정에서 직접 물어보세요.

Cloudflare Workers에서 실행되며 원클릭 Google OAuth 온보딩이 포함되어 있습니다: 클라이언트에서 서버를 연결하고, Google로 한 번 로그인하고, 요청된 Google Search Console 권한을 승인하면 끝입니다. 복사할 API 키도, 관리할 서비스 계정 JSON도 없습니다.

설정이 전혀 필요 없으신가요? 호스팅 버전 — 매주 이메일로 자동 전송되는 주간 다이제스트 포함 — 은 digestseo.com 에서 제공됩니다. 이 저장소는 직접 실행할 수 있는 오픈소스 코어입니다.

도구

기본적으로(GSC_ACCESS_MODE=readwrite) 이 서버는 17개의 도구를 노출합니다. 읽기 전용 분석 및 보고 도구는 MCP의 readOnlyHint로 표시됩니다. 아래의 쓰기 도구는 Search Console 속성, 사이트맵 또는 색인 상태를 변경할 수 있습니다. GSC_ACCESS_MODE=readonly로 설정하면 Search Console 읽기 전용 범위만 요청하고 12개의 읽기 전용 도구만 노출합니다.

읽기-쓰기 모드는 Google Search Console 읽기-쓰기 및 Indexing API 범위를 요청합니다. 읽기 전용 모드는 https://www.googleapis.com/auth/webmasters.readonly(및 openid, email)만 요청하며 5개의 쓰기 도구를 등록하지 않습니다. 기존 배포가 현재 동작을 유지하도록 읽기-쓰기가 기본값으로 유지됩니다. 사용자를 연결하기 전에 모드를 선택하려면 SETUP.md를 참조하세요.

indexing.request 자격 요건. Google의 Indexing API는 일반적인 페이지 제출 도구가 아닙니다 — 현재 기준으로 Google 자체 문서는 이 API를 두 가지 콘텐츠 유형으로 제한합니다: JobPosting 구조화 데이터가 있는 페이지와 VideoObject 내에 중첩된 BroadcastEvent 구조화 데이터가 있는 라이브스트림 페이지. 제출 전에 서버는 대상 URL을 가져와 JSON-LD에서 두 유형 중 하나를 확인합니다. 둘 다 없으면(또는 페이지를 가져올 수 없으면) Indexing API를 호출하는 대신 URL이 부적격한 이유를 설명하는 오류를 반환합니다. 성공적인 제출은 Google이 알림을 받았다는 확인일 뿐이며 URL이 색인된다는 보장은 아닙니다.

Related MCP server: gsc-mcp

무엇을 물어볼 수 있나요

연결이 완료되면 어시스턴트에게 다음과 같은 질문을 할 수 있습니다:

• "지난 28일 동안 클릭 수 기준 상위 20개 쿼리는 무엇인가요?"

• "이번 달 example.com의 노출을 지난달과 비교해 주세요 — 어떤 페이지가 하락했나요?"

• "https://example.com/pricing이 색인되었나요? 마지막 크롤링은 언제였나요?"

• "내 블로그가 5~15위에 랭크되는 쿼리는 무엇인가요? 그게 내 퀵 윈이에요."

• "오늘로 끝나는 sc-domain:example.com의 주간 다이제스트를 만들어 주세요."

• "내 사이트맵 중 오류나 경고가 있는 것이 있나요?"

• "쿼리에 정규식을 사용하여 내 클릭을 브랜드 vs 비브랜드로 나눠 주세요."

• "Google Discover에서 내 사이트 성과는 일반 웹 검색과 비교해 어떤가요?"

AI 클라이언트에서 연결

서버를 배포한 후(SETUP.md 참조) Worker의 /mcp URL을 클라이언트에 붙여넣어 연결하세요:

https://<your-worker>.workers.dev/mcp

• Claude.ai — 설정 → 커넥터 → 사용자 지정 커넥터 추가 → /mcp URL을 붙여넣으세요. Client ID와 Client Secret은 비워 두세요. 처음 사용 시 Claude가 Google 로그인 흐름을 열고, 배포에서 요청한 액세스를 승인하면 커넥터가 녹색으로 전환됩니다.

• Cursor — 동일한 /mcp URL을 가리키는 사용자 지정 MCP 서버로 추가하세요.

• ChatGPT(커넥터/MCP 지원 포함) — /mcp URL로 사용자 지정 커넥터를 추가하세요.

MCP 호환 클라이언트는 모두 작동합니다 — 모두 동일한 /mcp 엔드포인트를 가리키고 동일한 OAuth 흐름을 공유합니다.

설정

셀프 호스팅은 자체 Google OAuth 자격 증명과 Cloudflare 계정을 가져와야 함을 의미합니다. 복사해서 붙여넣을 수 있는 전체 가이드는 SETUP.md 에 있습니다 — Google의 OAuth 검증과 앱이 검증되지 않은 동안의 7일 리프레시 토큰 제한에 대한 중요한 참고 사항도 포함되어 있습니다.

간단한 구조:

git clone https://github.com/<you>/mcp-gsc.git
cd mcp-gsc
npm install
cp wrangler.example.jsonc wrangler.jsonc       # then paste in your KV ids
# set GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET / TOKEN_ENCRYPTION_KEY as secrets
# choose GSC_ACCESS_MODE=readonly in wrangler.jsonc for a read-only deployment
npm run deploy

모든 단계를 자세히 보려면 SETUP.md 를 참조하세요.

개발

npm install
npm test              # typecheck + offline unit tests (what CI runs)
npm run dev           # wrangler dev (local)
npm run test:smoke    # structural smoke tests against a deployment

기여를 환영합니다 — CONTRIBUTING.md를 참조하세요.

라이선스

MIT © 2026 DigestSEO.

digestseo.com의 제작자 Tomi Šeregi가 구축하고 유지 관리합니다 — 비기술적 사이트 소유자를 위한 주간 SEO 다이제스트.