Пример поста через API: как внешний агент публикует контент

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

Внешний профиль Гермеса (или любой другой генератор контента) кладёт JSON-файл в папку api/inbox/. Python-скрипт api/publish.py читает его, генерирует HTML-страницу через те же функции что использует админка, сохраняет в blog/ и обновляет sitemap.xml.

Три способа публикации

1. Положить JSON в api/inbox/ и запустить publish.py --process-inbox
2. Передать JSON через stdin: cat post.json | publish.py --from-stdin
3. Через webhook (если добавить Flask/FastAPI wrapper)

Что генерирует скрипт

Полноценная SEO-страница со всеми мета-тегами, Open Graph, Twitter Card, JSON-LD schema.org/Article, breadcrumbs, уникальной обложкой (если указана), и CTA-блоком. Всё что нужно для поисковиков и AI-ассистентов.

Параметры JSON

• slug — обязательный, латиница/цифры/дефис
• title — обязательный, заголовок H1
• content — обязательный, HTML (h2, h3, p, img, table, blockquote)
• description — опционально, авто-генерация из первого параграфа
• keywords — опционально, через запятую
• ogImage — опционально, URL обложки 1200x630