AI导哈

搜索控制台数据分析工具

一个MCP服务器，为AI助手提供对Google搜索控制台数据的只读访问，支持通过自然语言查询网站搜索性能数据。

  • by chrishart0
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 chrishart0/searchconsole-mcp

使用说明

搜索控制台mcp

一 主控程序 服务器，为AI助手提供对Google Search Console数据的只读访问权限。用自然语言询问有关网站搜索性能的问题——关键字、点击、展示、点击率、排名、网站地图等。

工具

工具 说明
list_sites 列出所有已验证的Search Console属性及其权限级别
query_search_analytics 查询关键字/页面数据——点击次数、展示次数、点击率、平均位置。支持按维度、日期范围、搜索类型和分页进行筛选
list_sitemaps 列出已提交的物业站点地图

快速开始

1.安装

git clone https://github.com/chrishart0/searchconsole-mcp.git
cd searchconsole-mcp
uv sync

2.身份验证

此服务器使用 Google应用程序默认凭据。选择一个：

选项A——服务帐户密钥 （建议用于自动化）：

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json

选项B——用户凭据 （建议当地发展）：

gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/webmasters.readonly"

服务帐户或用户必须有权访问要查询的Search Console属性。

3.连接到您的MCP客户端

Claude Code

增添 ~/.claude.json:

{
  "mcpServers": {
    "searchconsole-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/searchconsole-mcp", "searchconsole-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/key.json"
      }
    }
  }
}
Claude Desktop

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "searchconsole-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/searchconsole-mcp", "searchconsole-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/key.json"
      }
    }
  }
}
Other MCP clients

任何兼容MCP的客户端都可以通过stdio连接。使用以下命令运行服务器：

uv run --directory /path/to/searchconsole-mcp searchconsole-mcp

示例提示

连接后，尝试询问您的AI助手：

  • “本月点击量最高的10个关键词是什么？”
  • “显示展示率高但点击率低的页面”
  • “列出我的所有搜索控制台属性”
  • “我的网站在谷歌第2页的排名是什么？”
  • “显示我的网站地图及其状态”

发展

uv sync --dev
uv run pytest

许可证

麻省理工学院

相关 MCP