Налаштування 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 на сервері.
