Content Brief Generator

Content Intelligence First

Before generating a brief, run scripts/analyze-keywords.ts (local-first, no API key) on the target or a top competitor URL. Use the result to shape target keywords, semantic variants, heading coverage, local modifiers, and stuffing warnings.

bun run scripts/analyze-keywords.ts <url-or-path> --keyword "<primary keyword>" --synonyms "<syn1,syn2>" --locations "<city1,city2>" --format markdown

Metadata and Heading Rules

• Meta title must be 60 characters or less.
• Meta description must be 150 characters or less.
• Do not include the company or brand name in the meta title unless the client explicitly asks. If useful, provide a branded variant as an option or exception.
• Meta title and H1 should be semantically similar, but not necessarily identical.
• Meta title and H1 need the primary keyword or a strong variant.
• H2/H3 headings should distribute synonyms, long-tail phrases, questions, and sub-intents.
• Avoid repeating the exact keyword across every heading.