searchconsole-mcp

MCP-сервер, который автоматизирует Google Search Console для ваших проектов: поисковая аналитика, управление картами сайта, свойствами и проверка URL.

Инструменты

Related MCP server: Google Search Console + GA4 MCP Server

Одноразовая настройка Google

1. В Google Cloud Console создайте проект.

2. Включите Google Search Console API (APIs & Services > Library).

3. Создайте сервисный аккаунт (IAM & Admin > Service Accounts) и скачайте JSON-ключ.

4. Для каждого свойства Search Console: Settings > Users and permissions > Add user, вставьте email сервисного аккаунта (...@...iam.gserviceaccount.com) и предоставьте роль Owner (Owner требуется для API проверки URL).

Конфигурация

Переменные окружения:

Сервер также загружает .env из своей рабочей директории при запуске.

Регистрация в MCP-клиенте

opencode (~/.config/opencode/opencode.json или .opencode/opencode.json в проекте):

{
  "mcp": {
    "searchconsole": {
      "type": "local",
      "command": ["node", "/absolute/path/to/searchconsole-mcp/dist/index.js"],
      "environment": {
        "GSC_SERVICE_ACCOUNT_FILE": "/absolute/path/to/service-account.json",
        "GSC_DEFAULT_SITE": "sc-domain:example.com"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "searchconsole": {
      "command": "node",
      "args": ["/absolute/path/to/searchconsole-mcp/dist/index.js"],
      "env": {
        "GSC_SERVICE_ACCOUNT_FILE": "/absolute/path/to/service-account.json",
        "GSC_DEFAULT_SITE": "sc-domain:example.com"
      }
    }
  }
}

Разработка

npm install
npm run build     # tsc -> dist/
npm start         # run the server on stdio
npm run smoke     # boots the server and lists tools

Примечания

• Данные аналитики отстают на ~2 дня; передайте dataState: "all", чтобы включить свежие неполные данные.

• API ограничивает количество строк аналитики 25 000 на запрос; используйте startRow для постраничной загрузки.

• Добавление сайта через API оставляет его непроверенным, пока владельцем не будет подтверждено право собственности; проще всего сначала добавить email сервисного аккаунта как Owner в интерфейсе.