Документация AX Protocol — установка и настройка сайта WordPress для ИИ-агентовAX Protocol — документация

AX Protocol делает сайт на WordPress читаемым, управляемым и проверяемым для ИИ-агентов. На этой странице описаны установка, то, что публикует плагин, и предоставляемые им конечные точки.

Требования

WordPress 5.8 или новее · PHP 7.4 или новее · включённые ЧПУ-ссылки.

Установка (2 минуты)

Загрузите zip-архив плагина через Плагины → Добавить новый → Загрузить плагин и активируйте его.
Вот и всё. При активации плагин регистрирует ваш домен в AX-хабе на rainz.ai, автоматически получает лицензионный ключ, вычисляет сетевую идентичность сайта (AXID) и начинает вести журнал трафика агентов. Без учётной записи и без формы регистрации.
Откройте AX Protocol в меню администратора, чтобы увидеть панель управления.

Что публикует плагин

Файл / конечная точка	Назначение
`/.well-known/ax.json`	Манифест сайта: идентичность (AXID), возможности, политика, канал связи. Сердце протокола.
`/llms.txt`	Понятное человеку описание сайта, предназначенное для языковых моделей.
`robots.txt` правила	Управляемые правила разрешения и блокировки для каждого агента, синхронизированные с вашей политикой.
`/wp-json/rainz-ax/v1/enquiry`	Структурированный канал, через который агенты отправляют запросы владельцу сайта, с отслеживанием статуса.
`Link` HTTP-заголовок	Сообщает об ax.json в каждом ответе, чтобы агенты могли его обнаружить.

Ваш AXID

Каждая установка получает устойчивый глобальный идентификатор, например AXID-3D7FFD6C-F245BF40-B8A1F26A-DEFEB5D8. Он выводится из вашего лицензионного ключа и домена, никогда не раскрывает сам ключ и может быть проверен выдавшим его хабом. Проверенные сайты попадают в публичный реестр AX.

Панель управления

Трафик агентов показывает, какие ИИ-агенты (GPTBot, ClaudeBot, PerplexityBot, Google-Extended и другие) заходили, что они загрузили и когда. Mission Control кратко оценивает готовность вашего сайта к агентам. Настройки управляют политикой, лицензией и расширенными параметрами.

Бесплатно или Pro

Бесплатный уровень полностью работоспособен и никогда не истекает. Pro (49 $ за сайт в год) добавляет аналитику по всей истории с экспортом в CSV, значок проверенного сайта и приоритетное место в реестре, отправку IndexNow, вебхуки для агентов и приоритетную поддержку.

Устранение неполадок

ax.json возвращает 404 — пересохраните постоянные ссылки (Настройки → Постоянные ссылки → Сохранить), чтобы обновить правила перезаписи.

Лицензия показывает “Free” без ключа — ваш сервер может блокировать исходящие запросы; плагин повторяет попытку ежедневно, а всё остальное продолжает работать.

Визиты агентов не записываются — подождите несколько дней; убедитесь, что хостинг или CDN не блокируют ботов ещё до того, как их увидит WordPress.

Всё ещё не работает? Обратитесь в поддержку.

Совместная работа с SEO, кэшем и CDN

Почти на каждом сайте, где устанавливают AX Protocol, уже работают SEO-плагин, слой кэширования и часто CDN. Все три затрагивают ровно те файлы, которые генерирует протокол, поэтому порядок операций стоит определить заранее, а не отлаживать потом. Ваш SEO-плагин отвечает за sitemap.xml и канонические теги. AX Protocol не заменяет ни то, ни другое; он добавляет слой манифеста поверх них. Когда два компонента пишут по одному и тому же пути, побеждает последний в цепочке: всегда проверяйте живой файл, а не экран настроек.

Кэш — самый частый источник проблем, которые выглядят как ошибки протокола. Манифест, закэшированный до изменения настроек, будет отдаваться агентам ещё несколько часов, и сайт станет заявлять структуру, которая больше не соответствует его содержимому. Правило простое: после любого изменения полностью очистите кэш и проверьте живой файл в приватном окне. Если у вас есть CDN, добавьте очистку на краю сети, иначе источник отдаёт новую версию, а посетители и агенты по-прежнему получают старую.

Третий компонент — межсетевой экран уровня приложений. Некоторые провайдеры по умолчанию блокируют запросы без узнаваемого браузерного отпечатка, и ИИ-агенты полностью попадают в эту категорию. Если локальные проверки проходят, а тот же запрос из открытого интернета возвращает 403, подозревайте правило блокировки, а не плагин. Начните с добавления путей манифеста в список разрешений.

Ручные проверки

Панель управления сообщает о том, что, по мнению плагина, было опубликовано. Это не то же самое, что получает агент, и расхождения случаются чаще, чем можно ожидать. Четыре проверки занимают около пяти минут и выявляют большинство реальных сбоев.

Первое: запросите манифест обычным HTTP-клиентом, а не браузером, и убедитесь, что получаете 200 и корректный JSON, а не HTML-страницу проверки. Второе: тем же способом загрузите важную страницу с содержимым и убедитесь, что осмысленный текст присутствует в исходном ответе — если тело приходит пустым, ваш контент подставляется через JavaScript и агенты его никогда не увидят. Третье: пройдите по каждому URL, объявленному в манифесте, и убедитесь, что ни один не перенаправляет и не отдаёт 404, потому что манифест, указывающий на мёртвые пути, хуже, чем отсутствие манифеста. Четвёртое: повторите первую проверку из-за пределов собственной сети, лучше через мобильное соединение, чтобы исключить разрешение по IP, при котором здоровым выглядит только ваш офис.

Запишите результаты. Когда что-то сломается через три месяца, самый быстрый путь к диагнозу — запись о том, как выглядело работающее состояние.

Обновления, переезды и совместимость со временем

Смена хостинга, смена домена или переход на поддомен — события, которые чаще всего ломают настройку протокола, потому что абсолютные URL, сохранённые в параметрах, продолжают указывать на старое место. Задокументируйте конфигурацию перед переездом и после него пройдите по каждому пути манифеста, убедившись, что он открывается по новому адресу. Если сайт заодно перешёл с HTTP на HTTPS, проверьте дублирующиеся редиректы по пути: длинная цепочка перенаправлений заставляет часть агентов бросить запрос на полпути.

Обновления плагина менее рискованны, но не безрисковы. Спецификация версионируется, и смена мажорной версии может изменить имена полей в манифесте. Прочитайте примечания к выпуску перед крупным обновлением, и если вы построили что-то, что читает ваш собственный манифест, проверьте это на новом выводе, прежде чем выкатывать в продакшн.

Если времени хватает только на три вещи

Если это первое внедрение и пройти каждый раздел не получается, три пункта дают большую часть пользы: корректный манифест, доступный по ожидаемому пути, точное однострочное описание организации, объясняющее, что делает сайт и для кого, и каталог услуг с теми страницами, которые вы действительно хотите видеть в цитатах. Всё остальное — расширенные конечные точки, настройки разрешений, продвинутое обнаружение — можно добавлять постепенно. Сайт с этими тремя вещами уже достаточно понятен агентам, и дальше его можно улучшать по тому, что показывают логи сервера, а не наугад.

Место AX Protocol на многоязычном сайте

Если сайт работает более чем на одном языке, решите заранее, какой язык описывает манифест. Протокол выпускает по манифесту на каждую языковую версию, а агенты следуют тем же сигналам hreflang, что и поисковые системы: корректно связанный набор переводов означает, что агент, спрашивающий по-испански, попадёт на испанскую страницу, а не на английскую. Сломанный набор переводов означает, что все языки схлопываются в язык по умолчанию, а это хуже, чем отсутствие переводов вовсе.

Проверка быстрая: загрузите корень каждого языка и убедитесь, что альтернативные ссылки перечисляют все версии плюс x-default и что каждая версия ведёт на URL, отдающий 200 на этом языке. Сайты, собранные копированием страниц между языками, часто проваливают эту проверку, потому что копии так и не были связаны в группу перевода, и каждая представляется агентам как отдельный, не связанный документ.