
SEO Content Brief Generator Pro
What it does
Generate an SEO content brief from top 10 SERP results in one call. Analyzes search intent, extracts competitor keywords, suggests outline + word count + FAQ + content gaps + internal links. 100-point brief quality scoring.
Usage
import asyncio
from SEO_CONTENT_BRIEF import generate_brief
serp_data = [
{"rank": 1, "title": "Best Running Shoes 2026", "url": "ex.com/1", "word_count": 2500, "type": "listicle", "has_faq": True, "headings": ["Top Picks", "How We Tested"]},
{"rank": 2, "title": "Top 10 Reviewed", "url": "ex.com/2", "word_count": 1800, "type": "review", "has_faq": False, "headings": ["Reviews"]}
]
result = asyncio.run(generate_brief("best running shoes", serp_data))
print(f"Score: {result['score']['total']}/100")
print(f"Target word count: {result['target_word_count']}")
Features
Search intent detection (informational / commercial / transactional)
SERP analysis: median word count, dominant content type, FAQ count
Competitor keyword extraction: 15 primary + 20 long-tail variations
Outline generation: H1 + 3-6 H2 sections + FAQ + Conclusion
Word count target: median of top 10 + 15% buffer
FAQ section: 5+ People Also Ask-style questions with answer hints
Content gap identification: what competitors miss
Internal linking: 5+ topic cluster anchor suggestions
100-point quality scoring across 5 dimensions
Batch mode for content calendar
No external API needed — fully self-contained Python
Output example
Score: 93/100
Intent: commercial
Target word count: 2530
Outline: 8 sections
FAQ: 5
Internal links: 4
Testing
36/36 tests passing. Pure Python 3.10+, no external dependencies.


