Getting Started with SEO Machine: Automatically Generating SEO-Optimized Blog Posts with AI

Difficulty: ⭐⭐☆☆☆ (Beginner) | Duration: 10-15 minutes | Takeaway: Master the complete workflow of using AI to automatically generate SEO-optimized blog posts.

Target Audience

This article is intended for technical personnel with 1-3 years of development experience. You don't need to be an SEO expert; you only need:

• Basic familiarity with command-line operations
• An interest in AI writing and SEO optimization
• A desire to learn how to produce blog content in bulk using AI

Core Dependencies and Environment

Before we begin, let's prepare the development environment. You will need to install the following software:

Optional Dependencies (for advanced features):

• Google Analytics 4 (GA4) - Traffic analysis
• Google Search Console (GSC) - Search ranking data
• DataForSEO - Keyword and SERP data
• WordPress - Article publishing

Project Structure

After cloning, you will find a very clear project structure:

seomachine/
├── .claude/                    # Claude Code configuration
│   ├── commands/               # Slash command definitions
│   │   ├── research.md         # Research command
│   │   ├── write.md            # Writing command
│   │   ├── rewrite.md          # Rewriting command
│   │   └── optimize.md         # Optimization command
│   └── agents/                 # Specialized Agents
│       ├── seo-optimizer.md    # SEO Optimization Agent
│       ├── meta-creator.md     # Meta tag creation Agent
│       ├── internal-linker.md  # Internal link building Agent
│       └── keyword-mapper.md   # Keyword mapping Agent
├── data_sources/               # Data sources and Python analysis modules
│   ├── modules/                # Analysis modules
│   │   ├── search_intent_analyzer.py   # Search intent analysis
│   │   ├── keyword_analyzer.py         # Keyword analysis
│   │   ├── content_length_comparator.py # Content length comparison
│   │   ├── readability_scorer.py        # Readability scoring
│   │   └── seo_quality_rater.py        # SEO quality scoring
│   ├── google_analytics.py     # GA4 integration
│   ├── google_search_console.py # GSC integration
│   ├── dataforseo.py           # DataForSEO integration
│   └── wordpress_publisher.py # WordPress publishing
├── context/                    # Brand guidelines and context
│   ├── brand-voice.md         # Brand tone and voice
│   ├── style-guide.md          # Writing style guide
│   ├── seo-guidelines.md      # SEO guidelines
│   ├── features.md             # Product features
│   └── writing-examples.md     # Writing examples
├── research/                   # Research brief output directory
├── drafts/                     # Draft article output directory
├── published/                  # Published articles directory
├── rewrites/                   # Rewritten articles directory
├── topics/                     # Topic Ideas
├── research_*.py              # Collection of analysis scripts
└── README.md                   # Project documentation

Step-by-Step Tutorial

Next, we will complete the entire configuration and writing process step by step.

Step 1: Install Dependencies

First, pull the project locally and install the Python dependencies:

# Clone the repository
git clone https://github.com/your-repo/seo-machine.git
cd seo-machine

# Install Python dependencies
pip install -r data_sources/requirements.txt

brew install python3

Step 2: Configure Context Files

This is the most critical step! Context files determine the style and quality of AI writing. You need to fill out these core files:

2.1 Brand Voice (brand-voice.md)

Define your brand's voice and tone:

# Brand Voice

## Voice Pillars
1. Professional but approachable
2. Educational and informative
3. Trustworthy and authoritative

## Tone Guidelines
- Avoid overly academic jargon; use plain, easy-to-understand language
- Use short sentences and stay concise
- Add a touch of humor where appropriate

## Do's and Don'ts
- ✅ Address the reader as "you"
- ✅ Use specific examples to illustrate points
- ❌ Avoid industry buzzwords
- ❌ Don't sound condescending

2.2 Product Features (features.md)

List the features of your product or service:

# Features

## Core Features
- Feature 1: Automated writing
- Feature 2: SEO optimization
- Feature 3: One-click publishing

## Value Propositions
- Save 80% on content creation time
- Write great articles without professional SEO knowledge

2.3 Writing Examples (writing-examples.md)

This is the most important part! Find 3-5 of your best blog posts and paste them in:

# Writing Examples

## Example 1: [Article Title]
[Full article content...]

## Why this is good
- Clear structure
- Vivid language
- Includes practical cases

Step 3: Launch Claude Code

Now open Claude Code and enter the project directory:

claude-code .

Alternatively, open the project in VS Code, then use Cmd+Shift+P to bring up the command palette and type "Claude Code: Start".

Step 4: Execute Research Command

In the Claude Code dialog box, enter:

/research [your topic]

For example:

/research Python Asynchronous Programming Tutorial

This will:

1. Analyze your topic
2. Research competitors
3. Generate keyword suggestions
4. Create search intent analysis
5. Generate a research brief in the research/ directory

Step 5: Generate the Article

Once the research is complete, start writing the article:

/write Complete Guide to Python Asynchronous Programming

This will:

1. Write a full blog post based on the research brief (2000+ words)
2. Automatically trigger the SEO Optimization Agent
3. Generate meta tags (Title, Description, Keywords)
4. Create internal link suggestions
5. Generate the following in the drafts/ directory:
   • Complete Markdown article
   • SEO optimization report
   • Internal link suggestion report
   • Keyword analysis report

/article [topic]

Step 6: View the Optimization Report

Open the drafts/ directory to see the generated files. An SEO optimization report looks something like this:

# SEO Optimization Report

## Keyword Density
- "Python Asynchronous Programming": 2.5% (✅ Target Met)
- "async await": 1.8% (✅ Target Met)

## Content Length
- Current: 2400 words
- Competitor Average: 2100 words (✅ Exceeded)

## Readability
- Flesch Reading Ease: 72 (Good)
- Grade Level: 8 (Easy to understand)

## SEO Score: 85/100

Step 7: Publish to WordPress (Optional)

If you have a WordPress site, you can publish with one click:

/publish-draft drafts/your-article.md

Requires pre-configuration of the WordPress API:

• Add WordPress URL and API Key in data_sources/config/.env
• Ensure the Yoast SEO plugin is installed

Step 8: Other Common Commands

In addition to the above, SEO Machine has several other useful commands:

# Rewrite existing articles (update content)
/rewrite [topic]

# Final SEO polish
/optimize [file]

# Analyze existing articles or URLs
/analyze-existing [URL]

# Performance review (based on GA4/GSC data)
/performance-review

# Content priority matrix
/priorities

# SERP analysis
/research-serp [keyword]

# Competitor gap analysis
/research-gaps

# Trending topic research
/research-trending

Troubleshooting

Issue 1: Python Dependency Installation Failed

Symptom: Error when running pip install.

Solution:

1. Upgrade pip: pip install --upgrade pip
2. Use a local mirror (if applicable):

   pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn
   

Issue 2: Incomplete Context File Configuration

Symptom: Poor article quality that doesn't meet expectations.

Solution:

1. Add more to writing-examples.md, providing at least 3 good articles.
2. Describe tone and style in brand-voice.md in more detail.
3. Include unique selling points (USPs) of the product in features.md.

Issue 3: Claude Code Command Not Working

Symptom: No response after entering /research.

Solution:

1. Ensure you are typing in the Claude Code dialog (not the terminal).
2. Check the command spelling.
3. Ensure you are using the forward slash: /research.

Issue 4: Article Quality Not Good Enough

Symptom: The AI-written article feels too bland.

Solution:

1. Add more writing examples to the Context files.
2. Use /research first so the AI can be more targeted.
3. Manually modify the prompt or add more requirements during /write.

Issue 5: WordPress Publishing Failed

Symptom: Message indicating unable to connect to WordPress.

Solution:

1. Check the WordPress URL and API Key in .env.
2. Verify that the WordPress REST API is enabled.
3. Check if the Yoast SEO plugin is installed.

Issue 6: Insufficient API Quota

Symptom: Message indicating "API quota exceeded".

Solution:

1. Go to the Anthropic console to check quota usage.
2. Reduce the size of Context files (streamline writing examples).
3. Consider upgrading your API plan.

Core Functionality Analysis

You might be curious how SEO Machine actually works. The core lies in its command system and Agent collaboration.

Command System

┌─────────────────────────────────────────────────────────────┐
│                     Claude Code                              │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  /research    →  Generate research brief                      │
│       ↓                                                         │
│  /write       →  Generate article + Trigger optimization Agent│
│       ↓                                                         │
│  ┌─────────────────────────────────────────────────────┐    │
│  │              Auto-triggered Optimization Agents       │    │
│  │  ┌────────────┐ ┌────────────┐ ┌────────────┐       │    │
│  │  │ SEO        │ │ Meta       │ │ Internal   │       │    │
│  │  │ Optimizer  │ │ Creator    │ │ Linker     │       │    │
│  │  └────────────┘ └────────────┘ └────────────┘       │    │
│  └─────────────────────────────────────────────────────┘    │
│       ↓                                                         │
│  /optimize   →  Final SEO polish                             │
│       ↓                                                         │
│  /publish    →  Publish to WordPress                         │
│                                                              │
└─────────────────────────────────────────────────────────────┘

Python Analysis Pipeline

The project also includes complete Python analysis modules:

Run these scripts directly:

python3 seo_baseline_analysis.py
python3 seo_competitor_analysis.py
python3 research_serp_analysis.py

Opportunity Scoring Algorithm

The project features a built-in opportunity scoring algorithm (opportunity_scorer.py) that evaluates keywords using 8 weighted factors:

Advanced Directions

Once you've mastered the basics, you can explore these advanced features:

1. Custom Agents

Add new Agents in the .claude/agents/ directory following the existing templates. For example, you could create an Agent specifically for writing "Comparison & Review" articles.

2. Add More Data Sources

The project supports integration with:

• Google Analytics 4 - Traffic and engagement data
• Google Search Console - Ranking and impression data
• DataForSEO - SERP positions and keyword metrics

Configure the corresponding API Keys in data_sources/config/.env.

3. SEO Analysis Scripts

The project includes several analysis scripts that can be run independently:

# Quick wins analysis
python3 research_quick_wins.py

# Competitor gap analysis
python3 research_competitor_gaps.py

# SERP analysis
python3 research_serp_analysis.py

# Topic clustering
python3 research_topic_clusters.py

# Trend analysis
python3 research_trending.py

4. Bulk Content Production

Combined with cron or GitHub Actions, you can schedule research commands to run periodically and generate content automatically. For example, automatically analyze competitor gaps every week to generate new content ideas.

5. Landing Page Support

The project also supports creating Landing Pages:

/landing-write [topic]      # Create a Landing Page
/landing-audit [file]       # Audit for conversion rate issues
/landing-research [topic]   # Research positioning
/landing-competitor         # Competitor analysis