Подключение самописного сайта с помощью SEOAsist Site API

Если ваш сайт работает не на WordPress или Shopify (Next.js, Laravel, .NET, чистый PHP…), вы можете добавить на него небольшой API и позволить SEOAsist выполнять SEO-задачи. После подключения исправления тегов title, description, canonical, robots, микроразметки (structured data) и редиректов будут применяться на стороне сервера, статьи в блоге — публиковаться, а файл llms.txt — поддерживаться в актуальном состоянии. Без плагинов и pull-запросов.

#Предварительные требования

• У вас есть возможность изменять код сайта (самостоятельно, с помощью разработчика или AI-ассистента вроде Claude или Cursor).
• Вы можете задавать переменные окружения для сайта (в файле .env или панели хостинга).
• У вас есть права на редактирование в панели; в противном случае вы увидите сообщение «Вам необходимы права на редактирование для этого действие».

#1. Установите API на свой сайт

1. Откройте сайт из раздела Сайты и перейдите на вкладку Каналы исправлений.
2. В карточке SEOAsist Site API (самописные сайты) вверху нажмите Промпт для настройки.
3. Нажмите Копировать в диалоговом окне и передайте текст Claude, Cursor или разработчику, работающему над вашим проектом. Промпт содержит полную спецификацию, а также детали для данного сайта (URL сайта, базовый URL API и, если подключен, его репозиторий GitHub).
4. Предпочитаете написать код самостоятельно? Нажмите Руководство разработчика. В нем есть вкладки Шаги, Спецификация, Next.js, PHP и Тест с готовым кодом для старта.

Ваш сайт предоставляет четыре конечные точки (endpoints) по одному базовому пути: GET /manifest, PUT /rules, POST /content и PUT /files. Подробности см. в Справочнике по Site API.

#2. Сохраните URL и добавьте токен

1. Введите адрес API в поле Базовый URL API в нижней части карточки. По умолчанию предлагается значение https://<ваш-домен>/api/seoasist.
2. Нажмите Подключить. Появится желтый блок с заголовком Токен — показывается только один раз и строкой SEOASIST_SITE_TOKEN=sa_….
3. Нажмите Копировать и добавьте эту строку в переменные окружения сайта. Затем перезапустите или выполните повторный деплой сайта.

#3. Проверьте соединение

1. При желании сначала проверьте /manifest с помощью команды curl во вкладке Руководство разработчика → Тест.
2. Нажмите Проверить соединение в карточке. SEOAsist вызовет конечную точку /manifest и сохранит возможности (capabilities), которые заявляет ваш сайт.
3. При успехе вы увидите «Подключено · возможности: … · Отправлено правил: N». Все включенные правила, ожидавшие отправки, будут немедленно переданы на сайт.

#Что происходит автоматически после подключения

В строке состояния отображаются возможности, заявленные вашим сайтом: Правила SEO, Публикация контента и llms.txt / robots. Каждая из них работает независимо, и SEOAsist использует только те, которые указаны вашим сайтом.

В карточке также есть две кнопки для ручного выполнения: Отправить правила сейчас (N) и Отправить llms.txt. Для работы кнопки llms.txt предварительно требуется сгенерировать файл llms.txt на вкладке Доступ для AI.

#Автоисправление на странице «Здоровье»

Когда Site API подключен с возможностью «Правила SEO», рядом с поддерживаемыми проблемами на странице Здоровье появляется кнопка Автоисправление. Поддерживаемые проблемы: отсутствующие, слишком длинные, слишком короткие или дублирующиеся заголовки title; отсутствующие, слишком длинные или дублирующиеся метаописания description; отсутствующие canonical или canonical, указывающие на другую страницу; отсутствующий html lang; страницы, отмеченные как noindex. Намеренно установленный noindex (например, страницы тегов или малосодержательные страницы, которых нет в карте сайта) никогда не меняется на index при автоисправлении.

Инструмент формирует значения для затронутых страниц из последнего сканирования (до 40 страниц). AI генерирует заголовки и описания: для каждой страницы на ее собственном языке, на основе ее заголовка, H1 и описания; на мультиязычных сайтах заголовок с другой страницы или языка никогда не подставляется. Значения canonical, lang и robots вычисляются автоматически. Они отправляются на ваш сайт в виде правил, после чего запускается проверочное сканирование. Повторный запуск для той же проблемы заменяет ранее созданные правила. Подробнее в Умышленные проблемы и автоисправление.

#Правила публикации и языки

• Повторная публикация той же статьи: если статья уже была опубликована по тому же адресу (тот же slug и язык), SEOAsist не создает новую копию с суффиксом -2, а обновляет существующую статью на сайте.
• Языки: статья отправляется с языком ее текста. Site API может публиковать на каждом языке сайта: из списка Языки сайта, если вы его задали, либо на основном языке плюс языках, которые ваш сайт возвращает как locales в /manifest. Если язык статьи не входит в их число, она не публикуется, возвращается на проверку, а вы получаете уведомление «Не опубликовано, несоответствие языка: …». Перед этим SEOAsist повторно считывает манифест один раз, поэтому если на ваш сайт был добавлен новый язык, вам не нужно тестировать интеграцию заново.
• Обновления страниц: проверка языка учитывает только отправляемый текст страницы и сравнивает его с собственным языком страницы; имена собственные в тексте (названия компаний или продуктов) не учитываются при определении языка. Обновления страниц никогда не публикуются автоматически; вы публикуете их вручную из редактора.
• Автоматическая публикация: запланированные публикации и автопубликации Autopilot сначала проходят через этап автоматической проверки; статья, не прошедшая его, отправляется на утверждение с указанием причин. Публикация вручную пропускает этот этап.
• Одобрение клиентом: если для организации включена опция «Требовать одобрения клиента перед публикацией», статьи и обновления страниц не публикуются ввиду этого канала до тех пор, пока клиент не одобрит их; см. Одобрение клиентом.

#Проверка работы

• В строке состояния карточки отображается зеленый статус Подключено, теги возможностей и надпись «последняя отправка N правил».
• Откройте исходный код одной из ваших страниц («Просмотр исходного кода страницы» в браузере). Примененный title или meta description должен присутствовать в HTML. Правила предназначены для применения на стороне сервера, а не с помощью JavaScript на стороне клиента.
• Если произошел сбой, статус меняется на красный (Ошибка), а в карточке выводится последнее сообщение об ошибке. См. Проблемы с подключением Site API.

#ЧАВО

#Удаляются ли правила с моего сайта при отключении?

Нет. Кнопка Отключить только останавливает отправку данных из SEOAsist; правила, сохраненные на вашем сайте, остаются как есть.

#Что произойдет, если я изменю URL API?

Введите новый URL и нажмите Сохранить URL. Статус изменится на Ожидает проверки; запустите Проверить соединение еще раз. Токен останется прежним.

#Изменится ли мой сайт, если правил нет?

Не должен. Спецификация требует, чтобы каждая страница отображалась точно так же, как и сегодня, при отсутствии правил, а промпт для настройки явно просит не нарушать существующее SEO-поведение.

#Чем это отличается от Pixel?

Они используют одни и те же правила. Pixel применяет их в браузере с помощью JavaScript; Site API применяет их на вашем сервере, поэтому поисковые системы видят изменения непосредственно в HTML. Site API также может публиковать статьи и записывать файл llms.txt.

#Могу ли я подключить локальный URL для разработки (localhost)?

Нет. SEOAsist вызывает только публично доступные адреса; localhost и адреса частных сетей отклоняются. Установите API на ваш рабочий (live) сайт.