Добавить в корзинуПозвонить
Найти в Дзене
Vibecode Wiki

Как подключить Google Search Console по API: полное пошаговое руководство для автоматизации индексации и диагностики сайта

Ручная проверка страниц в search.google.com уже не справляется с большими сайтами. Если новые статьи не попадают в индекс Google, а в отчёте «Покрытие» висит «Обнаружено, но не проиндексировано» — самое время настроить Search Console API. Это открывает возможности: Важное предупреждение сразу Search Console API не принудительно индексирует обычные страницы (статьи, товары, блог). Indexing API Google работает только для страниц с разметкой JobPosting или BroadcastEvent (видеотрансляции). Для всех остальных сайтов API даёт только диагностику, отправку sitemap и аналитику. Email сервис-аккаунта (обязательно скопируйте!): gsc-api-bot@your-project-id.iam.gserviceaccount.com Промпт №1. Проверка подключения «У меня в корне проекта лежит файл gsc-key.json. Это сервисный ключ для Google Search Console API. Проверь полное подключение: выведи список всех доступных property, к которым есть доступ. Если ошибки (403, NO_SITES_VISIBLE, insufficient permission и т.д.) — подробно объясни, что именно ну
Оглавление

Ручная проверка страниц в search.google.com уже не справляется с большими сайтами. Если новые статьи не попадают в индекс Google, а в отчёте «Покрытие» висит «Обнаружено, но не проиндексировано» — самое время настроить Search Console API.

Это открывает возможности:

  • Автоматически отправлять sitemap.
  • Проверять статус любой страницы (индексация, canonical, ошибки обхода).
  • Получать данные по показам, кликам и запросам.
  • Делегировать всю диагностику ИИ (Grok, Claude, GPT и др.).

Важное предупреждение сразу Search Console API не принудительно индексирует обычные страницы (статьи, товары, блог). Indexing API Google работает только для страниц с разметкой JobPosting или BroadcastEvent (видеотрансляции). Для всех остальных сайтов API даёт только диагностику, отправку sitemap и аналитику.

1. Добавление сайта в Search Console

  1. Нажмите «Добавить свойство».
  2. Выберите:URL-префикс: https://example.com/ (рекомендуется — точнее).
    Или
    Домен: sc-domain:example.com.
  3. Подтвердите права владения (HTML-тег, DNS, Google Analytics 4 и т.д.).

2. Подключение API через Service Account

Шаг 1. Создаём проект в Google Cloud

  1. Перейдите в Google Cloud Console.
  2. Нажмите «Выбрать проект» → «Новый проект».
  3. Назовите, например, gsc-api-project. Запомните Project ID.

Шаг 2. Включаем Search Console API

  1. В меню: «API и сервисы» → «Библиотека».
  2. Найдите Google Search Console API
  3. Нажмите «Включить».

Шаг 3. Создаём Service Account и JSON-ключ

  1. «API и сервисы» → «Учётные данные» → «Создать учётные данные» → Service account.
  2. Имя: gsc-api-bot.
  3. Роли можно пропустить (или поставить Viewer).
  4. Нажмите «Готово».
  5. Откройте созданный аккаунт → вкладка «Ключи» → «Добавить ключ» → Создать новый ключJSON.
  6. Скачается файл вида your-project-id-abcdef123456.json.

Email сервис-аккаунта (обязательно скопируйте!): gsc-api-bot@your-project-id.iam.gserviceaccount.com

Шаг 4. Добавляем права в Search Console (самая частая ошибка!)

  1. В Search Console обязательно выберите нужный property в верхнем левом селекторе (https://example.com/).
  2. Настройки (шестерёнка) → Пользователи и разрешенияДобавить пользователя.
  3. Вставьте email сервис-аккаунта.
  4. Роль: Владелец (Owner) — обязательно!
  5. Подождите 3–5 минут.
  6. Повторите для property sc-domain:example.com, если используете оба варианта.

3. Размещаем ключ на сервере

  • Положите JSON-файл вне публичной папки (например /etc/gsc/key.json).
  • Никогда не заливайте в Git!

Готовые промпты для копирования

Промпт №1. Проверка подключения

«У меня в корне проекта лежит файл gsc-key.json. Это сервисный ключ для Google Search Console API. Проверь полное подключение: выведи список всех доступных property, к которым есть доступ. Если ошибки (403, NO_SITES_VISIBLE, insufficient permission и т.д.) — подробно объясни, что именно нужно исправить в Search Console.»

Промпт №2. Отправка sitemap

«Используя ключ gsc-key.json из проекта, отправь актуальный sitemap.xml (и sitemap_index.xml, если есть) для property https://example.com/. После отправки покажи результат и статус.»

Промпт №3. Инспекция одной страницы

«Проинспектируй через Search Console API следующую страницу с помощью ключа gsc-key.json:

https://example.com/novaya-statya

Property: https://example.com/

Выведи полный отчёт: статус индексации, причина (если не проиндексировано), canonical, дата последнего обхода, проблемы и рекомендации.»

Промпт №4. Массовая инспекция страниц

«Проинспектируй через API сразу эти URL для property https://example.com/ (ключ gsc-key.json в проекте):

- https://example.com/statya-1

- https://example.com/statya-2

- https://example.com/statya-3

Для каждой страницы выведи коротко: Индексируется / Не индексируется + главная причина.»

Промпт №5. Полная диагностика, почему сайт не индексируется

«Сделай глубокую диагностику индексации сайта с помощью ключа gsc-key.json.

Property: https://example.com/

Проверь:

- статус всех sitemap

- последние ошибки в Coverage

- 10–15 новых или проблемных страниц

- распространённые причины (noindex, thin content, canonical конфликты, crawl budget и т.д.)

Дай структурированный отчёт с приоритетами и точными рекомендациями по исправлению.»

Промпт №6. Универсальный «сделай всё сразу» (самый удобный)

«Ты теперь мой постоянный помощник по Google Search Console API.

Ключ лежит в файле gsc-key.json в корне проекта.

Основной property: https://example.com/

Сейчас выполни:

1. Проверь доступность API

2. Отправь актуальный sitemap

3. Проинспектируй новые страницы:

4. Дай полный отчёт: что мешает индексации, что нужно поправить в шаблоне, robots.txt или контенте.

Действуй шаг за шагом и выводи всё четко.»

4. Особенности для пользователей из России

  • Сам Search Console API не блокируется по стране.
  • Проблемы могут быть только при создании проекта (Google иногда просит верификацию).
  • Рекомендации:Создавайте проект и ключ через VPN (Европа/США).
    Запускайте скрипты с VPS за пределами РФ.
    Дальше сервис-аккаунт работает без ручного входа.

Оплата карты обычно не требуется.

Лимиты API (актуально на февраль 2026)

  • URL Inspection: 2000 запросов в сутки на property, 600 в минуту
  • Search Analytics: до 50 000 строк данных за один запрос
  • Sitemap submit: без жёстких лимитов

Как использовать промпты максимально эффективно

  • Всегда указывайте точный путь к файлу gsc-key.json и точный property.
  • Ведите одну длинную переписку с ИИ — он будет помнить все предыдущие результаты.
  • После каждого действия просите «сохрани состояние» — так ИИ будет работать быстрее в следующий раз.

Теперь вы можете полностью автоматизировать индексацию и диагностику сайта, не написав ни одной строки кода.

Просто закинули ключ — и кидаете промпты.