Документация
Как работает IndexFast
Полное руководство по настройке и использованию IndexFast – от получения ключа API до автоматической ежедневной индексации.
⚡ Быстрый старт
Чтобы начать работу с IndexFast вам нужно выполнить 3 шага. Весь процесс занимает около 10-15 минут.
Перейдите на console.cloud.google.com, создайте новый проект (или выберите существующий) и включите Web Search Indexing API. Создайте Service Account и загрузите JSON-ключ.
Подробная инструкция — в разделе 🔑 Service Account.
У Google Search Console добавьте email вашего Service Account в качестве делегированного владельца сайта.
Подробная инструкция — в разделе 🔗 Search Console.
Зарегистрируйтесь или войдите в кабинет IndexFast. Добавьте сайт, вставьте JSON-ключ Service Account – и индексация запустится автоматически.
✅ Требования
Перед началом работы убедитесь, что у вас есть:
Необходим для доступа к Google Cloud Console и Google Search Console.
Ваш домен должен быть верифицирован в Google Search Console любым доступным методом.
Ваш сайт должен иметь публично доступный sitemap.xml. IndexFast читает его для получения списка URL для индексации.
Загруженный из Google Cloud Console файл .json с правами на Web Search Indexing API.
☁️ Настройки Google Cloud
Включение API
Перейдите к Google Cloud Console → APIs & Services → Library. Найдите «Web Search Indexing API» и нажмите Enable.
403 accessNotConfigured.
Создание Service Account
Service Account — это техническая учетная запись без пароля, используемая IndexFast для авторизации в Google API. Для его создания требуется проект в Google Cloud.
403 accessNotConfigured.Перейдите в Google Cloud Console → IAM & Admin → Service Accounts. При необходимости выберите нужный проект.
Введите название, например IndexFast-bot, и описание. Идентификатор можно оставить автоматически. Нажмите «Создать и продолжить».
Раздел «Право доступа» заполнять не обязательно - нажмите «Продолжить», затем «Готово».
Откройте только что созданный аккаунт → вкладка Keys → Add Key → Create new key. Выберите формат JSON и нажмите «Создать».
Файл автоматически загрузится на ваш компьютер – это единственная копия ключа. Сохраните его в безопасном месте и никогда не публикуйте в Git или публичных репозиториях.
{
"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.
Перейдите в Google Search Console и подтвердите, что сайт принадлежит вам любым доступным способом (DNS-запись, HTML-файл и т.п.).
Откройте загруженный JSON-файл и найдите поле client_email. Email имеет вид:
название-аккаунта@название-проекта.iam.gserviceaccount.com
Например: [email protected]
В Search Console выберите ваш сайт → Настройки → Подтвержденные владельцы → Добавить владельца. Вставьте email Service Account и подтвердите.
403 Forbidden.Права применяются не мгновенно. После этого IndexFast сможет отправлять URL на индексацию через ваш сайт.
🗺 sitemap.xml
IndexFast читает ваш sitemap.xml для получения URL, которые нужно отправить на индексацию. Все форматы поддерживаются.
Поддерживаемые форматы
- ✅
sitemap.xml— стандартный файл с URL - ✅
sitemap_index.xml— родительский файл со ссылками на дочерние Sitemap (любая глубина вложенности) - ✅ Sitemap с тегами
- фильтрация по дате обновления
Где найти URL Sitemap
⚙️ Как работает сервис
IndexFast автоматически считывает ваш sitemap.xml и отправляет URL через Google Indexing API. Никакого скрипта устанавливать не нужно – все операции выполняются на серверах IndexFast.
Указываете домен, URL sitemap.xml и вставляете JSON-ключ Service Account. IndexFast проверяет доступность Sitemap и сохраняет настройки.
Сервис поддерживает обычные Sitemap и Sitemap Index (вложенные файлы любой глубины). URL автоматически ставятся в очередь в соответствии с дневным лимитом вашего плана.
Сервис использует ваш Service Account для авторизации и отправляет URL через официальный Google Indexing API. Вы видите результат в реальном времени в личном кабинете.
🤖 Автоматическое расписание
IndexFast запускает индексацию автоматически – настраивать cron или держать сервер не нужно. Сервис работает круглосуточно на стороне IndexFast.
Как управлять индексацией
Сайт со статусом Активный автоматически отправляет URL в пределах дневного лимита. Лимит делится равномерно между всеми активными сайтами аккаунта.
Если нужно временно остановить индексацию для сайта - нажмите «⏸» в офисе. Дневной лимит не тратится. Восстановить можно в любой момент.
Нажмите «▶ Запуск» - и IndexFast немедленно отправит URL из Sitemap в пределах остатка дневного лимита. Удобно после публикации новых страниц.
🖱 Ручная индексация
Помимо автоматического режима, IndexFast позволяет запустить индексацию вручную в любой момент – прямо из личного кабинета.
Перейдите на indexfast.pro/app/dashboard и найдите нужный сайт в списке.
IndexFast мгновенно считает Sitemap и отправит URL в остатке дневного лимита.
Ответы от Google API появляются на вкладке «Логи» в течение 1–2 минут. Вы видите статус каждого URL: 200 ОК, 403, или другой ответ.
📊 Лимиты API
Google бесплатно предоставляет лимит в 200 URL в сутки на один Service Account. IndexFast автоматически отслеживает предел и останавливается при его исчерпании.
| План | URL/день | Сайтов | Service Accounts |
|---|---|---|---|
| Старт (бесплатно) | 10 | 1 | 1 |
| PRO | 100 | до 5 | 1 |
| Агентство | 1000 | до 50 | неограниченно |
🔧 Интеграции с платформами
WordPress
Если вы используете Yoast SEO или Rank Math - Sitemap уже готов:
https://your-site.com/sitemap_index.xml — сервис автоматически распакует все вложенные файлы.Нужна помощь с интеграцией? Обратитесь в поддержку.
Shopify
Shopify автоматически генерирует Sitemap по адресу /sitemap.xml. Он включает в себя страницы, товары, коллекции и блог-посты.
https://your-store.myShopify.com/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'));
Нужна помощь с интеграцией? Обратитесь в поддержку.
Другие платформы
sitemap.xml. Проверьте наличие файла по адресу https://your-site.com/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 на индексацию
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
url | string | required | Полная URL с https:// |
type | enum | required | URL_UPDATED или URL_DELETED |
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}
Коды ошибок
| Код | Причина | Решение |
|---|---|---|
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.
💬 Поддержка
Если у вас есть вопросы или возникли проблемы, мы готовы помочь:
Самый быстрый способ получить ответ t.me/IndexFastgoogle. Среднее время ответа – до 2 часов.
Напишите на IndexFastapp@gmail.com. Соответствуем в течение одного рабочего дня.
Просмотрите раздел FAQ — там есть ответы на самые распространенные вопросы.
Нужна ли интеграция, аудит или поддержка сайта? Обращайтесь к devroman.dev или devroman.pp.ua. Разработчик и SEO-специалист поможет с настройкой или разработкой нового функционала под ключ (от дизайна до REST API). Стек технологий: PHP, Laravel, PrestaShop, Next.js, React, Node.js, Docker, Vue, Nuxt, Yii2, WordPress, WooCommerce и т.д. Стоимость: 25$/час.