Настройка Search Insights: пошаговая инструкция
Эта инструкция поможет полностью настроить Search Insights в Baza Helper шаг за шагом. Вам нужны права администратора сайта WordPress и доступ к аккаунту Google, которому принадлежит ресурс Search Console. Настройки находятся в Baza Helper > Search Insights > Settings.
Шаг 1: Создайте сервисный аккаунт в Google Cloud
- Откройте Google Cloud Console и создайте проект или выберите существующий.
- Откройте APIs and services и включите Google Search Console API для проекта.
- Перейдите в IAM and admin > Service accounts и создайте сервисный аккаунт. Подойдёт название baza-helper. Назначать ему роли в Google Cloud не нужно.
- Откройте сервисный аккаунт, перейдите в Keys, выберите Add key > Create new key, укажите JSON и скачайте файл. Не передавайте его посторонним.
Шаг 2: Предоставьте сервисному аккаунту доступ к Search Console
- Скопируйте электронный адрес сервисного аккаунта. Он заканчивается на iam.gserviceaccount.com.
- Откройте Google Search Console и выберите ресурс.
- Перейдите в Settings > Users and permissions и нажмите Add user.
- Вставьте электронный адрес и выберите Restricted, то есть доступ только для чтения. Полный доступ не нужен: Search Insights только читает данные.
Шаг 3: Выберите способ хранения ключа
На вкладке Settings выберите Service account (recommended), затем один из трёх способов хранения ключа:
- Загрузка или вставка ключа. Нажмите Choose the key file (.json) или перетащите скачанный JSON-файл в поле. Файл читается в браузере и сохраняется в зашифрованном виде после нажатия Save changes. Под полем загрузки можно также вставить текст ключа.
- Файл на сервере вне общедоступной папки сайта. Укажите путь к нему в настройках.
- Константа в wp-config.php: BAZA_HELPER_GSC_KEY_FILE для пути к файлу, BAZA_HELPER_GSC_KEY_JSON для самого ключа и BAZA_HELPER_GSC_PROPERTY для ресурса. При таком варианте ключ не попадает в базу данных.
Шаг 4: Выберите ресурс
Укажите ресурс точно так, как он записан в Search Console. Доменный ресурс имеет вид sc-domain:example.com. Ресурс с префиксом URL указывается полным адресом, например https://example.com/. Нажмите Load my properties, чтобы выбрать ресурс из списка доступных аккаунту.
Шаг 5: Проверьте подключение
Нажмите Test the connection. Проверки выполняются последовательно. Если на каком-то этапе возникает ошибка, вы увидите понятное объяснение. Исправьте указанную проблему и повторите проверку.
Другой способ: Google OAuth
- В Google Cloud создайте OAuth-клиент типа Web application.
- Добавьте адрес перенаправления со вкладки Settings в Search Insights в список разрешённых URI перенаправления.
- Укажите Client ID и Client secret в настройках и нажмите Connect with Google.
- На экране согласия Google разрешите чтение данных. Сайт сохраняет только refresh token в зашифрованном виде.
Шаг 6. Настройте ежедневную загрузку данных
- Daily copy: включение или отключение ежедневной загрузки и выбор часа по времени сайта.
- Days for the first fill: от 7 до 485 дней. После первого подключения данные за выбранный период загружаются небольшими порциями.
- Days to keep: от 30 до 485 дней. Более старые строки удаляются.
- Row limit per day и пропуск строк с малым числом показов помогают ограничить размер таблицы.
- Search type: web, image, video, news, Discover или Google News.
- Final or fresh data: окончательные данные полные, но поступают с задержкой примерно в два дня; свежие появляются раньше, однако ещё могут измениться.
- Нажмите Sync now, чтобы начать загрузку сразу. Полоса прогресса покажет её состояние.
Шаг 7. Предоставьте доступ ассистенту
- Откройте вкладку Assistant и включите REST, MCP или оба варианта.
- Выберите, кто может читать данные с помощью пароля: только администраторы или редакторы и администраторы.
- Нажмите New token, задайте название и срок действия: бессрочно, 30 дней, 90 дней или 1 год. Сразу скопируйте токен: сайт сохраняет только его хеш.
- Задайте допустимое число запросов в минуту для токена.
Подключение ассистента
- Claude Code: добавьте MCP-сервер командой со вкладки Assistant, например claude mcp add с адресом MCP и токеном в заголовке Authorization.
- Cursor: вставьте блок mcp.json со вкладки Assistant в настройки MCP.
- Любой чат, который умеет отправлять веб-запросы: скопируйте инструкцию со вкладки Assistant. В ней уже указаны адрес и маршруты API.
- Веб-коннекторам ChatGPT и claude.ai требуется OAuth, который для этого подключения пока не поддерживается.
Шаг 8. Настройте IndexNow
- Откройте вкладку Indexing и найдите карточку IndexNow.
- Проверьте ключ. Плагин сам отдаёт файл ключа, а проверка подтверждает его доступность.
- Отправьте список адресов вручную или включите автоматическую отправку при публикации, обновлении и удалении записи.
- Выберите поисковые системы. IndexNow работает с Bing и другими системами, поддерживающими этот протокол. Google не поддерживает IndexNow.
- Посмотрите журнал: в нём видно, какие адреса отправлены и ответила ли поисковая система.
Частые ошибки и их причины
- 403, no permission: сервисный аккаунт не добавлен к ресурсу или не имеет к нему доступа. Проверьте шаг 2.
- Property not found: название ресурса не совпадает с Search Console. Для доменного ресурса нужен префикс sc-domain:, для ресурса с префиксом URL нужен точный адрес со слешем. Проверьте шаг 4.
- API not enabled: в проекте Google Cloud не включён Google Search Console API. Проверьте шаг 1.
- URL Inspection limit: Google допускает около 2000 проверок URL Inspection на ресурс в день. Дождитесь следующего дня или проверяйте меньше страниц.
- No data yet: первая загрузка ещё идёт или Google пока не опубликовал данные за последние дни. Обычно задержка составляет два-три дня.
Вкладки и настройки
В Search Insights семь вкладок: Overview, Pages, Queries, Opportunities, Indexing, Assistant и Settings. Кнопка Scan all pages of the site находится на вкладке Indexing. Сохраняйте ключ и остальные настройки кнопкой Save changes внизу страницы.
Файл ключа можно выбрать или перетащить при обоих вариантах хранения: в зашифрованном виде в базе данных или в защищённой папке baza-helper-private на сервере.
