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監査用のModel Context Protocol (MCP) サーバーです。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

1つまたは複数のURLのインデックス登録状況、クロール情報、正規URL、robots.txtの確認

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

オールインワンレポート：サイトマップの健全性、インデックス状況、正規URLの不一致、パフォーマンス概要

認証

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

trueに設定するとOAuthをスキップし、サービスアカウントのみを使用します

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/Web監査のモック呼び出しを含む、全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