SEO Machine is an open-source Claude Code workspace that transforms AI-assisted content creation into a complete SEO production pipeline. Built by Craig Hewitt (creator of the Castos podcast hosting platform), it provides specialized agents, custom commands, and data integrations that automate every step from keyword research through content writing to performance tracking, all driven by Claude Code's agentic capabilities. ## From Manual SEO to Agentic Content Production Traditional SEO content workflows involve juggling multiple tools: keyword research platforms, content editors, SEO analyzers, rank trackers, and analytics dashboards. SEO Machine consolidates these into a single Claude Code workspace where natural language commands trigger multi-step agentic workflows. A single `/article` command researches keywords, analyzes SERPs, outlines the article, writes long-form content, optimizes on-page elements, generates meta tags, and produces a publish-ready draft. ## Custom Commands SEO Machine defines over 15 slash commands that map to specific content workflows: | Command | Purpose | |---------|--------| | `/research` | Deep keyword and topic research with competitive analysis | | `/research-serp` | SERP feature analysis and search intent classification | | `/research-gaps` | Content gap identification against competitors | | `/research-trending` | Trending topic discovery for content planning | | `/write` | Full long-form article generation with SEO optimization | | `/rewrite` | Rewrite existing content with improved SEO signals | | `/analyze-existing` | Audit existing content for SEO weaknesses | | `/optimize` | On-page optimization of title, meta, headings, and internal links | | `/performance-review` | Data-driven content performance analysis | | `/publish-draft` | Generate publish-ready formatted draft | | `/landing-write` | Landing page copy generation | | `/landing-audit` | Landing page conversion optimization audit | | `/priorities` | Prioritize content tasks based on impact and effort | ## Specialized Agents The workspace deploys 10 specialized agents, each responsible for a distinct aspect of the content pipeline: - **Content Analyzer**: Classifies search intent, measures keyword density, evaluates readability, and scores content length against SERP competitors. - **SEO Optimizer**: Performs on-page analysis including heading structure, keyword placement, image alt text, and URL optimization. - **Meta Creator**: Generates optimized title tags and meta descriptions with character count validation and click-through rate optimization. - **Internal Linker**: Recommends strategic internal link placements based on site map analysis and topical relevance. - **Keyword Mapper**: Maps primary, secondary, and LSI keywords to specific content sections for natural distribution. - **Editor**: Humanizes AI-generated content to match brand voice guidelines and reduce detectable AI patterns. - **Performance Analyzer**: Connects to analytics data to prioritize content updates based on traffic, ranking, and conversion metrics. - **Headline Generator**: Creates multiple headline variants optimized for both search engines and social sharing. - **CRO Analyst**: Analyzes conversion rate optimization opportunities within content pages. - **Landing Page Optimizer**: Specializes in above-the-fold copy, CTA placement, and trust signal optimization. ## Data Integrations SEO Machine connects to three data sources for real-time intelligence: 1. **Google Analytics 4**: Traffic patterns, user engagement, bounce rates, and conversion data feed into content prioritization decisions. 2. **Google Search Console**: Keyword rankings, impressions, click-through rates, and indexing status inform optimization strategies. 3. **DataForSEO**: Competitive keyword rankings, SERP feature tracking, and content gap analysis provide market intelligence. ## Marketing Skills Library Beyond SEO, the workspace includes 26 marketing skills covering copywriting frameworks, CRO optimization, A/B testing design, email sequence creation, pricing strategy, social content adaptation, paid ad copy, schema markup generation, and analytics tracking setup. These skills extend the workspace from pure SEO into a broader content marketing toolkit. ## SEO Quality Scoring Five Python analysis modules provide quantitative content evaluation: - Search intent detection and classification - Keyword density analysis and semantic clustering - Content length comparison against top-ranking competitors - Flesch Reading Ease and readability metrics - Composite SEO quality score (0-100) aggregating all signals ## Community and Adoption With 1,200 GitHub stars and 271 forks as of March 2026, SEO Machine has gained traction among content teams looking to systematize AI-driven SEO workflows. Originally built for the Castos podcast platform's content needs, it was open-sourced to serve any business. The project demonstrates a practical application of Claude Code's agent architecture beyond software development.