Webhook Integration

const express = require('express');
const app = express();
app.use(express.json());

app.post('/api/webhook', (req, res) => {
  const secret = req.headers['x-webhook-secret'];

  if (secret !== process.env.FIRSTSEARCH_WEBHOOK_SECRET) {
    return res.status(401).json({ error: 'Invalid secret' });
  }

  // Authenticated — process the article
  const { title, content, slug, seo, featuredImage } = req.body;
  console.log('Received article:', title);

  // IMPORTANT: Use featuredImage as your hero/cover image
  // It is NOT embedded in the content — you must set it separately
  if (featuredImage?.url) {
    console.log('Hero image:', featuredImage.url);    // Permanent URL (1200x630)
    console.log('Alt text:', featuredImage.alt);       // SEO-optimized alt
  }

  // Create post in your CMS here...

  res.status(200).json({ success: true });
});

app.listen(3000);

import os
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/api/webhook', methods=['POST'])
def webhook():
    secret = request.headers.get('X-Webhook-Secret', '')

    if secret != os.environ['FIRSTSEARCH_WEBHOOK_SECRET']:
        return jsonify({'error': 'Invalid secret'}), 401

    # Authenticated — process the article
    article = request.get_json()
    print(f"Received article: {article['title']}")

    # IMPORTANT: Use featuredImage as your hero/cover image
    # It is NOT embedded in the content — you must set it separately
    featured = article.get('featuredImage', {})
    if featured.get('url'):
        print(f"Hero image: {featured['url']}")    # Permanent URL (1200x630)
        print(f"Alt text: {featured['alt']}")       # SEO-optimized alt

    # Create post in your CMS here...

    return jsonify({'success': True}), 200

<?php
$secret = $_SERVER['HTTP_X_WEBHOOK_SECRET'] ?? '';

if ($secret !== getenv('FIRSTSEARCH_WEBHOOK_SECRET')) {
    http_response_code(401);
    echo json_encode(['error' => 'Invalid secret']);
    exit;
}

// Authenticated — process the article
$article = json_decode(file_get_contents('php://input'), true);
error_log('Received article: ' . $article['title']);

// IMPORTANT: Use featuredImage as your hero/cover image
// It is NOT embedded in the content — you must set it separately
if (!empty($article['featuredImage']['url'])) {
    $heroUrl = $article['featuredImage']['url'];   // Permanent URL (1200x630)
    $heroAlt = $article['featuredImage']['alt'];    // SEO-optimized alt
}

// Create post in your CMS here...

http_response_code(200);
echo json_encode(['success' => true]);

add_action('rest_api_init', function () {
  register_rest_route('firstsearch/v1', '/webhook', [
    'methods' => 'POST',
    'callback' => 'handle_firstsearch_webhook',
    'permission_callback' => '__return_true',
  ]);
});

function handle_firstsearch_webhook($request) {
  $secret = $request->get_header('X-Webhook-Secret');

  if ($secret !== get_option('firstsearch_webhook_secret')) {
    return new WP_Error('unauthorized', 'Invalid secret', ['status' => 401]);
  }

  // Authenticated — create the post
  $article = $request->get_json_params();

  $post_id = wp_insert_post([
    'post_title'   => sanitize_text_field($article['title']),
    'post_content' => wp_kses_post($article['content']),
    'post_excerpt' => sanitize_text_field($article['excerpt'] ?? ''),
    'post_status'  => 'draft',  // Save as draft for review
    'post_type'    => 'post',
    'post_name'    => sanitize_title($article['slug']),
  ]);

  return ['success' => true, 'post_id' => $post_id];
}

const crypto = require('crypto');
const express = require('express');
const app = express();

// Important: preserve raw body for signature verification
app.use(express.json({
  verify: (req, res, buf) => {
    req.rawBody = buf.toString('utf8');
  }
}));

app.post('/api/webhook', (req, res) => {
  const secret = process.env.FIRSTSEARCH_WEBHOOK_SECRET;

  // Step 1: Verify secret header (required)
  if (req.headers['x-webhook-secret'] !== secret) {
    return res.status(401).json({ error: 'Invalid secret' });
  }

  // Step 2: Verify HMAC signature (optional, additional security)
  const signature = req.headers['x-webhook-signature'];
  const expected = crypto
    .createHmac('sha256', secret)
    .update(req.rawBody)
    .digest('hex');

  if (signature !== expected) {
    return res.status(401).json({ error: 'Invalid signature' });
  }

  // Step 3: Check timestamp freshness (optional, prevents replay attacks)
  const timestamp = req.headers['x-webhook-timestamp'];
  const now = Math.floor(Date.now() / 1000);
  if (Math.abs(now - parseInt(timestamp)) > 300) {
    return res.status(401).json({ error: 'Timestamp expired' });
  }

  // Process the article
  const article = req.body;
  console.log('Received article:', article.title);

  res.status(200).json({ success: true });
});

app.listen(3000);

import hmac
import hashlib
import time
import os
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/api/webhook', methods=['POST'])
def webhook():
    secret = os.environ['FIRSTSEARCH_WEBHOOK_SECRET']

    # Step 1: Verify secret header (required)
    if request.headers.get('X-Webhook-Secret', '') != secret:
        return jsonify({'error': 'Invalid secret'}), 401

    # Step 2: Verify HMAC signature (optional, additional security)
    signature = request.headers.get('X-Webhook-Signature', '')
    expected = hmac.new(
        secret.encode('utf-8'),
        request.get_data(),
        hashlib.sha256
    ).hexdigest()

    if not hmac.compare_digest(signature, expected):
        return jsonify({'error': 'Invalid signature'}), 401

    # Step 3: Check timestamp freshness (optional)
    timestamp = request.headers.get('X-Webhook-Timestamp', '0')
    if abs(time.time() - int(timestamp)) > 300:
        return jsonify({'error': 'Timestamp expired'}), 401

    # Process the article
    article = request.get_json()
    print(f"Received article: {article['title']}")

    return jsonify({'success': True}), 200

{
  "title": "How to Optimize Images for Web Performance",
  "content": "## Quick Summary\n\n- Compress images...\n\n## Why Image Optimization Matters\n\nPage speed directly affects...",
  "excerpt": "Learn how to optimize images for faster page loads and better SEO rankings.",
  "slug": "optimize-images-web-performance",
  "seo": {
    "metaTitle": "How to Optimize Images for Web Performance",
    "metaDescription": "Learn how to optimize images for faster page loads and better SEO rankings.",
    "focusKeyword": "optimize images for web"
  },
  "featuredImage": {
    "url": "https://replicate.delivery/...",
    "alt": "Web performance optimization dashboard showing image compression results",
    "width": 1200,
    "height": 630
  },
  "openGraph": {
    "title": "How to Optimize Images for Web Performance",
    "description": "Learn how to optimize images for faster page loads.",
    "type": "article",
    "image": "https://replicate.delivery/..."
  },
  "metadata": {
    "keyword": "optimize images for web",
    "wordCount": 3200,
    "readingTime": 16,
    "difficulty": 35,
    "searchVolume": 1200
  },
  "publishDate": "2026-02-08T00:05:00.000Z",
  "updatedAt": null,
  "isUpdate": false,
  "status": "publish",
  "author": "Jane Smith",
  "categories": ["Web Development"],
  "tags": ["image optimization", "page speed", "web performance"],
  "schema": { "@context": "https://schema.org", "@type": "Article", "headline": "...", "..." : "..." },
  "faqSchema": {
    "@context": "https://schema.org",
    "@type": "FAQPage",
    "mainEntity": [
      { "@type": "Question", "name": "What is image optimization?", "acceptedAnswer": { "@type": "Answer", "text": "Image optimization is..." } }
    ]
  }
}

*Last Updated: March 15, 2026*

## Key Takeaways
- First key insight from the article
- Second key insight
- Third key insight
- Fourth key insight

## Introduction Section
Opening paragraph with direct answer to the search query...

![Alt text describing the image](https://storage.googleapis.com/.../image.webp)

More content with [external links](https://example.com) to sources...

## Body Sections (Multiple H2s)
Each major topic gets its own H2 heading. Sections may contain:

### Subsections (H3)
Deeper dives within a section use H3 headings.

<div class="video-container" style="...">
  <iframe src="https://www.youtube.com/embed/..." ...></iframe>
</div>

## FAQ
### What is the first common question?
Direct answer to the question in 2-3 sentences.

### What about the second question?
Another clear, concise answer.

## Conclusion
Final summary with call-to-action.

{
  "featuredImage": {
    "url": "https://storage.googleapis.com/.../featured.webp",
    "alt": "AI-generated illustration of web performance optimization",
    "width": 1200,
    "height": 630
  }
}

<div class="video-container" style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; margin: 2rem 0; border-radius: 12px;">
  <iframe
    src="https://www.youtube.com/embed/VIDEO_ID?rel=0"
    title="Video Title"
    style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; border: 0;"
    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
    allowfullscreen
    loading="lazy">
  </iframe>
</div>

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How to Optimize Images for Web Performance",
  "description": "Learn how to optimize images for faster page loads and better SEO.",
  "author": {
    "@type": "Person",
    "name": "Jane Smith"
  },
  "datePublished": "2026-03-15T00:05:00.000Z",
  "wordCount": 3200,
  "keywords": "optimize images for web",
  "image": ["https://storage.googleapis.com/.../featured.webp"]
}

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is image optimization?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Image optimization is the process of reducing file size while maintaining visual quality. This includes compression, format selection (WebP, AVIF), and responsive sizing."
      }
    },
    {
      "@type": "Question",
      "name": "Does image format affect SEO?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Yes. Modern formats like WebP load faster, improving Core Web Vitals scores. Google uses page speed as a ranking factor, so optimized images directly impact your search rankings."
      }
    }
  ]
}

app.post('/api/webhook', (req, res) => {
  const article = req.body;

  // Build the schema script tags for the page <head>
  const schemaScripts = [];

  // Article schema (always present)
  if (article.schema) {
    schemaScripts.push(
      `<script type="application/ld+json">${JSON.stringify(article.schema)}</script>`
    );
  }

  // FAQ schema (only if article has FAQ section)
  if (article.faqSchema) {
    schemaScripts.push(
      `<script type="application/ld+json">${JSON.stringify(article.faqSchema)}</script>`
    );
  }

  // Store schemaScripts with the article for rendering
  saveArticle({
    ...article,
    schemaHtml: schemaScripts.join('\n'),
  });

  res.status(200).json({ success: true });
});

// In your article page component
import Head from 'next/head'; // Next.js, or use react-helmet

function ArticlePage({ article }) {
  return (
    <>
      <Head>
        <title>{article.seo.metaTitle}</title>
        <meta name="description" content={article.seo.metaDescription} />

        {/* Article structured data */}
        {article.schema && (
          <script
            type="application/ld+json"
            dangerouslySetInnerHTML={{ __html: JSON.stringify(article.schema) }}
          />
        )}

        {/* FAQ structured data (rich snippets) */}
        {article.faqSchema && (
          <script
            type="application/ld+json"
            dangerouslySetInnerHTML={{ __html: JSON.stringify(article.faqSchema) }}
          />
        )}
      </Head>

      <article>
        <h1>{article.title}</h1>
        {/* Render article.content with a Markdown renderer */}
      </article>
    </>
  );
}

function handle_firstsearch_webhook($request) {
  $article = $request->get_json_params();

  $post_id = wp_insert_post([
    'post_title'   => sanitize_text_field($article['title']),
    'post_content' => wp_kses_post($article['content']),
    'post_status'  => 'draft',
    'post_type'    => 'post',
    'post_name'    => sanitize_title($article['slug']),
  ]);

  // Save structured data as post meta for your theme to render
  if (!empty($article['schema'])) {
    update_post_meta($post_id, '_article_schema', wp_json_encode($article['schema']));
  }
  if (!empty($article['faqSchema'])) {
    update_post_meta($post_id, '_faq_schema', wp_json_encode($article['faqSchema']));
  }

  return ['success' => true, 'post_id' => $post_id];
}

// Then in your theme's header.php or via wp_head hook:
add_action('wp_head', function() {
  if (is_single()) {
    $schema = get_post_meta(get_the_ID(), '_article_schema', true);
    if ($schema) {
      echo '<script type="application/ld+json">' . $schema . '</script>';
    }
    $faq = get_post_meta(get_the_ID(), '_faq_schema', true);
    if ($faq) {
      echo '<script type="application/ld+json">' . $faq . '</script>';
    }
  }
});