MCP Server Google Search Console

🚀 Google 搜索控制檯 MCP 服務器

這是一個藉助模型上下文協議（MCP）服務器來訪問 Google 搜索控制檯的實用工具。它能幫助用戶獲取搜索分析數據，並進行詳細的數據展示與自定義報告週期分析。

🚀 快速開始

使用此工具，你可以快速獲取 Google 搜索控制檯的相關數據。首先要確保滿足先決條件，然後進行安裝和認證設置，即可開始使用。

✨ 主要特性

• 獲取搜索分析數據（支持維度）
• 詳細的數據顯示與自定義報告週期分析

📦 安裝指南

直接安裝

pip install mcp-server-google-search-console

從源代碼安裝

git clone https://github.com/yourusername/mcp-server-google-search-console.git
cd mcp-server-google-search-console
pip install -e .

開發環境設置（uv）

安裝 uv 和 uvx

pip install uv uvx

創建和管理虛擬環境

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

安裝依賴項

git clone https://github.com/yourusername/mcp-server-google-search-console.git
cd mcp-server-google-search-console
pip install -e .

單獨安裝 MCP 包

pip install "mcp[cli]"

安裝開發依賴項

pip install -e ".[dev]"

💻 使用示例

基礎用法

# 安裝包
pip install mcp-server-google-search-console

# 運行示例
python -m mcp_server.search_console_demo

搜索控制檯 API 調用

1. 安裝依賴項

pip install google-api-python-client google-auth_oauthlib

2. 配置項目

import os
from google.oauth2 import service_account

# 加載服務賬戶憑證
credential_path = os.path.join(os.getcwd(), "service-account.json")
credentials = service_account.Credentials.from_service_account_file(
    credential_path, scopes=["https://www.googleapis.com/auth/searchconsole"])

3. 創建 MCP 服務器

from mcp_server.search_console import SearchConsoleMCP

# 初始化 MCP 服務器
search_console = SearchConsoleMCP(config)

📚 詳細文檔

認證設置

獲取 Google 搜索控制檯 API 憑證：

1. 訪問 Google Cloud Console
2. 創建新項目或選擇現有項目
3. 啟用 API：轉到 "APIs & 服務" > "庫"
4. 創建具有搜索控制檯訪問權限的服務賬戶，並下載 JSON 憑證文件

發佈流程

該項目會在創建 GitHub 發佈標籤時自動發佈到 PyPI。

1. 運行版本更新腳本：

python scripts/bump_version.py [major|minor|patch]

2. 按照顯示的說明推送到 GitHub：

git add pyproject.toml
git commit -m "Bump version to x.y.z"
git tag vx.y.z
git push origin main vx.y.z

3. 在 GitHub 倉庫頁面創建新發布：
   • 選擇標籤：vx.y.z
   • 輸入標題：vx.y.z
   • 填寫發佈說明
   • 點擊 "發佈"
4. GitHub Actions 將被觸發並自動將包發佈到 PyPI。

📄 許可證

本項目採用 MIT 許可證。

貢獻

歡迎大家為項目貢獻代碼！請在提交拉取請求之前閱讀貢獻指南。