Документація

Як працює IndexFast

Повний посібник з налаштування та використання IndexFast — від отримання ключа API до автоматичної щоденної індексації.

⚡ Швидкий старт

Щоб почати роботу з IndexFast вам потрібно виконати 3 кроки. Весь процес займає близько 10–15 хвилин.

☁️ Налаштування Google Cloud

Увімкнення API

Перейдіть до Google Cloud Console → APIs & Services → Library. Знайдіть «Web Search Indexing API» і натисніть Enable.

Створення Service Account

Service Account — це технічний обліковий запис без пароля, який IndexFast використовує для авторизації в Google API. Щоб його створити, потрібен проєкт у Google Cloud.

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "abc123...",
  "private_key": "-----BEGIN RSA PRIVATE KEY-----\n...",
  "client_email": "[email protected]",
  "client_id": "123456789",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token"
}

🔗 Підключення Search Console

Без цього кроку API буде повертати помилку 403 Forbidden навіть при правильному ключі. Service Account має отримати статус власника сайту в Google Search Console.

⚙️ Як працює сервіс

IndexFast автоматично зчитує ваш sitemap.xml і відправляє URL через Google Indexing API. Ніякого скрипта встановлювати не потрібно — всі операції виконуються на серверах IndexFast.

🤖 Автоматичний розклад

IndexFast запускає індексацію автоматично — налаштовувати cron або тримати сервер не потрібно. Сервіс працює цілодобово на стороні IndexFast.

Як керувати індексацією

🔧 Інтеграції з платформами

WordPress

Якщо ви використовуєте Yoast SEO або Rank Math — sitemap вже готовий:

Shopify

Shopify автоматично генерує sitemap за адресою /sitemap.xml. Він включає сторінки, товари, колекції та блог-пости.

Laravel

Для генерації sitemap у Laravel рекомендуємо пакет spatie/laravel-sitemap:

composer require spatie/laravel-sitemap

use Spatie\Sitemap\SitemapGenerator;

SitemapGenerator::create('https://your-site.com')
    ->writeToFile(public_path('sitemap.xml'));

Інші платформи

📡 API Reference

Авторизація

Google Indexing API використовує OAuth 2.0 через Service Account. IndexFast обробляє авторизацію автоматично — вам потрібен лише JSON-ключ.

Endpoint для отримання токена:

POST https://oauth2.googleapis.com/token

Content-Type: application/x-www-form-urlencoded

grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer
&assertion={JWT_TOKEN}

Відправка URL на індексацію

POST https://indexing.googleapis.com/v3/urlNotifications:publish

Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json

{
  "url": "https://your-site.com/new-page",
  "type": "URL_UPDATED"
}

Успішна відповідь:

{
  "urlNotificationMetadata": {
    "url": "https://your-site.com/new-page",
    "latestUpdate": {
      "url": "https://your-site.com/new-page",
      "type": "URL_UPDATED",
      "notifyTime": "2026-01-20T10:30:00Z"
    }
  }
}

Перевірка статусу URL

GET https://indexing.googleapis.com/v3/urlNotifications/metadata
    ?url=https://your-site.com/page

Authorization: Bearer {ACCESS_TOKEN}

Коди помилок

❓ FAQ

Скільки часу займає індексація після відправки?

Google зазвичай обробляє запити протягом 24–48 годин. В більшості випадків сторінки з'являються в пошуку вже наступного ранку після відправки.

Чи можна відправляти більше 200 URL на день?

200 URL — стандартний безкоштовний ліміт Google. При потребі можна подати заявку на збільшення ліміту через Google Cloud Console. IndexFast автоматично зупиняється при досягненні ліміту і продовжує на наступний день.

Чи безпечно для SEO використовувати Indexing API?

Так, це офіційний метод, рекомендований самим Google. Жодних ризиків пенальті чи зниження позицій — навпаки, швидша індексація покращує конкурентоздатність.

Sitemap Index чи звичайний sitemap?

IndexFast підтримує обидва типи. Якщо передати посилання на sitemap_index.xml — скрипт автоматично обійде всі вкладені файли і зберезе всі URL.

📋 Changelog

v2.1 — Січень 2026

— Підтримка Sitemap Index (вкладені файли будь-якої глибини)
— Покращене логування з кольоровим виводом у термінал
— Автоматичне визначення шляху до sitemap.xml за доменом

v2.0 — Грудень 2024

— Повний рефакторинг скрипта
— Додана підтримка іменованих аргументів CLI
— Лічильник добового ліміту з автопаузою

v1.0 — Вересень 2024

— Перший публічний реліз
— Базова відправка URL через Google Indexing API