seomachine: An Open-Source Workflow That Turns Claude Code into a Powerful SEO Content Engine

seomachine: A Claude‑Code‑Specific SEO Content Creation Workflow

seomachine is an open‑source project that has quickly attracted 4.5k stars on GitHub. It aims to solve the challenge of producing high‑quality, SEO‑compliant long‑form content with AI assistance.

This Is Not Just a Prompt Collection

Unlike many AI writing tools that rely on a single prompt, seomachine decomposes SEO content creation into an executable workflow consisting of four main components:

Instructions – Global directives embedded in Claude Code to keep the AI focused on SEO thinking.

Init – Scripts that generate a detailed outline and a technical SEO checklist based on the target topic.

Iterate – Multi‑dimensional polishing of the draft, covering readability, keyword density, and HTML structure.

Tools – Integration with platforms such as Surfer to bring data‑driven SEO analysis into the loop.

Typical Use Cases

The workflow suits creators who need to scale content production while maintaining quality and search ranking. Common scenarios include:

Independent blog owners balancing depth and ranking.

Content marketing teams producing structured industry articles at scale.

Technical documentation writers who require proper HTML structure and internal linking.

How the Workflow Works

The process is divided into three stages, each with clear deliverables and validation criteria.

Initialization (Stage 0‑1)

Given a topic and keywords, Claude Code generates:

A detailed outline with section titles and key points.

A technical SEO checklist covering heading hierarchy, meta description, image alt tags, etc.

Internal linking suggestions and related article references.

This early planning prevents mid‑draft structural issues and reduces rework.

Creation (Stage 1‑2)

During drafting, the instruction set emphasizes often‑overlooked SEO details such as proper H1/H2/H3 nesting, readable paragraph length, and natural keyword distribution.

Iterative Optimization (Stage 2‑3)

After the first draft, a series of checks refine the content:

Readability check – Ensures the text is friendly to general readers.

Depth check – Verifies coverage of core aspects of the topic.

Keyword optimization check – Analyzes reasonable keyword density.

HTML compliance check – Guarantees technical SEO conformity.

Technical Highlights

Key engineering choices include:

Deep integration with Claude Code – The instruction set leverages Claude’s long‑context window for comprehensive content understanding.

Modular check tools – SEO rules are split into independent instruction files, simplifying future updates.

Extensible tool functions – Interfaces for third‑party platforms like Surfer enable advanced keyword difficulty analysis and competitor insights.

Getting Started

After cloning the repository, the setup is straightforward:

git clone https://github.com/TheCraigHewitt/seomachine.git
cd seomachine  # Follow the README to configure Claude Code MCP settings

The core instructions.md file must be added to Claude Code’s global configuration so that each new content project automatically loads the SEO workflow.

Running the initialization command produces a complete outline and SEO checklist, after which the author proceeds with drafting as if a professional SEO editor were reviewing the work in real time.

Project Status and Outlook

Licensed under MIT, seomachine can be freely forked, modified, and used commercially. Community feedback highlights its value as a structured way of thinking about SEO rather than a simple automation tool.

As search engines evolve—especially in detecting AI‑generated content—the workflow‑oriented design offers better long‑term adaptability compared to static prompt solutions.

Conclusion

The real benefit of AI tools lies in offloading repetitive tasks, allowing creators to focus on the creative aspects that require human insight. seomachine’s approach—establish a framework, fill in content, then systematically optimize—can reduce trial‑and‑error costs for frequent SEO content producers.

GitHub: https://github.com/TheCraigHewitt/seomachine

License: MIT