MCP Server Gsc

🚀 Google搜索控制檯 MCP 服務器

本項目是一個模型上下文協議（MCP）服務器，它能夠提供Google搜索控制檯的訪問權限，助力用戶獲取和分析搜索相關數據。

🚀 快速開始

本服務器可提供Google搜索控制檯的訪問權限，能幫助用戶進行維度分析數據檢索和豐富的數據分析。

✨ 主要特性

• 支持維度的分析數據檢索。
• 具備豐富的數據分析功能，支持自定義報告週期。

📦 安裝指南

先決條件

• Node.js 18 或更高版本。
• 啟用 Google Cloud 項目中的搜索控制檯 API。
• 擁有具有搜索控制檯訪問權限的服務賬戶憑證。

安裝步驟

使用 Smithery 安裝

通過 Smithery 自動安裝 Claude Desktop 中的Google搜索控制檯：

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

手動安裝

npm install mcp-server-gsc

📚 詳細文檔

認證設置

獲取 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 許可證。

貢獻

歡迎貢獻！在提交拉取請求之前，請閱讀我們的貢獻指南。