Подключение своего сайта
через Webhook

Content-Type: application/json
X-SeoSmith-Signature: sha256=<hmac-hex>
X-SeoSmith-Event: article.published

{
  "event": "article.published",
  "article": {
    "id": 123,
    "title": "Заголовок статьи (H1)",
    "slug": "slug-stati",
    "url": "slug-stati",
    "short_answer": "Короткий ответ по теме статьи",
    "insights": [
      "Первый ключевой тезис",
      "Второй ключевой тезис",
      "Третий ключевой тезис",
      "Четвёртый ключевой тезис"
    ],
    "body_html": "
Заголовок раздела
Основной текст статьи в HTML...
",
    "meta": {
      "title": "SEO-заголовок до 60 символов",
      "description": "Мета-описание до 165 символов",
      "keywords": ["ключевое слово 1", "ключевое слово 2"]
    },
    "faq": [
      { "q": "Вопрос?", "a": "Ответ." }
    ],
    "json_ld": "{...BlogPosting schema...}",
    "image_prompt": "Описание для генерации изображения",
    "alt_text": "Alt-текст для изображения"
  },
  "company": {
    "name": "Название компании",
    "site_url": "https://ваш-сайт.ru"
  }
}

// app/api/seosmith/route.ts
import { createHmac, timingSafeEqual } from "crypto";
import { NextRequest, NextResponse } from "next/server";

export async function POST(req: NextRequest) {
  const rawBody = await req.text();
  const signature = req.headers.get("x-seosmith-signature") ?? "";
  const received = signature.replace("sha256=", "");

  const expected = createHmac("sha256", process.env.SEOSMITH_WEBHOOK_SECRET!)
    .update(rawBody)
    .digest("hex");

  if (!timingSafeEqual(Buffer.from(expected), Buffer.from(received))) {
    return NextResponse.json({ error: "Invalid signature" }, { status: 401 });
  }

  const payload = JSON.parse(rawBody);
  if (payload.event !== "article.published") {
    return NextResponse.json({ ok: true, skipped: true });
  }

  const { article } = payload;
  // Сохраните или обновите статью по article.id или article.slug
  // body обычно приходит в markdown и должен быть отрендерен в HTML
  // await db.articles.upsert({ externalId: article.id, slug: article.slug, body_html: article.body_html, short_answer: article.short_answer, insights: article.insights, ... })

  return NextResponse.json({ ok: true });
}

// routes/api.php
Route::post('/seosmith', function (Request $request) {
    $rawBody = $request->getContent();
    $signature = $request->header('X-SeoSmith-Signature', '');
    $received = str_replace('sha256=', '', $signature);
    $expected = hash_hmac('sha256', $rawBody, env('SEOSMITH_WEBHOOK_SECRET'));

    if (!hash_equals($expected, $received)) {
        return response()->json(['error' => 'Invalid signature'], 401);
    }

    $payload = $request->json()->all();
    if (($payload['event'] ?? '') !== 'article.published') {
        return response()->json(['ok' => true, 'skipped' => true]);
    }

    $article = $payload['article'];
    // Article::updateOrCreate(['external_id' => $article['id']], ['slug' => $article['slug'], 'body' => $article['body'], ...]);

    return response()->json(['ok' => true]);
});

import hashlib, hmac, os
from fastapi import APIRouter, Header, HTTPException, Request
from fastapi.responses import JSONResponse

router = APIRouter()

@router.post("/api/seosmith")
async def receive_webhook(
    request: Request,
    x_seosmith_signature: str = Header(alias="X-SeoSmith-Signature"),
):
    raw_body = await request.body()
    secret = os.environ["SEOSMITH_WEBHOOK_SECRET"]
    expected = hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
    received = x_seosmith_signature.removeprefix("sha256=")

    if not hmac.compare_digest(expected, received):
        raise HTTPException(status_code=401, detail="Invalid signature")

    payload = await request.json()
    if payload.get("event") != "article.published":
        return JSONResponse({"ok": True, "skipped": True})

    article = payload["article"]
    # Сохраните статью в вашу БД
    return JSONResponse({"ok": True})

Добавь в проект POST-endpoint /api/seosmith для webhook SeoSmith.

Требования:
- читать raw body до JSON.parse;
- проверять HMAC-SHA256 подпись из X-SeoSmith-Signature по SEOSMITH_WEBHOOK_SECRET;
- принимать payload с event, article и company;
- если event !== article.published, возвращать { ok: true, skipped: true };
- если event === article.published, сохранять или обновлять статью по article.id или article.slug;
- не создавать дубль, если webhook пришёл повторно после правки статьи;
- сохранять title, slug, url, short_answer, insights, body_html, meta.title, meta.description, meta.keywords, faq, json_ld;
- для публичной страницы использовать body_html как готовый HTML статьи;
- обеспечить, чтобы статья открывалась по публичному URL и автоматически попадала в страницу раздела блога;
- использовать уже существующие стили, шаблоны и скрипты проекта для статьи и карточки блога.

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

curl -X POST https://ваш-сайт.ru/api/seosmith

SEOSMITH_WEBHOOK_SECRET=вставьте-секрет-здесь