Searchconsole MCP

搜索控制台mcp

  

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

工具

快速开始

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

许可证

麻省理工学院