Google Search Console MCP Server

Google Search Console（GSC）MCP 服务 🔍

适用于 Google Search Console 的模型上下文协议（MCP）服务：为 AI Agent 提供搜索表现分析、关键词排名、站点地图检查和索引健康状况。

🌐 在线文档与 Web 门户：https://gsc.builditwithai.xyz

---

⚡ 快速入门

# 1-Line Universal Installer (Auto-configures Claude Desktop, Cursor, Claude Code, Antigravity, VS Code, Zed, Windsurf)
curl -fsSL "https://gsc.builditwithai.xyz/install" | bash

# Or run directly via your preferred runtime:
uvx google-search-console-mcp
npx -y @surendranb/google-search-console-mcp

---

---

🤖 客户端设置

A. Claude Code（CLI）

claude mcp add google-search-console -- uvx google-search-console-mcp

B. Cursor 与 Google Antigravity（mcp.json）

{
  "mcpServers": {
    "google-search-console": {
      "command": "uvx",
      "args": ["google-search-console-mcp"]
    }
  }
}

C. Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "google-search-console": {
      "command": "uvx",
      "args": ["google-search-console-mcp"],
      "env": {
        "GSC_SITE_URL": "https://example.com/",
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service_account.json"
      }
    }
  }
}

D. VS Code（Cline / Roo Code / Continue）

{
  "mcpServers": {
    "google-search-console": {
      "command": "npx",
      "args": ["-y", "@surendranb/google-search-console-mcp"]
    }
  }
}

---

🛠️ 工具与功能

工具名称	参数	描述	返回类型
get_search_analytics	site_url（字符串）、start_date（字符串）、end_date（字符串）、dimensions（列表）、row_limit（整数）	按查询、页面、国家/地区、设备和日期分组，查询自然搜索点击量、展示次数、点击率和平均排名。	JSON / Markdown
list_sites	（无）	列出 Google Search Console 中所有已验证的网站资源及其权限级别。	JSON
inspect_url	site_url（字符串）、inspection_url（字符串）	实时检查 URL 的索引状态、抓取问题、规范化情况和移动设备易用性。	JSON
list_sitemaps	site_url（字符串）	获取所有已提交的 XML 站点地图、上次下载日期和已索引 URL 数量。	JSON
submit_sitemap	site_url（字符串）、feedpath（字符串）	将新的 XML 站点地图直接提交到 Google Search Console。	JSON
delete_sitemap	site_url（字符串）、feedpath（字符串）	从 Search Console 中移除过时或错误的站点地图。	JSON
skill_read	skill_name（字符串）	从 GitHub 动态加载 SEO 专家诊断指南。	Markdown
skills_list	（无）	列出所有当前可用的 GSC 分析技能。	JSON

---

🔒 遥测与隐私

此软件包会收集匿名、非个人身份信息（PII）的诊断遥测数据（命令执行情况、延迟、错误代码），以提升工具的可靠性。我们绝不会收集或存储查询内容、用户凭据、个人数据、源代码或环境变量。

你可以随时设置以下任一环境变量选择退出：

export DO_NOT_TRACK=1
# or
export MCP_TELEMETRY_OPT_OUT=1

---

📄 许可证

MIT 许可证。详情请参阅 LICENSE。