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

Ручная проверка страниц в 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. Зайдите на https://search.google.com/search-console.
2. Нажмите «Добавить свойство».
3. Выберите:
   • URL-префикс: https://example.com/ (рекомендуется — точнее).
   • Или Домен: sc-domain:example.com.
4. Подтвердите права владения (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 иногда просит верификацию).
• Рекомендации:
  1. Создавайте проект и ключ через VPN (Европа/США).
  2. Запускайте скрипты с VPS за пределами РФ.
  3. Дальше сервис-аккаунт работает без ручного входа.

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

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

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

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

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

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

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