Reference

SEO formatting guide

Every generated post follows the same deterministic structure, so downstream templates and CMS imports don’t have to special-case the output.

Field-by-field structure

Field	Purpose
title	Human-readable headline, also used as the H1 in outline.h1.
slugSuggestion	URL-safe slug derived from the title and primary keyword.
meta.description	Search-result meta description, kept under ~160 characters.
meta.primaryKeyword	The single keyword the post is optimized around.
outline.h1 / outline.h2	The heading hierarchy, generated before section content to keep structure consistent.
sections	Ordered array of typed blocks: introduction, body, faq, conclusion, or callout.
faqs	Present only when constraints.includeFAQs is true.
conclusion	Closing section, duplicated from the final “conclusion”-type section for convenience.
coverageNotes.keywordCoverage	Per-keyword evidence of where and whether it was actually used.

Determinism rules

Headings are generated before body content. The outline is fixed first from the keywords and constraints.maxSections, then each section is written to match its own heading — headings never get rewritten to fit the body.
tone affects sentence-level phrasing in contentMarkdown only — it never changes meta.description wording style, which stays search-intent-first regardless of tone.
region affects spelling/units (e.g. “colour” vs “color”) and locally relevant examples, but not the JSON structure itself.
language affects every text field’s language, but field names and structure remain identical across all languages.

Complete example

A full SEOPostV1 object with every field populated:

SEOPostV1

{
  "title": "AI Content Marketing for Small Businesses: A Practical Starting Point",
  "slugSuggestion": "ai-content-marketing-small-business",
  "meta": {
    "description": "A practical guide to using AI content marketing as a small business, without losing the voice your customers already trust.",
    "primaryKeyword": "ai content marketing"
  },
  "outline": {
    "h1": "AI Content Marketing for Small Businesses: A Practical Starting Point",
    "h2": [
      "Why small businesses are turning to AI content marketing",
      "Where AI helps most, and where it doesn't",
      "Keeping your brand voice consistent",
      "A simple weekly workflow",
      "Frequently asked questions"
    ]
  },
  "sections": [
    {
      "type": "introduction",
      "contentMarkdown": "Most small business owners don't have a marketing department. AI content marketing tools promise to fill that gap, but the real question isn't whether AI can write — it's whether it can write like *you*."
    },
    {
      "type": "body",
      "heading": "Why small businesses are turning to AI content marketing",
      "contentMarkdown": "Small business SEO used to mean choosing between hiring a writer or falling behind. AI content marketing changes that math by making a consistent publishing schedule achievable without a full-time hire."
    },
    {
      "type": "body",
      "heading": "Where AI helps most, and where it doesn't",
      "contentMarkdown": "AI is strongest at first drafts, outlines, and repetitive formats like FAQs. It's weakest at judgment calls that depend on knowing your actual customers — so keep a human review step for anything customer-facing."
    },
    {
      "type": "callout",
      "contentMarkdown": "A five-minute voice check before publishing catches most AI-sounding phrasing.",
      "callout": {
        "label": "Quick tip",
        "text": "Read the draft aloud. If it doesn't sound like something you'd actually say to a customer, rewrite that line."
      }
    },
    {
      "type": "body",
      "heading": "Keeping your brand voice consistent",
      "contentMarkdown": "Give the tool a short brand voice brief once, then reuse it: three adjectives, one thing you never say, and one real customer question you hear often."
    },
    {
      "type": "body",
      "heading": "A simple weekly workflow",
      "contentMarkdown": "Draft on Monday, review and edit Tuesday, publish Wednesday. Keeping a fixed cadence matters more than any individual post."
    },
    {
      "type": "faq",
      "heading": "Frequently asked questions",
      "contentMarkdown": ""
    },
    {
      "type": "conclusion",
      "contentMarkdown": "AI content marketing works best as a drafting partner, not a replacement for judgment. Start with one post a week and keep your own voice in the final pass."
    }
  ],
  "faqs": [
    {
      "question": "Will AI-written content hurt my SEO?",
      "answer": "Search engines rank content on quality and usefulness, not on how it was drafted. Editing for accuracy and voice before publishing is what matters."
    },
    {
      "question": "How much editing does an AI draft usually need?",
      "answer": "Expect to adjust specific claims, add real examples from your business, and tighten anything that reads generic."
    }
  ],
  "conclusion": "AI content marketing works best as a drafting partner, not a replacement for judgment. Start with one post a week and keep your own voice in the final pass.",
  "coverageNotes": {
    "keywordCoverage": [
      {
        "keyword": "ai content marketing",
        "covered": true,
        "evidence": "Appears in title, H1, and introduction."
      },
      {
        "keyword": "small business seo",
        "covered": true,
        "evidence": "Appears in the second H2 section."
      }
    ]
  }
}