seokit 1.0.1

Claude Code toolkit for creating high-quality SEO articles

SEOKit

Claude Code toolkit for creating high-quality SEO articles.

Installation

PyPI (Recommended)

pip install seokit

After installation, slash commands are auto-installed to ~/.claude/commands/.

Alternative: curl (Linux/Mac only)

curl -fsSL https://raw.githubusercontent.com/nguyennguyenit/seokit/master/install.sh | bash

Features

• Search Intent Analysis - Understand user needs via Perplexity API
• Competitor Research - Analyze top 10 ranking articles
• Outline Creation - Structure content following Google E-E-A-T guidelines
• Outline Optimization - Apply 80/20 content distribution rules
• Article Writing - Generate full articles with DOCX export

Usage

After installation, SEOKit slash commands are available in Claude Code:

/search-intent "your keyword"
# Creates: ./your-keyword/search-intent.md

/top-article "your keyword"
# Creates: ./your-keyword/top-articles.md

Workflow

1. /search-intent "keyword" - Analyze search intent
2. /top-article "keyword" - Find top 10 competitor articles
3. /create-outline - Create structured outline
4. /optimize-outline - Optimize with 80/20 rule
5. /write-seo - Generate full article + DOCX

Output Structure

your-project/
└── keyword-slug/           # Auto-created per keyword
    ├── search-intent.md
    ├── top-articles.md
    ├── outline.md
    ├── outline-optimized.md
    ├── article.md
    └── article.docx

Commands

Command	Description
/search-intent [keyword]	Analyze search intent
/top-article [keyword]	Find top competitor articles
/create-outline	Create article outline
/optimize-outline	Optimize outline structure
/write-seo	Write full article

CLI Commands

seokit --help                   # Show help
seokit install                  # Install slash commands
seokit uninstall                # Remove slash commands
seokit config                   # Configure API key
seokit search-intent <keyword>  # Analyze search intent
seokit top-articles <keyword>   # Find top articles
seokit outline -f <file>        # Analyze outline from a file
seokit write -o <file>          # Generate DOCX from outline file

Environment Variables

Variable	Default	Description
SEOKIT_HOME	~/.claude/seokit	Global installation path
SEOKIT_KEYWORD	(empty)	Output folder name
PERPLEXITY_API_KEY	-	API key (required)

Requirements

• Python 3.10+
• Claude Code CLI
• Perplexity API key (get one here)

Troubleshooting

"PERPLEXITY_API_KEY not configured"

seokit config
# Or manually:
echo "PERPLEXITY_API_KEY=pplx-your-key" >> ~/.seokit/.env

Commands not found

Reinstall slash commands:

seokit install

Update

pip install -U seokit

Uninstall

pip uninstall seokit
seokit uninstall  # Remove slash commands (run before pip uninstall)

Documentation

See docs/ folder for detailed documentation:

• Codebase Summary - Architecture overview
• Project Overview - Product requirements
• Code Standards - Development guidelines

License

Proprietary - see LICENSE for details.