# CLAUDE.md

## Overview

Gateway page content generator for local services. Creates SEO-optimized pages from location/service configurations.

## Quick Start

```bash
# Generate pages from config
python scripts/generate_pages.py --config config/services.json --locations config/locations.json
```

## Scripts

| Script | Purpose |
|--------|---------|
| `generate_pages.py` | Generate gateway pages from templates |

## Page Generator

```bash
# Generate all combinations
python scripts/generate_pages.py \
  --config config/services.json \
  --locations config/locations.json \
  --output ./pages

# Single service/location
python scripts/generate_pages.py \
  --service "laser_hair_removal" \
  --location "gangnam" \
  --template templates/gateway-page-medical.md
```

## Configuration Files

### services.json
```json
{
  "services": [
    {
      "id": "laser_hair_removal",
      "korean": "레이저 제모",
      "keywords": ["laser hair removal", "permanent hair removal"]
    }
  ]
}
```

### locations.json
```json
{
  "locations": [
    {
      "id": "gangnam",
      "korean": "강남",
      "full_address": "서울특별시 강남구"
    }
  ]
}
```

## Templates

- `templates/gateway-page-medical.md` - Medical service template
- Supports variables: `{{service}}`, `{{location}}`, `{{brand}}`

## Output

Generates markdown files with:
- SEO-optimized title and meta
- Structured content sections
- Schema markup recommendations
- Internal linking suggestions

## Workflow

1. Get strategy from `29-seo-gateway-architect`
2. Configure services and locations
3. Run generator for content drafts
4. Review and customize output

## Notion Output (Required)

**IMPORTANT**: All audit reports MUST be saved to the OurDigital SEO Audit Log database.

### Database Configuration

| Field | Value |
|-------|-------|
| Database ID | `2c8581e5-8a1e-8035-880b-e38cefc2f3ef` |
| URL | https://www.notion.so/dintelligence/2c8581e58a1e8035880be38cefc2f3ef |

### Required Properties

| Property | Type | Description |
|----------|------|-------------|
| Issue | Title | Report title (Korean + date) |
| Site | URL | Audited website URL |
| Category | Select | Technical SEO, On-page SEO, Performance, Schema/Structured Data, Sitemap, Robots.txt, Content, Local SEO |
| Priority | Select | Critical, High, Medium, Low |
| Found Date | Date | Audit date (YYYY-MM-DD) |
| Audit ID | Rich Text | Format: [TYPE]-YYYYMMDD-NNN |

### Language Guidelines

- Report content in Korean (한국어)
- Keep technical English terms as-is (e.g., SEO Audit, Core Web Vitals, Schema Markup)
- URLs and code remain unchanged

### Example MCP Call

```bash
mcp-cli call notion/API-post-page '{"parent": {"database_id": "2c8581e5-8a1e-8035-880b-e38cefc2f3ef"}, "properties": {...}}'
```

