MCP Server Gsc

🚀 Google検索コンソールMCPサーバー

Google検索コンソールへのアクセス権を提供するモデルコンテキストプロトコル（MCP）サーバーです。

✨ 主な機能

• 次元別の分析データ検索をサポート
• 豊富なデータ分析機能を備え、カスタムレポート周期に対応

📦 インストール

Smitheryを使用したインストール

Smithery を通じて、Claude Desktop内でGoogle検索コンソールを自動インストールします。

npx -y @smithery/cli install mcp-server-gsc --client claude

手動インストール

npm install mcp-server-gsc

📚 ドキュメント

前提条件

• Node.js 18以上
• Google Cloudプロジェクトで検索コンソールAPIを有効にする
• 検索コンソールへのアクセス権を持つサービスアカウントの認証情報を持っていること

認証設定

Google検索コンソールAPIの認証情報を取得する手順は以下の通りです。

1. Google Cloud Consoleにアクセス
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択
3. APIを有効にする：
   • "APIs & Services" > "Library"に移動
   • "Search Console API"を検索して有効にする
4. 認証情報を作成する：
   • "APIs & Services" > "Credentials"に移動
   • "Create Credentials" > "Service Account"をクリック
   • サービスアカウントの詳細を入力
   • 新しいJSON形式のキーを作成
   • 認証情報ファイル（.json）が自動的にダウンロードされる
5. アクセス権を付与する：
   • 検索コンソールを開く
   • サービスアカウントのメールアドレス（形式：name@project.iam.gserviceaccount.com）をプロパティ管理者として追加

使用方法

Claude Desktopの設定

{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "mcp-server-gsc"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

利用可能なツール

search_analytics

Google検索コンソールから検索パフォーマンスデータを取得し、カスタムパラメータをサポートします。

必須パラメータ：

• siteUrl：ウェブサイトのURL（形式：http://www.example.com/ または sc-domain:example.com）
• startDate：開始日（YYYY-MM-DD）
• endDate：終了日（YYYY-MM-DD）

オプションパラメータ：

• dimensions：カンマ区切りのリスト（query,page,country,device,searchAppearance）
• type：検索タイプ（web, image, video, news）
• aggregationType：集計方法（auto, byNewsShowcasePanel, byProperty, byPage）
• rowLimit：返される最大行数（デフォルト：1000）

例：

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,country",
  "type": "web",
  "rowLimit": 500
}

📄 ライセンス

MIT

貢献

貢献を歓迎します！プルリクエストを送信する前に、貢献ガイドをご確認ください。