Google Search Console MCP Server Ns9

🚀 Google 搜索控制檯 MCP 服務器

這是一個提供 Google Search Console API 的 MCP 服務器，可無縫集成到 n8n 工作流中的 MCP 客戶端節點，為您的搜索數據管理帶來便利。

🚀 快速開始

本服務器可提供 Google Search Console API，用於 n8n 工作流中的 MCP 客戶端節點。以下是使用該服務器的基本步驟。

✨ 主要特性

• 列出所有搜索控制檯站點
• 獲取搜索分析數據
• 查看頂級搜索詞和頁面
• 檢查 URL 索引狀態
• 查詢站點地圖信息

📦 安裝指南

手動安裝

1. 確保服務器上已安裝 Python 3.7+。
2. 克隆倉庫：

   git clone https://github.com/yourusername/google-search-console-mcp.git
   cd google-search-console-mcp
   

3. 創建虛擬環境並安裝依賴項：

   python3 -m venv .venv
   source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate
   pip install -r requirements.txt
   

4. 將腳本設置為可執行：

   chmod +x google_search_console_server.py
   chmod +x setup-credentials.sh
   

5. 設置服務賬戶憑證：

   ./setup-credentials.sh
   

   您可以使用現有的服務賬戶憑證文件，或者直接粘貼 JSON。

自動安裝

要進行完全自動安裝，也可以使用 install.sh 腳本：

chmod +x install.sh
./install.sh

📚 詳細文檔

Google API 憑證

使用現有服務賬戶

如果您已經擁有一個服務賬戶（例如用於 Google Ads），可以重複使用它來處理搜索控制檯：

1. 運行設置腳本：./setup-credentials.sh
2. 選擇選項 1 或 2 來輸入現有的憑證
3. 將服務賬戶電子郵件地址添加到您的 Search Console 屬性的用戶中：
   • 轉到 Google 搜索控制檯
   • 選擇屬性
   • 點擊設置 > 用戶和權限
   • 添加服務賬戶電子郵件地址作為用戶

創建新服務賬戶

如果沒有服務賬戶：

1. 轉到 Google Cloud Console
2. 創建新項目或使用現有項目
3. 啟用 Google Search Console API
4. 創建一個服務賬戶
5. 下載 JSON 憑證文件
6. 使用設置腳本來配置憑證：./setup-credentials.sh

與 n8n 一起使用

基本配置

1. 打開 n8n 並在工作流中添加一個 MCP 客戶端（STDIO）節點
2. 配置憑證：
   • 命令：/pad/naar/.venv/bin/python （例如 /home/username/google-search-console-mcp/.venv/bin/python)
   • 參數：/pad/naar/google_search_console_server.py（例如 /home/username/google-search-console-mcp/google_search_console_server.py)
   • 環境：

     SERVICE_ACCOUNT_JSON=/pad/naar/service_account_credentials.json
     

示例：獲取頂級搜索詞

1. 在工作流中添加一個 MCP 客戶端節點
2. 選擇操作“執行工具”
3. 選擇工具：get_top_queries
4. 參數：

   {
     "site_url": "sc-domain:example.com",
     "start_date": "2023-01-01",
     "end_date": "2023-01-31"
   }
   

可用工具

• list_sites：列出所有搜索控制檯站點
• get_search_analytics：獲取搜索分析數據
• get_top_queries：獲取頂級搜索詞
• inspect_url：檢查 URL 索引狀態
• get_sitemap_info：獲取站點地圖信息

安全性

• 服務賬戶憑證在本地保存並避免推送到 Git（通過 .gitignore）
• 總是將 credentials.json 文件放在安全的位置
• 只給需要的服務賬戶授與搜索控制檯屬性的訪問權限

📄 許可證

本項目採用 MIT 許可證。

💡 貢獻說明

歡迎提交拉取請求。對於較大的更改，請先打開問題討論您想要更改的內容。