Templates / SEO Content Agent

SEO Content Agent

An AI SEO content agent that turns a keyword into a content brief (search intent, titles, meta description, outline, FAQs and the gap competitors miss), then writes the full Markdown article section by section with an FAQ section, FAQPage JSON-LD and an on-page SEO check. It marks facts that need a source instead of inventing statistics.

Who it's for

Founders, marketers and agencies who publish SEO content and want a strong first draft in minutes, not a finished article with made-up facts.

What goes in

  • A target keyword
  • Optional: 3 to 5 competitor URLs
  • Your voice notes
  • An LLM API key

What comes out

  • A content brief (JSON) you can edit
  • A Markdown article with front matter and FAQ
  • FAQPage JSON-LD
  • PASS/FIX on-page checks

Setup in 4 steps

  1. Run the offline tests, then add your LLM key and voice.
  2. Run seo.py brief with your keyword and competitor URLs.
  3. Edit the brief, then run seo.py draft.
  4. Fix anything the SEO check flags, add your examples, publish.

Tool stack

n8n, Firecrawl, Claude Code

Cost per run

Estimate, not yet measured: about $0.004 per 1,500-word article on a small model (8 to 10 calls). The script prints real token usage.

What's included

  • n8n workflow JSON (form → brief → article → Google Sheet)
  • Python code version (stdlib only) + AGENTS.md for Claude Code / Cursor
  • README setup guide
  • Offline sample data + tests
  • Honest cost notes
  • Changelog

FAQ

Will the articles rank on their own?

No tool can promise rankings. The agent gives you a well-structured, on-intent draft fast; adding your own experience, examples and sources is what makes it rank.

Does it copy competitor content?

No. It reads only competitors' titles, headings and length to understand what searchers expect, and is told not to copy them.

Does it make up statistics?

It's instructed not to. Wherever a claim needs a source it writes [ADD SOURCE], and the SEO check fails until you replace those markers.

What does the SEO check cover?

Title length and keyword, meta description length, a single H1, keyword in the first 100 words, at least 3 H2 sections, word count and leftover source markers.