# SEO Migration Planner

SEO 사이트 이전 계획 및 모니터링 도구 - 사전 위험 평가, 리디렉트 매핑, 이전 후 트래픽/인덱싱 추적.

## Overview

Pre-migration risk assessment, redirect mapping, URL inventory, crawl baseline capture, and post-migration traffic/indexation monitoring for site migrations. Supports domain moves, platform changes, URL restructuring, HTTPS migrations, and subdomain consolidation.

## Dual-Platform Structure

```
33-seo-migration-planner/
├── code/                              # Claude Code version
│   ├── CLAUDE.md                      # Action-oriented directive
│   ├── commands/
│   │   └── seo-migration-planner.md   # Slash command
│   └── scripts/
│       ├── migration_planner.py       # Pre-migration planning
│       ├── migration_monitor.py       # Post-migration monitoring
│       ├── base_client.py             # Shared async utilities
│       └── requirements.txt
│
├── desktop/                           # Claude Desktop version
│   ├── SKILL.md                       # MCP-based workflow
│   ├── skill.yaml                     # Extended metadata
│   └── tools/
│       ├── ahrefs.md                  # Ahrefs MCP tools
│       ├── firecrawl.md               # Firecrawl MCP tools
│       └── notion.md                  # Notion MCP tools
│
└── README.md
```

## Quick Start

### Claude Code
```bash
/seo-migration-planner https://example.com --type domain-move --new-domain https://new-example.com
```

### Python Script
```bash
pip install -r code/scripts/requirements.txt

# Pre-migration planning
python code/scripts/migration_planner.py --domain https://example.com --type domain-move --new-domain https://new-example.com --json

# Post-migration monitoring
python code/scripts/migration_monitor.py --domain https://new-example.com --migration-date 2025-01-15 --baseline baseline.json --json
```

## Features

### Pre-Migration Planning
- URL inventory via Firecrawl crawl
- Ahrefs traffic/keyword/backlink baseline
- Per-URL risk scoring (0-100)
- Redirect map generation (301 mappings)
- Type-specific pre-migration checklist (Korean)

### Post-Migration Monitoring
- Pre vs post traffic comparison
- Redirect health check (broken, chains, loops)
- Indexation change tracking
- Keyword ranking monitoring
- Recovery timeline estimation
- Automated alert generation

## Migration Types

| Type | Description |
|------|-------------|
| `domain-move` | Old domain -> new domain |
| `platform` | CMS/framework migration |
| `url-restructure` | Path/slug changes |
| `https` | HTTP -> HTTPS |
| `subdomain` | Subdomain -> subfolder |

## Notion Output

Reports are saved to the OurDigital SEO Audit Log database:
- **Title**: `사이트 이전 계획 - [domain] - YYYY-MM-DD`
- **Database ID**: `2c8581e5-8a1e-8035-880b-e38cefc2f3ef`
- **Audit ID Format**: MIGR-YYYYMMDD-NNN

## Triggers

- site migration, domain move, redirect mapping
- platform migration, URL restructuring
- HTTPS migration, subdomain consolidation
- 사이트 이전, 도메인 이전, 리디렉트 매핑
