多账户谷歌搜索控制台服务

一个支持多账户管理的谷歌搜索控制台(GSC)模型上下文协议(MCP)服务器,适用于代理机构、SEO专业人员或需要管理多个属性的用户。

  • by MattiooFR
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 MattiooFR/mcp-gsc-multi-account

使用说明

MCP GSC多账户

用于Google搜索控制台的模型上下文协议(MCP)服务器 多账户支持.

从单个MCP服务器管理多个GSC帐户。非常适合代理商、SEO专业人员或管理多个物业的任何人。

特性

  • 🔄 多账户 -动态切换帐户
  • 📊 搜索分析 -使用正则表达式过滤最多25000行
  • 🎯 速赢检测 -自动识别SEO机会
  • 📈 期间比较 -比较时间段之间的性能
  • 🔍 URL检查 -检查任何URL的索引状态
  • 📤 URL索引 -通过索引API提交用于索引的URL
  • 🗺️ 网站地图管理 -列出并提交网站地图

安装

npm install mcp-gsc-multi-account

或者直接运行:

npx mcp-gsc-multi-account

配置

所需的环境变量

GOOGLE_GSC_CLIENT_ID=your-client-id.apps.googleusercontent.com
GOOGLE_GSC_CLIENT_SECRET=your-client-secret

帐户配置

选项1:单一账户(简单)

GSC_REFRESH_TOKEN=1//your-refresh-token
GSC_EMAIL=user@gmail.com  # optional, defaults to "default"

选项2:通过JSON创建多个帐户

GSC_ACCOUNTS_JSON='{"accounts":[{"id":"main","email":"main@gmail.com","refreshToken":"1//..."},{"id":"client1","email":"client@gmail.com","refreshToken":"1//..."}]}'

选项3:通过文件创建多个帐户

GSC_ACCOUNTS_FILE=/path/to/accounts.json

accounts.json格式:

{
  "accounts": [
    {
      "id": "main",
      "email": "main@gmail.com",
      "refreshToken": "1//..."
    },
    {
      "id": "client1",
      "email": "client@gmail.com",
      "refreshToken": "1//..."
    }
  ]
}

选项4:运行时注册

使用 register_account 运行时添加帐户的工具:

{
  "tool": "register_account",
  "arguments": {
    "id": "newclient",
    "email": "newclient@gmail.com",
    "refreshToken": "1//..."
  }
}

MCP配置

克劳德桌面/光标

{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "mcp-gsc-multi-account"],
      "env": {
        "GOOGLE_GSC_CLIENT_ID": "your-client-id",
        "GOOGLE_GSC_CLIENT_SECRET": "your-secret",
        "GSC_ACCOUNTS_FILE": "/path/to/accounts.json"
      }
    }
  }
}

麦克波特

{
  "mcpServers": {
    "gsc": {
      "command": "npx -y mcp-gsc-multi-account",
      "env": {
        "GOOGLE_GSC_CLIENT_ID": "your-client-id",
        "GOOGLE_GSC_CLIENT_SECRET": "your-secret",
        "GSC_REFRESH_TOKEN": "1//your-token"
      }
    }
  }
}

可用工具

账户管理

注册_帐户

在运行时注册新帐户。

  • id (必填):唯一标识符
  • email (必填):谷歌帐户电子邮件
  • refreshToken (必需):OAuth2刷新令牌

list_计数

列出所有注册帐户。

list_网站

列出帐户可访问的所有网站。

  • account (可选):帐户ID或电子邮件

搜索分析

搜索分析

获取搜索性能数据。

  • siteUrl (必填):站点URL(例如。, https://example.com 或 sc-domain:example.com)
  • startDate (必填):开始日期(YYYY-MM-DD)
  • endDate (必填):结束日期(YYYY-MM-DD)
  • account (可选):要使用的帐户
  • dimensions (可选):查询、页面、国家、设备、日期
  • rowLimit (可选):最多25000行
  • pageFilter, queryFilter, countryFilter, deviceFilter
  • filterOperator:等于,包含,包括正则表达式,不包括正则表达式

detect_quick_wins

寻找SEO优化机会——关键词排名4-20,展示率高,点击率低。

  • siteUrl, startDate, endDate (必填)
  • minImpressions (默认值:100)
  • maxCtr (默认值:3.0%)
  • positionRangeMin/Max (默认值:4-20)
  • limit (默认值:50)

比较时段

比较两个时间段之间的指标。

  • siteUrl (必填)
  • currentStartDate, currentEndDate (必填)
  • previousStartDate, previousEndDate (必填)
  • dimensions (可选)

网址管理器

inspect_url

检查URL索引状态。

  • siteUrl, inspectionUrl (必填)

submit_url_for_indexing

提交Google索引的URL(需要启用索引API)。

  • url (必填)
  • type:URL_UPDATED(索引)或URL_DELETED(删除)

网站地图

list_sitemaps

列出站点的站点地图。

  • siteUrl (必填)

提交站点地图

提交站点地图。

  • siteUrl, feedpath (必填)

获取OAuth凭据

  1. 首选 谷歌云控制台
  2. 创建或选择项目
  3. 启用 搜索控制台API 和 API索引
  4. 首选 凭证 → 创建凭据 → OAuth 2.0客户端ID
  5. 应用程序类型: 桌面应用程序
  6. 下载凭据

获取刷新令牌

使用Google OAuth Playground或运行:

npx -y google-search-console-mcp-server google-search-console-mcp-setup

例子

"List my GSC accounts"

"Show quick wins for https://example.com using the main account"

"Compare last 7 days vs previous 7 days for sc-domain:example.com"

"Submit https://example.com/new-article for indexing"

"Get top 100 queries for https://example.com from 2024-01-01 to 2024-01-31"

许可证

麻省理工学院

贡献

欢迎投稿!请先阅读投稿指南。