🔍
K

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

Как работает IndexFast

Полное руководство по настройке и использованию IndexFast – от получения ключа API до автоматической ежедневной индексации.

ℹ️
Что такое Google Indexing API? Официальный инструмент Google для оповещения поисковика о новых или обновленных страницах. Позволяет отправить в 200 URL в сутки бесплатно и получить ответ в течение 24–48 часов.

⚡ Быстрый старт

Чтобы начать работу с IndexFast вам нужно выполнить 3 шага. Весь процесс занимает около 10-15 минут.

1
Создайте Service Account в Google Cloud

Перейдите на console.cloud.google.com, создайте новый проект (или выберите существующий) и включите Web Search Indexing API. Создайте Service Account и загрузите JSON-ключ.

Подробная инструкция — в разделе 🔑 Service Account.

2
Добавьте Service Account в Search Console

У Google Search Console добавьте email вашего Service Account в качестве делегированного владельца сайта.

Подробная инструкция — в разделе 🔗 Search Console.

3
Подключите сайт в личном кабинете

Зарегистрируйтесь или войдите в кабинет IndexFast. Добавьте сайт, вставьте JSON-ключ Service Account – и индексация запустится автоматически.


✅ Требования

Перед началом работы убедитесь, что у вас есть:

1
Аккаунт Google

Необходим для доступа к Google Cloud Console и Google Search Console.

2
Сайт, подтвержденный в Google Search Console

Ваш домен должен быть верифицирован в Google Search Console любым доступным методом.

3
Файл sitemap.xml

Ваш сайт должен иметь публично доступный sitemap.xml. IndexFast читает его для получения списка URL для индексации.

4
JSON-ключ Service Account

Загруженный из Google Cloud Console файл .json с правами на Web Search Indexing API.

💡
Если вашего сайта еще нет в Search Console, сначала добавьте его и подтвердите право собственности. Подробная инструкция есть на сайте Google.

☁️ Настройки Google Cloud

Включение API

Перейдите к Google Cloud Console → APIs & Services → Library. Найдите «Web Search Indexing API» и нажмите Enable.

⚠️
Важно API должен быть включен именно в том проекте, к которому привязан ваш Service Account. Если API не включен — вы получите ошибку 403 accessNotConfigured.

Создание Service Account

Service Account — это техническая учетная запись без пароля, используемая IndexFast для авторизации в Google API. Для его создания требуется проект в Google Cloud.

🛠
Перед началом включите Indexing API в вашем проекте через инструмент настройки. Без этого шага вы получите ошибку 403 accessNotConfigured.
1
Откройте раздел Service Accounts

Перейдите в Google Cloud Console → IAM & Admin → Service Accounts. При необходимости выберите нужный проект.

2
Нажмите кнопку «Создать сервисный аккаунт»

Введите название, например IndexFast-bot, и описание. Идентификатор можно оставить автоматически. Нажмите «Создать и продолжить».

Раздел «Право доступа» заполнять не обязательно - нажмите «Продолжить», затем «Готово».

3
Создайте JSON-ключ

Откройте только что созданный аккаунт → вкладка KeysAdd Key → Create new key. Выберите формат JSON и нажмите «Создать».

Файл автоматически загрузится на ваш компьютер – это единственная копия ключа. Сохраните его в безопасном месте и никогда не публикуйте в Git или публичных репозиториях.

💡
Файл JSON должен выглядеть так – если структура отличается, ключ сгенерирован неправильно.
JSON service-account.json
{
  "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.

1
Подтвердите право собственности на сайт

Перейдите в Google Search Console и подтвердите, что сайт принадлежит вам любым доступным способом (DNS-запись, HTML-файл и т.п.).

2
Скопируйте email Service Account

Откройте загруженный JSON-файл и найдите поле client_email. Email имеет вид:

название-аккаунта@название-проекта.iam.gserviceaccount.com

Например: [email protected]

3
Добавьте Service Account в качестве делегированного владельца

В Search Console выберите ваш сайт → Настройки → Подтвержденные владельцы → Добавить владельца. Вставьте email Service Account и подтвердите.

⚠️
Нужна роль именно Владелец (не "Полный доступ"). Без этого API будет возвращать 403 Forbidden.
4
Подождите 1–2 минуты

Права применяются не мгновенно. После этого IndexFast сможет отправлять URL на индексацию через ваш сайт.


🗺 sitemap.xml

IndexFast читает ваш sitemap.xml для получения URL, которые нужно отправить на индексацию. Все форматы поддерживаются.

Поддерживаемые форматы

  • sitemap.xml — стандартный файл с URL
  • sitemap_index.xml — родительский файл со ссылками на дочерние Sitemap (любая глубина вложенности)
  • ✅ Sitemap с тегами - фильтрация по дате обновления

Где найти URL Sitemap

Стандарт: /sitemap.xml WordPress (Yoast): /sitemap_index.xml Shopify: /sitemap.xml Laravel: /sitemap.xml
⚠️
Важно Sitemap должен быть публично доступен без авторизации. Убедитесь, что файл открывается в браузере без логина. Если он закрыт – IndexFast не сможет его прочитать.

⚙️ Как работает сервис

IndexFast автоматически считывает ваш sitemap.xml и отправляет URL через Google Indexing API. Никакого скрипта устанавливать не нужно – все операции выполняются на серверах IndexFast.

1
Вы добавляете сайт в кабинете

Указываете домен, URL sitemap.xml и вставляете JSON-ключ Service Account. IndexFast проверяет доступность Sitemap и сохраняет настройки.

2
IndexFast считывает Sitemap

Сервис поддерживает обычные Sitemap и Sitemap Index (вложенные файлы любой глубины). URL автоматически ставятся в очередь в соответствии с дневным лимитом вашего плана.

3
URL отправляются в Google

Сервис использует ваш Service Account для авторизации и отправляет URL через официальный Google Indexing API. Вы видите результат в реальном времени в личном кабинете.

📊
Лимиты зависят от плана: Старт – 10 URL/день, PRO – 100 URL/день, Агентство – 1000 URL/день. Лимит обновляется ежедневно в 00:00.

🤖 Автоматическое расписание

IndexFast запускает индексацию автоматически – настраивать cron или держать сервер не нужно. Сервис работает круглосуточно на стороне IndexFast.

💡
Чтобы запустить индексацию вручную, нажмите «▶ Запуск» в личном кабинете рядом с нужным сайтом. Итог появится в логах в течение минуты.

Как управлять индексацией

1
Активный режим

Сайт со статусом Активный автоматически отправляет URL в пределах дневного лимита. Лимит делится равномерно между всеми активными сайтами аккаунта.

2
Пауза

Если нужно временно остановить индексацию для сайта - нажмите «⏸» в офисе. Дневной лимит не тратится. Восстановить можно в любой момент.

3
Ручной запуск

Нажмите «▶ Запуск» - и IndexFast немедленно отправит URL из Sitemap в пределах остатка дневного лимита. Удобно после публикации новых страниц.


🖱 Ручная индексация

Помимо автоматического режима, IndexFast позволяет запустить индексацию вручную в любой момент – прямо из личного кабинета.

1
Откройте кабинет

Перейдите на indexfast.pro/app/dashboard и найдите нужный сайт в списке.

2
Нажмите «▶ Запуск»

IndexFast мгновенно считает Sitemap и отправит URL в остатке дневного лимита.

3
Просмотрите результаты в логах

Ответы от Google API появляются на вкладке «Логи» в течение 1–2 минут. Вы видите статус каждого URL: 200 ОК, 403, или другой ответ.

ℹ️
Ручная индексация тратит тот же дневной предел, что и автоматическая. Если лимит исчерпан – IndexFast поставит URL в очередь на следующий день.

📊 Лимиты API

Google бесплатно предоставляет лимит в 200 URL в сутки на один Service Account. IndexFast автоматически отслеживает предел и останавливается при его исчерпании.

ПланURL/деньСайтовService Accounts
Старт (бесплатно)1011
PRO100до 51
Агентство1000до 50неограниченно
💡
Дневной лимит обновляется ежедневно в 00:00 UTC. Если у вас много сайтов, предел автоматически распределяется между ними равномерно.

🔧 Интеграции с платформами

WordPress

Если вы используете Yoast SEO или Rank Math - Sitemap уже готов:

Yoast SEO → /sitemap_index.xml Rank Math → /sitemap_index.xml All in One SEO → /sitemap.xml
В личном кабинете IndexFast укажите URL вашего Sitemap: https://your-site.com/sitemap_index.xml — сервис автоматически распакует все вложенные файлы.

Нужна помощь с интеграцией? Обратитесь в поддержку.

Shopify

Shopify автоматически генерирует Sitemap по адресу /sitemap.xml. Он включает в себя страницы, товары, коллекции и блог-посты.

В личном кабинете IndexFast укажите URL вашего Sitemap: https://your-store.myShopify.com/sitemap.xml – и индексация запустится автоматически.

Нужна помощь с интеграцией? Обратитесь в поддержку.

Laravel

Для генерации Sitemap в Laravel рекомендуем пакет spatie/Laravel-Sitemap:

BASH
composer require spatie/Laravel-Sitemap
PHP
use Spatie\Sitemap\SitemapGenerator;

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

Нужна помощь с интеграцией? Обратитесь в поддержку.

Другие платформы

PrestaShop → /sitemap.xml OpenCart → модуль SEO Sitemap Wix → /sitemap.xml Webflow → /sitemap.xml Joomla → плагин OSMap
💡
IndexFast работает с любой платформой, генерирующей валидный sitemap.xml. Проверьте наличие файла по адресу https://your-site.com/sitemap.xml.

Нужна помощь с интеграцией? Обратитесь в поддержку.


📡 API Reference

Авторизация

Google Indexing API использует OAuth 2.0 через Service Account. IndexFast обрабатывает авторизацию автоматически – вам нужен только JSON-ключ.

Endpoint для получения токена:

HTTP
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 на индексацию

ПараметрТипОбязательныйОписание
urlstringrequiredПолная URL с https://
typeenumrequiredURL_UPDATED или URL_DELETED
HTTP
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"
}

Успешный ответ:

JSON
{
  "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

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

Authorization: Bearer {ACCESS_TOKEN}

Коды ошибок

КодПричинаРешение
400Невалидный URL или типПроверьте формат URL и значение type
403Нет прав или API не включенДобавьте Service Account как владельца в Search Console
429Превышен суточный лимитПодождите до следующего дня или обратитесь в Google
500Ошибка на стороне GoogleПовторите запрос через несколько минут

❓ 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.4 - Июнь 2026

Интеграция с IndexNow: автоматическая отправка URL в Bing, Naver, Seznam.cz и Yep.
— Запущена партнерская программа (Affiliate Program).
— Добавлен интерактивный ROI-калькулятор на главную страницу.

v2.3 - Март 2026

Авторизация через Google (OAuth): вход в один клик без паролей.
— Многоязычие: добавлена ​​поддержка 8 новых языков.
— Запущен тариф Агентство с поддержкой до 50 сайтов и White-label отчетами.

v2.2 - Январь 2026

– Поддержка Sitemap Index (автоматический обход вложенных файлов любой глубины).
- Публичное REST API для разработчиков.
— Улучшенное логирование и отображение статуса 200/403 в реальном времени.

v2.0 - Декабрь 2024

– Запуск облачной платформы SaaS (ранее сервис работал как локальный скрипт).
- Автоматический суточный планировщик с управлением лимитами.

v1.0 - Сентябрь 2024

– Первый запуск сервиса.
— Базовая отправка URL через Google Indexing API.

💬 Поддержка

Если у вас есть вопросы или возникли проблемы, мы готовы помочь:

📱
Telegram чат

Самый быстрый способ получить ответ t.me/IndexFastgoogle. Среднее время ответа – до 2 часов.

✉️
Email поддержка

Напишите на IndexFastapp@gmail.com. Соответствуем в течение одного рабочего дня.

FAQ

Просмотрите раздел FAQ — там есть ответы на самые распространенные вопросы.

👨‍💻
Помощь с разработкой и SEO

Нужна ли интеграция, аудит или поддержка сайта? Обращайтесь к devroman.dev или devroman.pp.ua. Разработчик и SEO-специалист поможет с настройкой или разработкой нового функционала под ключ (от дизайна до REST API). Стек технологий: PHP, Laravel, PrestaShop, Next.js, React, Node.js, Docker, Vue, Nuxt, Yii2, WordPress, WooCommerce и т.д. Стоимость: 25$/час.