Wingate SEO MCP

오픈소스, 자체 호스팅 방식의 Google Search Console + Google Analytics 4 MCP 서버로, ChatGPT 및 기타 MCP 클라이언트에서 사용할 수 있습니다. 추가 SEO 대시보드 비용을 지불하지 않고 자체 SEO 데이터를 분석하세요.

Wingate SEO MCP는 MCP 클라이언트를 사용자가 이미 보유한 Google 속성에 연결합니다. Search Console 실적, GA4 참여도, 사이트맵 및 URL 검사 증거, 기간 비교, 결정적 SEO 진단을 하나의 읽기 전용 서비스로 결합합니다.

게시자: Wingnut Innovations
버전: 0.5.1
라이선스: MIT

왜 사용해야 하나요?

• 자연어로 자체 GSC 및 GA4 데이터에 대해 질문하세요.

• 자격 증명과 속성 매핑을 사용자가 제어하는 인프라에 유지하세요.

• 반복적인 대시보드 작업을 재현 가능한 증거와 계산으로 대체하세요.

• 이벤트 활동, 랜딩 페이지 참여도, CTR 개선 기회, 순위 변동, 감소, 키워드 잠식(cannibalization)을 검사하세요.

• 의도적으로 작고 읽기 전용인 보안 경계로 시작하세요.

자체 Google 자격 증명을 제공하고 해당 ID에 분석하려는 속성에만 액세스 권한을 부여합니다. Wingate SEO MCP에는 호스팅 계정, 번들 Google 액세스, 유료 게이트, 원격 측정(telemetry), 광고 또는 구독이 포함되지 않습니다.

Related MCP server: Google SEO MCP

읽기 전용 MCP 도구

공개 서버는 정확히 11개의 도구를 노출합니다:

공개 서버에는 Search Console, Google Indexing, GA4 Admin, 사이트맵 제출 또는 기타 쓰기 도구가 없습니다.

GA4 보고서 품질 진단

GA4 결과에는 반환된 데이터에 대한 증거로 보고서 진단이 포함됩니다. Google은 임계값 적용(thresholding) 또는 샘플링을 적용할 수 있으며, 높은 카디널리티(high-cardinality) 차원은 (other) 행으로 그룹화될 수 있습니다. 제한된 도구 응답은 더 많은 행이 사용 가능한 경우에도 보고하며, 속성 할당량 세부 정보는 정보 제공용일 뿐입니다. 이러한 주의 사항은 추적이 정확하거나 완전하다는 것을 증명하지 않으며, Wingate SEO MCP는 Google의 보고 동작을 우회할 수 없습니다.

ga4_overview는 추가 MCP 도구 없이 선택적으로 세션 수준 트래픽 획득 증거를 추가할 수 있습니다:

{
  "siteKey": "example-site",
  "days": 28,
  "includeAcquisition": true,
  "acquisitionLimit": 25
}

기본 개요는 획득 요청을 하지 않으며 acquisition: null을 반환합니다. 활성화하면 acquisition은 세션 기본 채널 그룹 및 세션 소스/매체별로 행을 그룹화하고, 개요와 동일한 날짜 범위와 googleOrganicOnly 범위를 사용하며, 1-100행으로 제한됩니다. 해당 reportDiagnostics는 잘림, 임계값 적용, 샘플링 및 할당량 주의 사항을 노출합니다. GA4 획득 기여는 Search Console 기여와 동일하지 않습니다.

요구 사항

• Node.js 20, 22 또는 24

• npm

• 필수 API가 활성화된 Google Cloud 프로젝트

• GSC 및 GA4 속성에 대한 액세스 권한이 있는 사용자 제공 Google 서비스 계정 JSON 자격 증명

• 로컬 Streamable HTTP 엔드포인트에 연결할 수 있는 MCP 클라이언트

빠른 시작

git clone https://github.com/aitradesniper-blip/wingate-seo-mcp-public.git wingate-seo-mcp
cd wingate-seo-mcp
npm install

.env.example을 템플릿으로 사용하고 명령을 시작하는 셸에 동일한 환경 변수를 설정하세요. 프로젝트는 .env를 자동으로 로드하지 않습니다. 다운로드한 서비스 계정 JSON은 저장소 외부에 보관하세요.

GOOGLE_SERVICE_ACCOUNT_FILE=/absolute/path/to/google-service-account.json
WINGATE_SITES_FILE=./config/sites.local.json

npm start로 시작된 MCP 런타임은 명시적 서비스 계정 자격 증명을 요구합니다. GOOGLE_SERVICE_ACCOUNT_FILE(권장), GOOGLE_APPLICATION_CREDENTIALS 또는 GOOGLE_SERVICE_ACCOUNT_JSON을 설정하세요. 연결된 Google Cloud 메타데이터/워크로드 ID로 대체되지 않습니다.

자격 증명을 검증하고 액세스 가능한 속성을 확인하세요:

npm run doctor
npm run discover:google

검색에서 반환된 속성을 사용하여 Git에서 무시되는 로컬 사이트 레지스트리를 생성하세요:

npm run setup -- --output config/sites.local.json \
  --gsc sc-domain:example.com \
  --ga4 123456789 \
  --origin https://example.com \
  --key example-site \
  --name "Example Site"

제한된 실시간 읽기를 실행한 다음 서버를 시작하세요:

npm run live:smoke -- --site example-site --inspect-origin
npm start

기본 엔드포인트는 다음과 같습니다:

http://127.0.0.1:3000/healthz
http://127.0.0.1:3000/mcp

자세한 안내는 Google 설정 및 실시간 온보딩을 참조하세요.

Google API 설정

Google Cloud 프로젝트에서 다음 API를 활성화하세요:

• Google Search Console API

• Search Console URL Inspection API

• Google Analytics Data API

• Google Analytics Admin API

각 Search Console 속성에 서비스 계정 이메일 액세스 권한을 부여하고 각 GA4 속성에 최소 Viewer 액세스 권한을 부여하세요. 런타임은 다음만 요청합니다:

• https://www.googleapis.com/auth/webmasters.readonly

• https://www.googleapis.com/auth/analytics.readonly

Analytics Admin API는 액세스 가능한 GA4 속성과 웹 스트림을 검색하는 데만 사용됩니다. MCP 서버는 GA4 Admin 설정을 수정하지 않습니다.

사이트 매핑

각 로컬 레지스트리 항목은 안정적인 siteKey를 하나의 Search Console 속성, 선택적 GA4 속성 및 사이트의 오리진(origin)에 매핑합니다. 형식은 config/sites.example.json을 복사하거나 npm run setup을 실행하여 config/sites.local.json을 생성하고 검증하세요.

로컬 레지스트리는 Git에서 무시됩니다. 저장소를 읽는 사람이 운영 중인 사이트를 알 수 없어야 한다면 실제 속성 매핑을 커밋하지 마세요.

MCP 클라이언트 연결

서버를 시작하고 Streamable HTTP를 지원하는 MCP 클라이언트를 로컬 /mcp 엔드포인트에 연결하세요. 클라이언트가 지원하는 로컬 연결 또는 독립적으로 검토된 전송 경계를 사용하세요. 이 저장소는 인터넷 터널 또는 인증 계층을 제공하지 않습니다.

데이터를 보내기 전에 도구 검색을 확인하고 정확히 11개의 도구가 있으며 모든 도구가 읽기 전용으로 표시되었는지 확인하세요. MCP 클라이언트 연결을 참조하세요.

예시 질문

• "이번 달에 클릭이 감소한 페이지는?"

• "CTR이 낮은 4~20위 쿼리를 찾아줘."

• "참여도가 가장 높은 유기적 랜딩 페이지는?"

• "리드 이벤트가 발생했나요?"

• "최근 28일을 이전 28일과 비교해줘."

개인정보 및 보안

Wingate SEO MCP에는 공개되지 않은 원격 측정이 없습니다. Wingnut Innovations 또는 제3자에게 사용 분석을 전송하지 않습니다.

데이터가 사용자의 머신 또는 서버를 벗어나는 경우는 다음 경우뿐입니다:

• 커넥터가 사용자가 구성한 자격 증명과 속성 액세스 권한을 사용하여 Google API를 호출하는 경우, 또는

• 구성된 MCP 클라이언트가 이 서버에 요청을 보내고 결과를 수신하는 경우.

서버는 기본적으로 127.0.0.1에 바인딩됩니다. 독립적으로 검토된 인증 및 전송 경계를 추가하지 않고 공개 인터넷에 직접 노출하지 마세요. 자격 증명, 로컬 레지스트리 또는 명령 출력을 프롬프트나 소스 제어에 넣지 마세요. SECURITY.md를 참조하세요.

문제 해결

• 자격 증명 파일을 읽을 수 없음: 절대 경로를 사용하고 JSON을 저장소 외부에 보관하세요.

• Google에서 403 오류: 관련 API를 활성화하고 서비스 계정 이메일에 속성 액세스 권한을 부여하세요.

• GA4 속성을 찾을 수 없음: 최소 Viewer 액세스 권한을 부여한 후 npm run doctor를 다시 실행하세요.

• 모호한 매핑: --ga4를 명시적으로 제공하세요. 검색은 약한 일치 항목을 자동으로 선택하지 않습니다.

• 이벤트 행 없음: GA4가 해당 날짜/필터 범위에서 일치하는 행을 관찰하지 못했습니다. 부재 자체만으로 계측을 진단하지 않습니다.

• MCP 클라이언트가 연결할 수 없음: npm start, /healthz, 루프백 바인딩, 클라이언트의 로컬 네트워크 또는 별도로 보안된 전송 구성을 확인하세요.

개발 및 검증

npm run ci

이 명령은 구문 검사, TypeScript 검사, 단위/통합 테스트, 프로덕션 빌드 및 MCP 검색을 실행합니다. CI는 Node.js 20, 22, 24를 대상으로 합니다.

Docker 패키징은 작고 검토 가능한 이미지와 비루트(non-root) 런타임 정책이 준비될 때까지 의도적으로 연기됩니다. Node/npm 자체 호스팅 경로가 v0.5.0 기준입니다.

로드맵 및 지원

로드맵을 참조하세요. Wingate SEO MCP는 무료 오픈소스입니다. 시간이나 SEO 도구 구독 비용을 절약해 준다면 지속적인 개발을 선택적으로 지원할 수 있습니다. v0.5.0에는 펀딩 제공자가 구성되어 있지 않습니다.

라이선스, 출처 및 독립성

Wingate SEO MCP는 MIT 라이선스에 따라 라이선스가 부여됩니다. 선택된 Google 클라이언트 및 메서드 매핑은 UPSTREAM.md, UPSTREAM_IMPORT_MANIFEST.json 및 THIRD_PARTY_NOTICES.md에 문서화된 고정된 MIT 라이선스 업스트림에서 각색 및 상당 부분 재작성되었습니다.

Wingate SEO MCP는 Wingnut Innovations가 게시한 독립 프로젝트입니다. Google 또는 OpenAI와 제휴, 보증 또는 후원 관계가 없습니다. Google Search Console, Google Analytics, GA4, ChatGPT 및 OpenAI는 각 소유자의 상표입니다.