Generic HTTP / Partner OpenAPI
Уровень L1 · статус available
Свой write-bridge по Site Connector Protocol.
Обзор
Свой CMS/бэкенд реализует Site Connector Protocol (OpenAPI v1). Подходит для headless, самописных витрин и партнёрских API. SEO пишется по path+locale (не по фиксированному каталогу pageKey); robots/sitemap/llms — через upsertFile.
Что нужно заранее
- Доступ к Центру управления (кабинет A.I.T.A.).
- HTTPS на сайте или стенде.
- Возможность выставить секрет API только на сервере (не в браузере).
Установка
- Возьмите спецификацию: /docs/api и docs/WRITE_SURFACE.md (path+locale + site files).
- Реализуйте минимум: GET /health, GET /capabilities, GET /urls, GET /pages/{id}, PATCH /pages/{id}/seo.
- Для sitemap/robots/llms добавьте PUT /files и capability upsertFile.
- Защитите эндпоинты Bearer / X-Api-Key (сервер-сервер). Можно взять @seo/connector-sdk.
Настройка в кабинете
- В кабинете → Подключение → Generic HTTP.
- Укажите baseUrl вашего bridge и секрет.
- Объявите capabilities ровно те, что реально работают — лишние вызовут failed missions.
- Если сайт мультиязычный — отклоняйте неизвестные locale-префиксы (не мапьте тихо на default).
Проверка
- В кабинете → Подключение нажмите «Проверить» (health).
- Убедитесь, что capabilities включают нужные: listUrls, getPage, updateSeoMeta…
- Запустите тестовую миссию tech_meta на одной странице.
- Self-test + матрица: writableAnyPath или writable sample покрывает карточки/товары из sitemap.
- Миссия tech_sitemap / AEO: файл появился на /sitemap.xml или /llms.txt (или скачивается артефакт).
Важно
- Агент говорит только Site Connector Protocol — не нативный диалект CMS.
- Ключи не передаются в Embed / фронт партнёра.
- Каталог CMS pageKey — опциональный dual-write, не gate записи.
- Опционально: GET /metrics?range=7d + capability getSiteMetrics — worker тянет метрики без beacon.
Счётчик (beacon)
Опционально для метрик в AI-советнике:
Опционально: first-party счётчик для AI-советника (визиты, топ страниц). Кабинет → Подключение → «Счётчик сайта» → выпустить ключ bea_… Вставьте в <head> (подробно: /docs/connectors/beacon): <script async src="https://aita.dyadyasasha.ru/embed/seo-beacon.js" data-project="PROJECT_ID" data-key="bea_…" data-api="https://52525.ru/aita/api"></script> Без beacon советник работает в limited режиме (SEO/crawl без трафика).
Эндпоинты протокола: /docs/api · старт: getting started