Skip to main content
Glama
deenesjakoruzh
GiorgiKemo

mcp-seo-audit

by GiorgiKemo
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

mcp-seo-audit

Google Search Console, Indexing API, Chrome UX Report, PageSpeed Insights, 로컬 Lighthouse, robots.txt 확인, 사이트맵 분석, 페이지 내 SEO 검사, 크롤링 감사 및 라이브 사이트 분석을 포함하는 SEO 감사를 위한 MCP(Model Context Protocol) 서버입니다. Claude Code, Claude Desktop, Cursor 및 모든 MCP 호환 클라이언트와 함께 작동합니다.

AminForou/mcp-gsc에서 포크되었으며, 30개의 도구와 전체 테스트 스위트를 갖춘 더 광범위한 기술 SEO 및 성능 감사 서버로 확장되었습니다.

주요 기능

카테고리

도구

설명

속성 관리

list_properties, add_site, delete_site

GSC 속성 나열, 추가 및 제거

검색 분석

get_search_analytics, get_advanced_search_analytics, get_performance_overview, get_search_by_page_query, compare_search_periods

필터링, 차원 및 기간 비교를 통한 클릭, 노출, CTR, 위치 쿼리

URL 검사

inspect_url, batch_inspect_urls

하나 또는 여러 URL에 대한 색인 생성 상태, 크롤링 정보, 표준(canonical), robots 확인

Indexing API

request_indexing, request_removal, check_indexing_notification, batch_request_indexing

Indexing API를 통해 Google 색인에서 URL 제출/제거

사이트맵

get_sitemaps, submit_sitemap, delete_sitemap

사이트맵 나열, 제출 및 삭제

Core Web Vitals

get_core_web_vitals

Chrome UX Report(CrUX) API를 통한 LCP, FID, CLS, INP, TTFB

성능 감사

get_pagespeed_insights, run_lighthouse_audit

카테고리 점수 및 실패한 감사 요약과 함께 PageSpeed Insights 및 로컬 Lighthouse 감사 실행

기술 SEO

inspect_robots_txt, analyze_sitemap, analyze_page_seo, crawl_site_seo, audit_live_site

robots.txt 검사, 사이트맵 유효성 검사, 페이지 내 SEO 신호 추출, 내부 페이지 크롤링 및 GSC 액세스 없이 라이브 SEO 감사 실행

SEO 분석

find_striking_distance_keywords, detect_cannibalization, split_branded_queries

5-20위 키워드 찾기, 동일한 쿼리에 대해 경쟁하는 페이지 감지, 브랜드 트래픽과 비브랜드 트래픽 분리

사이트 감사

site_audit

올인원 보고서: 사이트맵 상태, 색인 생성 상태, 표준(canonical) 불일치, 성능 요약

인증

reauthenticate

캐시된 OAuth 토큰을 지워 Google 계정 전환

총 30개의 도구.

설정

1. Google API 자격 증명

OAuth (권장)

  1. Google Cloud Console로 이동합니다.

  2. Search Console API 및 Web Search Indexing API를 활성화합니다.

  3. OAuth 2.0 클라이언트 ID(데스크톱 앱)를 생성합니다.

  4. client_secrets.json을 다운로드합니다.

서비스 계정

  1. Google Cloud Console에서 서비스 계정을 생성합니다.

  2. JSON 키 파일을 다운로드합니다.

  3. 서비스 계정 이메일을 GSC 속성에 추가합니다.

2. 설치

git clone https://github.com/GiorgiKemo/mcp-seo-audit.git
cd mcp-seo-audit
python -m venv .venv

# Activate:
# macOS/Linux: source .venv/bin/activate
# Windows:     .venv\Scripts\activate

pip install -r requirements.txt

3. MCP 클라이언트 구성

Claude Code (~/.claude/settings.json)

{
  "mcpServers": {
    "seo-audit": {
      "command": "/path/to/mcp-seo-audit/.venv/bin/python",
      "args": ["/path/to/mcp-seo-audit/gsc_server.py"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/path/to/client_secrets.json",
        "PAGESPEED_API_KEY": "your-google-api-key",
        "CRUX_API_KEY": "your-google-api-key"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json)

동일한 JSON 구조 — 구성 파일 위치는 Claude Desktop MCP 문서를 참조하세요.

4. 선택 사항: 성능 API 키

필드 및 랩 성능 데이터를 보려면 env 블록에 CRUX_API_KEY 및 PAGESPEED_API_KEY를 설정하세요:

"env": {
  "GSC_OAUTH_CLIENT_SECRETS_FILE": "/path/to/client_secrets.json",
  "CRUX_API_KEY": "your-google-api-key",
  "PAGESPEED_API_KEY": "your-google-api-key"
}

GOOGLE_API_KEY를 설정할 수도 있습니다. 서버는 이를 PageSpeed Insights 대체 키로 사용합니다.

환경 변수

변수

필수

기본값

설명

GSC_OAUTH_CLIENT_SECRETS_FILE

OAuth

client_secrets.json

OAuth 클라이언트 비밀 파일 경로

GSC_CREDENTIALS_PATH

서비스 계정

service_account_credentials.json

서비스 계정 키 경로

GSC_SKIP_OAUTH

아니요

false

OAuth를 건너뛰고 서비스 계정만 사용하려면 true로 설정

GSC_DATA_STATE

아니요

all

all = GSC 대시보드와 일치하는 최신 데이터, final = 확정된 데이터(2-3일 지연)

CRUX_API_KEY

아니요

없음

Core Web Vitals(CrUX)용 Google API 키

PAGESPEED_API_KEY

아니요

없음

PageSpeed Insights / Lighthouse API 호출용 Google API 키

GOOGLE_API_KEY

아니요

없음

PAGESPEED_API_KEY의 대체 소스

LIGHTHOUSE_CHROME_PATH

아니요

자동 감지

로컬 Lighthouse CLI를 위한 Chrome/Chromium의 선택적 명시적 경로

예시 프롬프트

"List my GSC properties"
"Show search analytics for cdljobscenter.com last 28 days"
"Find striking distance keywords for my site"
"Detect keyword cannibalization"
"Run a full site audit"
"Check Core Web Vitals for cdljobscenter.com"
"Run PageSpeed Insights for https://example.com"
"Run a local Lighthouse audit for https://example.com"
"Inspect robots.txt for https://example.com"
"Analyze https://example.com/sitemap.xml"
"Analyze on-page SEO for https://example.com/jobs"
"Crawl https://example.com and report duplicate titles"
"Run a live SEO audit for https://example.com"
"Inspect indexing status of these URLs: /jobs, /companies, /pricing"
"Request indexing for https://mysite.com/new-page"
"Compare search performance this month vs last month"

테스트

Google/API/웹 감사 호출을 모의(mock)하여 30개 도구 전체를 다루는 81개의 테스트:

# Activate venv first
python -m pytest test_gsc_server.py -v

변경 사항

  • 30개의 도구 — PSI, 로컬 Lighthouse, robots.txt 검사, 사이트맵 유효성 검사, 페이지 SEO 분석, 크롤링 감사 및 라이브 사이트 감사 추가

  • 7개의 버그 수정 — 정렬 방향 매핑, 오리진/URL 감지, 빈 행 충돌, API 키 유출, 차단 대기, 서비스 캐싱, 재인증 시 오래된 캐시 문제 해결

  • 81개 테스트 QA 스위트 — GSC, CrUX, PSI, Lighthouse CLI, robots, 사이트맵, 크롤링 감사 및 라이브 감사 구성에 대한 커버리지

  • 보안 — 오류 메시지에서 API 키 삭제

  • 성능 — Google API 서비스 객체 캐싱, 차단 대신 비동기 대기, CrUX 필드 데이터 외에 랩 성능 도구 추가

라이선스

MIT. LICENSE를 참조하세요.

AminForou/mcp-gsc 기반.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
B
quality - B tier

How are these scores calculated?

Resources

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/GiorgiKemo/mcp-seo-audit'

If you have feedback or need assistance with the MCP directory API, please join our Discord server