Подключение через
Claude/Codex

В моём проекте нужен серверный endpoint для приёма webhook-запросов от сервиса SeoSmith.

Добавь POST-роут по пути /api/seosmith, используя текущий стек, роутинг, ORM и паттерны проекта. Не создавай новый отдельный микросервис, если в проекте уже есть backend или server routes.

Webhook получает:
- Заголовок X-SeoSmith-Signature со значением вида sha256=<hmac-hex>
- JSON body вида:
  {
    "event": "article.published",
    "article": {
      "id": 123,
      "title": "...",
      "slug": "...",
      "url": "...",
      "short_answer": "...",
      "insights": ["...", "...", "...", "..."],
      "body_html": "
Заголовок раздела
Основной текст статьи в HTML...
",
      "meta": { "title": "...", "description": "...", "keywords": ["..."] },
      "faq": [{ "q": "...", "a": "..." }],
      "json_ld": "{...}",
      "image_prompt": "...",
      "alt_text": "..."
    },
    "company": {
      "name": "...",
      "site_url": "https://example.com"
    }
  }

Реализуй логику:
1. Прочитай тело как raw text или raw bytes ДО JSON.parse
2. Вычисли HMAC-SHA256 от raw body с ключом из env-переменной SEOSMITH_WEBHOOK_SECRET
3. Сравни с подписью из X-SeoSmith-Signature через безопасное compare, а не через обычный ==
4. Если подпись невалидна — верни 401
5. Если event не article.published — верни 200 JSON { ok: true, skipped: true }
6. Если event корректный — сохрани или обнови статью в уже существующей модели/таблице/коллекции публикаций проекта
7. Сохрани минимум поля: title, slug, short_answer, insights, body_html, meta_title, meta_description, meta_keywords, faq, json_ld
8. Для публичной страницы используй article.body_html как готовый HTML статьи
9. Если webhook пришёл повторно после правки статьи, обнови существующую публикацию по article.id или article.slug, а не создавай дубль
10. Верни 200 JSON { ok: true }

Ограничения безопасности:
- Не хардкодь никакие секреты
- Не отключай проверку подписи даже временно
- Не логируй полное значение SEOSMITH_WEBHOOK_SECRET
- Не принимай GET/PUT вместо POST
- Не делай endpoint публичной формой импорта без проверки подписи
- Не заменяй безопасное сравнение подписи на обычное ==

В конце:
1. Покажи полный URL endpoint, который получится после деплоя
2. Объясни, куда добавить SEOSMITH_WEBHOOK_SECRET локально и на сервере
3. Скажи, что после добавления env нужно перезапустить приложение или контейнер
4. Дай короткую инструкцию по проверке endpoint после деплоя
5. Объясни, по какому правилу проект обновляет существующую статью вместо создания дубля

Не изобретай новую архитектуру. Встрой webhook в уже существующую систему публикаций проекта.

Сначала найди:
- где в проекте уже хранятся публичные статьи, блог-посты или страницы
- какой route pattern используется для публикаций
- какая ORM-модель или таблица отвечает за контент

После этого:
- используй существующую модель публикаций, если она подходит
- если модель отличается, добавь только минимальные поля для webhook-импорта
- не трогай клиентские страницы без необходимости
- не добавляй админку, если её нет

Если не можешь однозначно определить существующую модель хранения статей — не импровизируй, а задай мне конкретный вопрос по текущей структуре проекта.

Встрой webhook SeoSmith в мой текущий проект так, чтобы каждая новая статья автоматически появлялась в публичном разделе блога проекта.

Сделай это по правилам:
1. Используй существующую архитектуру проекта, текущий backend, router, ORM, CMS, файловую структуру или контентную папку.
2. Не создавай новый отдельный блог, новый frontend-раздел или параллельную CMS, если в проекте уже есть страница списка статей.
3. Найди, как в проекте сейчас формируется страница раздела блога: /blog, /articles, /insights или другой существующий route.
4. После приёма webhook article.published:
   - сохрани или обнови полную статью в существующей модели или файловой структуре публикаций;
   - сохрани slug, title, short_answer, insights, body_html, meta_title, meta_description, meta_keywords, faq, json_ld;
   - для публичной страницы используй article.body_html как готовый HTML статьи;
   - обеспечь, чтобы статья была доступна по публичному URL статьи;
   - выведи short_answer как отдельный короткий блок в начале статьи, если в проекте есть такой паттерн;
   - выведи insights как отдельный список «Главное из статьи», если проект поддерживает такие summary-блоки;
   - обеспечь, чтобы на странице раздела блога автоматически появилась карточка новой статьи со ссылкой на этот URL;
   - если webhook пришёл повторно после правки текста в SeoSmith, обнови существующую статью и её карточку по article.id или article.slug, не создавая дубль.
5. Для карточки статьи используй уже существующий шаблон списка статей, текущие CSS-классы, существующие UI-компоненты и текущие JS-скрипты проекта. Не создавай новый визуальный стиль, если в проекте уже есть карточки статей.
6. Если список блога строится из БД, обнови запрос/модель так, чтобы новая статья попадала в выборку.
7. Если список блога строится из файлов контента, создай файл в нужной папке и обнови механизм сборки или индекс, если это требуется.
8. Если проект использует статическую страницу index.html для раздела блога, автоматически обновляй её источник данных или пересобирай индекс так, чтобы новая карточка появлялась без ручного редактирования HTML.
9. Не ломай существующие стили и скрипты проекта. Новая статья и её карточка должны подтягивать те же CSS и JS, которые уже используются у существующих страниц блога.
10. Если в проекте нет отдельной страницы раздела блога, сначала найди ближайшую существующую страницу со списком публикаций и используй её. Если подходящей страницы нет, задай мне вопрос перед созданием новой структуры.

Требования безопасности для webhook:
- читать raw body до JSON.parse;
- проверять HMAC-SHA256 подпись через SEOSMITH_WEBHOOK_SECRET;
- сравнивать подпись только через безопасное compare;
- не хардкодить секрет;
- не отключать проверку подписи;
- не делать endpoint открытым для любого JSON.

В результате покажи:
1. Где именно в проекте теперь хранится статья.
2. Как именно обновляется страница раздела блога.
3. По какому URL открывается статья.
4. Почему карточка статьи автоматически появляется в списке блога.
5. Какие существующие стили, шаблоны или скрипты проекта были переиспользованы.
6. По какому правилу обновляется существующая статья вместо создания дубля.