# CLAUDE.md

## Overview

SEO gateway page strategist for Korean medical/service websites. Creates keyword strategies, content architecture, and technical SEO plans.

## Quick Start

```bash
pip install -r scripts/requirements.txt

# Keyword analysis
python scripts/keyword_analyzer.py --topic "눈 성형" --market "강남"
```

## Scripts

| Script | Purpose |
|--------|---------|
| `keyword_analyzer.py` | Analyze keywords, search volume, competitor gaps |

## Keyword Analyzer

```bash
# Basic analysis
python scripts/keyword_analyzer.py --topic "눈 성형"

# With location targeting
python scripts/keyword_analyzer.py --topic "눈 성형" --market "강남" --output strategy.json

# Competitor analysis
python scripts/keyword_analyzer.py --topic "눈 성형" --competitors url1,url2
```

## Output

Generates strategic document with:
- Primary keyword + monthly search volume
- LSI keywords (7-10)
- User intent distribution
- Competitor gap analysis
- Content architecture (H1-H3 structure)
- Technical SEO checklist

## Templates

See `templates/` for:
- `keyword-research-template.md`
- `content-architecture-template.md`
- `seo-checklist-template.md`

## Workflow

1. Run keyword analyzer for target topic
2. Review search volume and intent data
3. Use output to plan content architecture
4. Hand off to `18-seo-gateway-builder` for content generation

## Configuration

```bash
# Optional: API keys for enhanced data
GOOGLE_API_KEY=xxx
NAVER_API_KEY=xxx
```