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.0
라이선스: MIT

사용 이유

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

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

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

• 이벤트 활동, 랜딩 페이지 참여도, CTR 기회, 순위 변동, 감소, 카니발리제이션을 검사하세요.

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

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

읽기 전용 MCP 도구

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

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

요구 사항

• Node.js 20, 22 또는 24

• npm

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

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

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

빠른 시작

git clone https://github.com/wingnutinnovations-tech/wingate-seo-mcp.git
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로 시작된 v0.5.0 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 속성 및 사이트의 오리진에 매핑합니다. 형식은 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 패키징은 작고 검토 가능한 이미지와 비루트 실행 정책이 준비될 때까지 의도적으로 연기됩니다. 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는 각 소유자의 상표입니다.