Google Search Console API + SEO Semantic Lab — пошаговое подключение данных о поисковой видимости Google: запросы, показы, клики, CTR и средняя позиция, сохранение в общий SEO-проект и использование для оценки посадочных страниц. Эта инструкция относится именно к встроенной API-интеграции во вкладке «Фразы», а не к отдельному веб-интерфейсу сервиса.
Для получения данных нужен доступ к своему сайту или счётчику и разрешённая авторизация соответствующего аккаунта. Данные чужого сайта без предоставленных прав не загружаются. Доступность источника, полнота статистики и набор полей зависят от аккаунта, периода и ограничений API.
Что даёт подключение Google Search Console через API
Google Search Console показывает результативность своего сайта в поиске Google. Это фактические, но агрегированные показатели за выбранный период, а не прогноз частотности и не абсолютная проверка позиции на конкретном устройстве. После загрузки в SEO Semantic Lab запросы можно сопоставлять с существующей семантикой, группировать, фильтровать и искать темы с показами, но недостаточным количеством кликов.
| Показатель | Что означает | Как использовать в SEO-проекте |
|---|---|---|
| Показы | Сколько раз результат сайта показывался в Google в рамках отчёта | Искать спрос и страницы, которые уже имеют видимость |
| Клики | Переходы из результатов Google в рамках выбранных параметров | Приоритизировать работающие запросы, а не оценивать продажи |
| CTR | Отношение кликов к показам; зависит от выдачи и интента | Отбирать гипотезы улучшения сниппета после проверки позиции и формата результатов |
| Средняя позиция | Усреднённый показатель Search Console, а не точная позиция в фиксированном TOP | Сопоставлять динамику и смотреть слабые группы без подмены SERP |
Перед подключением: необходимые условия
- Откройте проект в SEO Semantic Lab и проверьте основной домен.
- Убедитесь, что используемый аккаунт Google имеет права к нужному ресурсу (property) Google Search Console.
- Проверьте, какой тип ресурса зарегистрирован: доменный (Domain property) или URL-prefix с конкретной схемой и адресом; выбор не должен случайно относиться к другому поддомену.
- Подготовьте период для анализа. Сравнения между датами выполняйте только при сопоставимых настройках типа поиска и источника.
Как импортировать данные GSC в SEO Semantic Lab
- Откройте вкладку «Фразы» → разверните блок «Интеграции с API» → откройте «GSC».
- Нажмите «Подключить аккаунт». Авторизуйте доступ к разрешённому Google-аккаунту, следуя действиям приложения. Подключение не предоставляет доступа к чужим сайтам.
- Выберите точное свойство Search Console. Обратите внимание на Domain property и URL-prefix: при неверном свойстве возможны пустые или несопоставимые выборки.
- В поле «Тип:» выберите необходимый тип поиска. Если нужно охватить несколько типов, изучите переключатель соответствующего охвата — не смешивайте несопоставимые показатели разных типов в одном аналитическом выводе.
- Установите верхний период во вкладке «Фразы», проверьте параметры history/snapshot при необходимости сохранения истории загрузки.
- Для расширения семантики нажмите «Загрузить фразы из GSC». Если ядро уже сформировано и добавлять новые запросы не нужно, нажмите «Обновить данные по моим фразам».
- После завершения обновите таблицу «Фразы», проверьте значения, наличие новых запросов, источник и период. На тестовом проекте сохраните резервную копию перед массовым объединением.
Что выбрать: новые запросы или обновление существующих
| Ваша задача | Правильное действие в программе | Ограничение |
|---|---|---|
| Расширить семантику фактическими запросами своего сайта | «Загрузить фразы из GSC» | API может вернуть только часть доступных строк, не все поисковые запросы |
| Дополнить текущие кластеры показами и кликами | «Обновить данные по моим фразам» | Запросы, которых ещё нет в проекте, не добавляются этим действием |
| Проверить действительную текущую выдачу и URL-лидеров | Перейти в «SERP+Позиции» и выполнить отдельный сбор TOP | GSC не предоставляет набор URL всех конкурентов для кластеризации |
Практические сценарии: CTR, точки роста и поисковые интенты
Запросы с показами, но без достаточного количества кликов
Сначала проверьте среднюю позицию, тип запроса и актуальную SERP-выдачу. Информационный запрос «как сделать аудит сайта» и коммерческий «заказать SEO-аудит» могут иметь разную кликабельность и требуют разных посадочных. Низкий CTR сам по себе не доказывает плохой Title: на выдачу влияют блоки ответов, реклама, позиция, устройства и брендовый спрос.
Кластер есть, но Google показывает другой URL
Сверьте собственные URL и запросы с реестром URL и запланированной структурой. При расхождении проверьте релевантность посадочной, дубли, canonical, H1, доступность страницы и конкуренцию интентов. GSC не заменяет live-crawl и отдельный SERP для URL-кластеризации.
Сравнение Google с Яндексом
В объединённом проекте Google Search Console дополняет Яндекс.Вебмастер и Яндекс.Метрику. Не складывайте напрямую клики GSC, клики Вебмастера и визиты Метрики: они основаны на разных событиях, фильтрах, периодах и методиках.
Ограничения, ошибки и проверка результатов
- Аккаунт подключён, но ресурса нет: проверьте права к property и тип ресурса, затем повторите выбор.
- Нет строк: проверьте дату, тип поиска, доступ и наличие данных. «Пусто» не означает отсутствие спроса в поисковой системе.
- Показатели не совпадают с интерфейсом Google: сравните фильтры, интервал и способы группировки данных.
- Объём фраз меньше ожидаемого: официальный Search Analytics API не гарантирует выдачу всех строк и может отдавать приоритет наиболее значимым. Не называйте импорт полной базой всех запросов Google.
- Позиции отличаются от проверочного сервиса: GSC — средняя агрегированная позиция, а сервис съёма SERP фиксирует отдельное время, поисковик, гео и устройство.
- Безопасность: не публикуйте OAuth-токены, списки клиентских свойств и непубличные данные в скриншотах или логах.
Частые вопросы
Нужно ли вручную выгружать CSV из GSC?
Нет, для описанного сценария программа использует API-интеграцию. При отсутствии доступа или сбое можно пользоваться доступными ручными импортами, но это отдельный путь.
Нужно ли давать SEO Semantic Lab полный доступ ко всем сайтам Google?
Нужна авторизация аккаунта с правами к выбранному property. Конкретный запрашиваемый scope и фактические разрешения проверяйте при подключении; не передавайте доступы сторонним лицам ради теста.
Могу ли я по GSC сразу кластеризовать фразы?
Фразы можно подготовить, но надёжная кластеризация по URL-лидерам требует данных выдачи с адресами результатов по запросам. Импорт GSC не является заменой этого этапа.
Источники: официальный Search Analytics API и OAuth-авторизация Google. Названия действий в SEO Semantic Lab сверены с внутренней документацией версии 1.0.0.36; работу конкретного дистрибутива и доступы пользователя требуется проверять отдельно.
