A specialized Claude Code workspace designed to automate and optimize long-form, SEO-driven blog content creation. It targets businesses and content creators seeking to improve search rankings and audience engagement by streamlining the entire content lifecycle, from research and writing to analysis and optimization, all while adhering to specific brand guidelines and SEO best practices.

How It Works

SEO Machine operates via custom Claude Code commands and specialized AI agents. The workflow begins with /research to gather keywords, competitor insights, and content gaps, generating a detailed brief. The /write command then produces long-form articles (2000-3000+ words) guided by user-defined context files (brand voice, style guide, SEO guidelines, target keywords). Post-writing, automated agents like the SEO Optimizer, Meta Creator, and Internal Linker refine the content. Advanced analysis is performed by the Content Analyzer agent, which utilizes five modules for search intent, keyword density, content length, readability, and SEO quality scoring. Integrations with Google Analytics 4, Google Search Console, and DataForSEO provide real-time performance data to inform content strategy and updates.

Quick Start & Requirements

• Primary Install/Run: Requires Claude Code installation and an Anthropic API account. Clone the repository (git clone), install Python dependencies (pip install -r data_sources/requirements.txt), and launch via claude-code ..
• Prerequisites: Claude Code, Anthropic API key. Python 3.x environment with libraries including nltk, textstat, scikit-learn, beautifulsoup4. API credentials for Google Analytics/Search Console and DataForSEO are necessary for full data integration.
• Setup: Crucial configuration involves filling out context files (context/brand-voice.md, context/writing-examples.md, context/style-guide.md, context/seo-guidelines.md, context/target-keywords.md, context/internal-links-map.md, context/competitor-analysis.md).
• Links: An example setup for a podcast hosting SaaS company is available in examples/castos/.

Highlighted Details

• Advanced SEO Analysis Modules: Features five specialized Python modules for deep content evaluation: Search Intent Analyzer, Keyword Analyzer, SEO Quality Rater, Content Length Comparator, and Readability Scorer.
• Real-time Data Integrations: Connects with Google Analytics 4, Google Search Console, and DataForSEO to incorporate live performance metrics and competitive intelligence into content strategy.
• Specialized Agent Suite: Includes agents for SEO optimization, meta element creation, internal linking, keyword mapping, content editing, and performance analysis, automating complex tasks.
• Context-Driven Personalization: Relies heavily on user-defined context files to ensure content aligns precisely with brand voice, style guides, SEO requirements, and target keywords.

Maintenance & Community

Originally developed for Castos and built with Claude Code by Anthropic. Contributions and issue reporting are welcomed via GitHub Issues. Maintenance involves regular updates to context files, keyword research, and performance tracking.

Licensing & Compatibility

The repository's README indicates that license information is to be added, meaning the license is currently unspecified. Compatibility is primarily with the Claude Code environment and standard Python setups.

Limitations & Caveats

Adoption is contingent on the user having access to and familiarity with Claude Code. Significant upfront effort is required to configure the detailed context files for optimal performance. Potential costs associated with Anthropic API usage and DataForSEO services may apply. The absence of a specified license is a critical blocker for determining commercial use or distribution rights.