Stop Writing SEO Content Manually! Use SEO Machine Instead

Let me ask you something brutal: How many hours did you waste last month on content that never ranked?

You've been there. Staring at a blank Google Doc at 11 PM. Keyword research scattered across five tabs. Competitor blogs open in another window. A half-formed outline that makes you want to delete everything. You finally publish at 2 AM, cross your fingers, and... crickets. Six months later, that 3,000-word masterpiece sits on page three of Google, collecting digital dust.

Here's the dirty secret nobody tells you: Manual SEO content creation is broken. The old playbook—hire writers, stuff keywords, pray for backlinks—doesn't work in 2025. Google's algorithms have evolved. Your competitors are using AI-powered systems. And you're still fighting with WordPress^{↗ Bright Coding Blog} formatting at midnight.

But what if you could press a button and have a complete research brief, competitive analysis, and optimized 3,000-word article—all in your brand voice, with proper internal linking, meta elements, and a publishing readiness score?

That's exactly what SEO Machine delivers. Built on Claude Code by Anthropic, this isn't another generic AI writing tool. It's a specialized workspace with custom commands, intelligent agents, and real-time data integrations that transform how businesses create long-form SEO content. Originally developed for Castos (a podcast hosting SaaS company), it's now open-source—and it's about to make your content workflow feel effortless.

Ready to see how the pros actually scale content production? Let's dive in.

What Is SEO Machine?

SEO Machine is a specialized Claude Code workspace designed specifically for creating long-form, SEO-optimized blog content for any business. Unlike generic AI writing assistants that spit out generic fluff, SEO Machine operates as an integrated content production system with structured workflows, intelligent automation, and data-driven optimization.

Created by Craig Hewitt and originally developed for Castos, SEO Machine represents a fundamental shift in how technical teams approach content marketing^{↗ Bright Coding Blog}. Rather than treating AI as a replacement for human creativity, it positions Claude as a collaborative partner—handling research synthesis, competitive analysis, technical SEO validation, and formatting, while you focus on strategic direction and quality control.

The repository has gained serious traction among developer-led marketing teams for one simple reason: it actually works. While most AI content tools promise rankings and deliver mediocrity, SEO Machine's architecture is built on real SEO fundamentals—search intent detection, keyword clustering, content length optimization against SERP competitors, and readability scoring. It doesn't just write; it optimizes based on what's currently winning in search results.

What makes this trend-worthy? We're witnessing a convergence of three forces: Claude Code's powerful agentic capabilities, the open-source movement in marketing technology, and the desperate need for quality content at scale. SEO Machine sits at this intersection, offering a system that technical founders and marketing engineers can actually customize, extend, and integrate into their existing stacks.

Key Features That Separate SEO Machine from Generic AI Tools

SEO Machine isn't a single tool—it's an ecosystem of specialized capabilities working in concert. Here's what makes it genuinely powerful:

Custom Command Workflows

The workspace provides 19 slash commands that map to real content production stages: /research, /write, /rewrite, /optimize, /analyze-existing, /publish-draft, and specialized variants for SERP analysis, competitor gaps, trending topics, and landing page creation. Each command isn't just a prompt—it's a structured workflow that saves outputs to organized directories and triggers downstream processes.

Intelligent Agent Swarm

After content generation, 10 specialized agents automatically analyze and improve your work:

• Content Analyzer: Uses 5 Python^{↗ Bright Coding Blog} modules for search intent classification, keyword density with TF-IDF clustering, SERP competitor length comparison, readability scoring (Flesch-Kincaid), and comprehensive SEO quality rating (0-100)
• SEO Optimizer: On-page analysis with featured snippet opportunity detection
• Meta Creator: Generates 5 title/description variations with conversion optimization
• Internal Linker: Strategic 3-5 link suggestions with exact placement and anchor text
• Keyword Mapper: Distribution heatmaps, LSI coverage, cannibalization risk detection
• Editor: "Humanity score" (0-100) with specific rewrites to eliminate robotic patterns
• Performance: Data-driven prioritization using GA4, GSC, and DataForSEO
• Headline Generator: 10+ variations with A/B testing strategies
• CRO Analyst & Landing Page Optimizer: Conversion-focused analysis for commercial pages

Real-Time Data Integrations

Unlike tools working in isolation, SEO Machine connects to Google Analytics 4, Google Search Console, and DataForSEO for actual performance insights. This means your content strategy is informed by real traffic patterns, not guesswork.

26 Marketing Skills

Beyond SEO, the system includes slash commands for copywriting^{↗ Bright Coding Blog}, CRO analysis, A/B test setup, email sequences, pricing strategy, programmatic SEO, and marketing psychology—making it a comprehensive marketing operations platform.

Context-Driven Intelligence

The secret sauce: 8 customizable context files that teach Claude your brand voice, writing style, SEO requirements, keyword targets, internal link structure, and competitive positioning. This isn't generic AI content—it's your content, systematized.

Real-World Use Cases Where SEO Machine Dominates

Use Case 1: Bootstrapped SaaS Scaling Content Without Hiring

You're a technical founder with zero marketing budget. You need 10 high-quality articles this quarter to capture organic search traffic. With SEO Machine, you run /research on your core topics, review the competitive briefs, execute /write for each article, and let the agent swarm handle optimization. Result: Production-grade content in hours, not weeks, without a single freelancer contract.

Use Case 2: Reviving Stagnant Blog Archives

Your company blog has 200 posts from 2019-2022. Traffic is flat. Rather than guessing which to update, run /analyze-existing on your URL list. The system scores each post (0-100), identifies quick wins, and prioritizes rewrites by traffic potential. Use /rewrite to refresh top candidates with current data and improved SEO. Result: 40% traffic increase from existing assets, not new production.

Use Case 3: Agency White-Label Content Production

You run a small SEO agency serving local businesses. Each client needs unique voice, different keyword targets, and consistent quality. Create separate context file sets per client in organized directories. The same /write command produces radically different output tuned to each brand. Result: Scale from 5 to 25 monthly clients without proportional headcount increase.

Use Case 4: Product-Led Growth with Landing Page Optimization

Your landing pages convert at 2% and you suspect above-the-fold issues. Use /landing-research to analyze competitors, /landing-write for conversion-optimized copy, then /landing-audit with the CRO Analyst and Landing Page Optimizer agents. The Python modules score CRO effectiveness (0-100) across headline, value proposition, CTA quality, trust signals, and page structure. Result: Data-driven page improvements with predicted impact scores.

Step-by-Step Installation & Setup Guide

Getting SEO Machine operational takes approximately 20 minutes. Here's the complete process:

Prerequisites

• Claude Code installed (claude.com/claude-code)
• Anthropic API account with billing configured
• Python 3.8+ for analysis modules
• Git for repository management

Installation Commands

Step 1: Clone the repository

git clone https://github.com/TheCraigHewitt/seomachine.git
cd seomachine

Step 2: Install Python dependencies

pip install -r data_sources/requirements.txt

This single command installs the entire analysis stack:

• Google Analytics 4 and Google Search Console API clients
• DataForSEO API client for competitive intelligence
• NLP libraries (nltk, textstat) for readability and semantic analysis
• Machine learning toolkit (scikit-learn) for keyword clustering
• Web scraping utilities (beautifulsoup4) for SERP analysis

Step 3: Launch in Claude Code

claude-code .

This opens the workspace with all custom commands, agents, and skills loaded.

Critical Configuration: Context Files

The quality of your output depends entirely on customizing the 8 context templates. Do not skip this step.

Pro tip: The examples/castos/ directory contains a complete, filled-out example for a podcast hosting SaaS. Study it as your reference implementation.

Optional: Analytics & Publishing Integrations

For full functionality, configure these additional components:

Google Analytics 4 & Search Console: Follow data_sources/README.md for service account setup and credential configuration.

DataForSEO: Add API credentials to data_sources/config/ for competitive ranking data.

WordPress Publishing: Install wordpress/seo-machine-yoast-rest.php as an MU-plugin, add wordpress/functions-snippet.php to your theme, and configure .env:

WP_URL=https://yoursite.com
WP_USERNAME=your_username
WP_APP_PASSWORD=your_application_password

REAL Code Examples from SEO Machine

Let's examine actual implementation patterns from the repository, with detailed explanations of how each component functions.

Example 1: Research Command Workflow

The /research command is your content intelligence foundation. Here's how you execute it and what happens under the hood:

# Terminal execution - triggers Claude's research workflow
/research content marketing strategies for B2B SaaS

What the system executes:

# Conceptual flow based on research_quick_wins.py and research_serp_analysis.py
# These are the actual Python modules in data_sources/modules/

from data_sources.modules.search_intent_analyzer import SearchIntentAnalyzer
from data_sources.modules.keyword_analyzer import KeywordAnalyzer
from data_sources.modules.content_length_comparator import ContentLengthComparator

# 1. Classify search intent for target keyword
intent_analyzer = SearchIntentAnalyzer()
intent_result = intent_analyzer.analyze("content marketing strategies for B2B SaaS")
# Returns: informational (confidence: 0.94), with SERP feature analysis

# 2. Fetch and analyze top 10-20 SERP competitors
comparator = ContentLengthComparator()
competitor_data = comparator.fetch_serp_competitors("content marketing strategies for B2B SaaS")
# Calculates median word count, 75th percentile, identifies content gaps

# 3. Generate comprehensive research brief with keyword clustering
keyword_analyzer = KeywordAnalyzer()
clusters = keyword_analyzer.cluster_keywords(
    primary="content marketing strategies",
    related=competitor_data.extracted_keywords,
    method="tfidf-kmeans"  # Uses scikit-learn for topic clustering
)
# Outputs: primary/secondary keywords, content gaps, recommended outline

# Final output saved to: /research/brief-content-marketing-strategies-2025-10-29.md

Why this matters: Instead of manually browsing competitors and guessing word counts, you get data-driven intelligence—exactly how long your content should be, what subtopics you're missing, and where search intent is heading.

Example 2: Content Analyzer Agent (5-Module System)

The Content Analyzer is SEO Machine's most technically sophisticated component. Here's the actual Python architecture:

# From data_sources/modules/ - the 5 analysis engines

# Module 1: Search Intent Detection
from search_intent_analyzer import SearchIntentAnalyzer

analyzer = SearchIntentAnalyzer()
result = analyzer.classify_query("best CRM for small business")
# Returns: {
#   'intent': 'commercial_investigation',
#   'confidence': 0.89,
#   'serp_features': ['featured_snippet', 'people_also_ask', 'shopping_results'],
#   'content_recommendation': 'comparison-focused with clear buying criteria'
# }

# Module 2: Keyword Density & Topic Clustering
from keyword_analyzer import KeywordAnalyzer

kw_analyzer = KeywordAnalyzer()
density_report = kw_analyzer.analyze(
    content=article_text,
    primary_keyword="CRM software",
    lsi_keywords=["customer relationship management", "sales pipeline", "contact management"]
)
# Returns: exact density %, distribution heatmap by H2 section,
# keyword stuffing risk warning, TF-IDF topic clusters

# Module 3: SERP Competitor Length Analysis
from content_length_comparator import ContentLengthComparator

comparator = ContentLengthComparator()
length_analysis = comparator.compare(
    your_content=article_text,
    target_keyword="best CRM for small business",
    serp_count=20  # Analyze top 20 results
)
# Returns: your_word_count: 1800, median_competitor: 3200,
# percentile_75: 4100, recommendation: "expand by 1400+ words"

# Module 4: Readability Scoring
from readability_scorer import ReadabilityScorer

scorer = ReadabilityScorer()
readability = scorer.calculate(article_text)
# Returns: {
#   'flesch_reading_ease': 52.3,  # Fairly difficult
#   'flesch_kincaid_grade': 10.2,  # 10th grade level
#   'avg_sentence_length': 18.5,
#   'passive_voice_ratio': 0.12,  # 12% passive (target: <10%)
#   'complex_word_ratio': 0.23
# }

# Module 5: Comprehensive SEO Quality Rating
from seo_quality_rater import SEOQualityRater

rater = SEOQualityRater()
final_score = rater.rate(article_text, seo_guidelines)
# Returns: {
#   'overall_score': 78,  # 0-100
#   'breakdown': {
#     'content_quality': 82,
#     'keyword_optimization': 75,
#     'meta_elements': 90,
#     'structure': 80,
#     'links': 70,
#     'readability': 71
#   },
#   'publishing_readiness': 'high_priority_improvements_needed',
#   'critical_issues': ['keyword density 0.3% (target: 1-2%)', 'missing alt text on images'],
#   'quick_wins': ['add H3 subheadings every 300 words', 'include 2 more internal links']
# }

Integration point: These modules execute automatically when you run /optimize, producing the optimization report with actionable, prioritized fixes rather than vague advice.

Example 3: Complete Content Production Workflow

Here's the actual terminal workflow for creating publish-ready content:

# Step 1: Research (generates intelligence brief)
/research content marketing strategies for B2B SaaS
# Output: /research/brief-content-marketing-strategies-2025-10-29.md

# Step 2: Write (creates optimized draft, triggers 4 agents automatically)
/write content marketing strategies for B2B SaaS
# Output: /drafts/content-marketing-strategies-2025-10-29.md
# Auto-triggers: SEO Optimizer, Meta Creator, Internal Linker, Keyword Mapper

# Step 3: Review agent outputs (read these generated reports)
cat drafts/seo-optimization-report-content-marketing-strategies.md
cat drafts/meta-options-content-marketing-strategies.md
cat drafts/internal-link-suggestions-content-marketing-strategies.md
cat drafts/keyword-distribution-map-content-marketing-strategies.md

# Step 4: Final optimization pass
/optimize drafts/content-marketing-strategies-2025-10-29.md
# Output: /drafts/optimization-report-content-marketing-strategies-2025-10-29.md
# Includes: final SEO score (0-100), priority fixes, publishing readiness

# Step 5: Publish to WordPress (optional, with Yoast SEO metadata)
/publish-draft drafts/content-marketing-strategies-2025-10-29.md
# Publishes with: meta title, description, focus keyword, Open Graph tags

The automation advantage: What traditionally requires 5 tools (Ahrefs, Google Docs, Yoast, WordPress, Grammarly) and 8-12 hours now happens in a unified workspace with consistent context.

Example 4: Existing Content Refresh Workflow

For updating stale content, the system provides precise analysis:

# Analyze existing post for improvement opportunities
/analyze-existing https://yoursite.com/blog/marketing-guide
# Alternative: /analyze-existing published/marketing-guide-2024-01-15.md

# The system generates:
# - Content health score: 62/100
# - Quick wins: "Update statistics from 2023 to 2025, add H3 subheadings"
# - Strategic improvements: "Expand competitor comparison section, add video embed"
# - Rewrite priority: HIGH (score <70, traffic declining 15% MoM)
# - Research brief for rewrite saved to /research/

# Execute rewrite based on analysis
/rewrite marketing guide
# Output: /rewrites/marketing-guide-rewrite-2025-10-29.md
# Includes: change summary, before/after comparison, updated SEO elements

Advanced Usage & Best Practices

Maximizing Agent Effectiveness

The agent swarm is powerful, but sequence matters. Always run /research before /write—the research brief becomes the article's structural DNA. After writing, review agent outputs before optimizing; the SEO Optimizer's recommendations inform what /optimize should prioritize.

Context File Evolution

Your writing-examples.md is a living document. Every quarter, replace weaker examples with your best-performing posts. The Editor agent learns from these, so quality compounds over time.

Batch Operations for Scale

Research multiple topics in single sessions, then write in batches. The system's directory structure (topics/, research/, drafts/, review-required/, published/) supports pipeline workflows. Use /priorities with GA4/GSC data to identify highest-impact topics first.

The /scrub Command: AI Detection Evasion

Before publishing, run /scrub on your draft. This removes AI watermarks—excessive em-dashes, filler phrases like "it's important to note," and robotic transition patterns. Combined with the Editor's "humanity score," this keeps your content natural.

Landing Page CRO Integration

For commercial pages, combine /landing-research with the six CRO Python modules. The above_fold_analyzer.py scores headline clarity, value proposition strength, and CTA visibility—critical for pages where SEO traffic must convert.

Comparison with Alternatives

The verdict: SEO Machine wins on integration depth, customization, and technical SEO rigor. It's not for marketers wanting a simple web app—it's for technical teams who need a system they can extend, debug, and optimize.

Frequently Asked Questions

Q: Do I need Claude Code Pro to use SEO Machine effectively? A: Yes, you'll need sufficient API credits for extended research and writing sessions. Complex articles with full agent analysis may consume $2-5 in API costs—still dramatically cheaper than freelance writers.

Q: How does this compare to ChatGPT with SEO plugins? A: ChatGPT lacks persistent context across sessions, custom command workflows, directory-based organization, and the specialized Python analysis modules. SEO Machine is a production system, not a chat interface.

Q: Can I use this for client work without exposing their data? A: Absolutely. Context files are local, and API calls go directly to Anthropic. No data passes through third-party servers. Create separate context directories per client for complete isolation.

Q: What if the generated content doesn't match my brand voice? A: This indicates insufficient context configuration. Add 5+ diverse writing examples, expand brand-voice.md with specific voice pillars, and reference particular examples in your /write commands.

Q: How accurate are the SEO scores and recommendations? A: The 0-100 scoring uses established metrics (Flesch-Kincaid, TF-IDF, SERP comparison) with clear category breakdowns. However, always apply human judgment—Google's algorithm has nuance no tool captures perfectly.

Q: Is WordPress publishing required, or can I export to other CMS platforms? A: WordPress integration is optional. Articles save as Markdown^{↗ Smart Converter} files you can import anywhere. The Yoast REST API plugin is simply a convenience for WordPress users.

Q: How often should I update context files? A: Weekly for keyword opportunities, monthly for writing examples and internal links, quarterly for full competitive analysis refreshes. Stale context produces stale content.

Conclusion: The Future of Technical Content Marketing Is Here

SEO Machine represents something rare in the AI tooling landscape: a system built by practitioners, for practitioners. Craig Hewitt didn't create another generic writing assistant—he open-sourced the exact workflow that scaled Castos's content operation, then made it adaptable for any business with technical marketing talent.

The implications are significant. For years, SEO content creation has been bottlenecked by either expensive agency retainers or inconsistent freelance quality. SEO Machine offers a third path: systematized excellence where AI handles research synthesis, technical optimization, and formatting, while humans direct strategy and ensure quality.

Is it perfect? No. You'll still need to configure context files thoughtfully, review agent recommendations critically, and apply editorial judgment. But compared to the alternative—staring at blank documents, manually checking keyword densities, forgetting internal links, publishing at 2 AM with fingers crossed—this is a fundamental productivity multiplier.

The repository is actively maintained, contributions are welcome, and the examples/castos/ directory proves it works in production. If you're technical enough to run git clone and edit Markdown files, you're technical enough to build a content engine that outproduces teams ten times your size.

Your move. Clone SEO Machine, configure your context files using the Castos example as your blueprint, and run your first /research command. Your future self—the one not rewriting mediocre content at midnight—will thank you.

Happy writing. 🚀