our-claude-skills/custom-skills/23-seo-content-strategy/code/CLAUDE.md

CLAUDE.md

Overview

Content strategy tool for SEO-driven content planning. Performs content inventory via sitemap crawl and our-seo-agent CLI, scores content performance, detects content decay, analyzes topic gaps vs competitors, maps topic clusters, and generates content briefs. Supports Korean content patterns (Naver Blog format, review/후기 content).

Quick Start

pip install -r scripts/requirements.txt

# Content audit
python scripts/content_auditor.py --url https://example.com --json

# Content gap analysis
python scripts/content_gap_analyzer.py --target https://example.com --competitor https://competitor.com --json

# Generate content brief
python scripts/content_brief_generator.py --keyword "치과 임플란트 비용" --url https://example.com --json

Scripts

Script	Purpose	Key Output
content_auditor.py	Content inventory, performance scoring, decay detection	Content inventory with scores and decay flags
content_gap_analyzer.py	Topic gap analysis and cluster mapping vs competitors	Missing topics, cluster map, editorial calendar
content_brief_generator.py	Generate SEO content briefs with outlines	Brief with outline, keywords, word count targets
base_client.py	Shared utilities	RateLimiter, ConfigManager, BaseAsyncClient

Content Auditor

# Full content audit
python scripts/content_auditor.py --url https://example.com --json

# Detect decaying content
python scripts/content_auditor.py --url https://example.com --decay --json

# Filter by content type
python scripts/content_auditor.py --url https://example.com --type blog --json

Capabilities:

• Content inventory via sitemap crawl + our-seo-agent CLI or pre-fetched data
• Performance scoring (traffic, rankings, backlinks)
• Content decay detection (pages losing traffic over time)
• Content type classification (blog, product, service, landing, resource)
• Word count and freshness assessment
• Korean content format analysis (Naver Blog style, 후기/review content)

Content Gap Analyzer

# Gap analysis vs competitor
python scripts/content_gap_analyzer.py --target https://example.com --competitor https://comp1.com --json

# With topic cluster mapping
python scripts/content_gap_analyzer.py --target https://example.com --competitor https://comp1.com --clusters --json

Capabilities:

• Topic gap identification vs competitors
• Topic cluster mapping (pillar + cluster pages)
• Content freshness comparison
• Content volume comparison
• Editorial calendar generation with priority scoring
• Korean content opportunity detection

Content Brief Generator

# Generate brief for keyword
python scripts/content_brief_generator.py --keyword "치과 임플란트 비용" --url https://example.com --json

# With competitor analysis
python scripts/content_brief_generator.py --keyword "dental implant cost" --url https://example.com --competitors 5 --json

Capabilities:

• Content outline generation with H2/H3 structure
• Target keyword list (primary + secondary + LSI)
• Word count recommendation based on top-ranking pages
• Competitor content analysis (structure, word count, topics covered)
• Internal linking suggestions
• Korean content format recommendations

Data Sources

Source	Purpose
our-seo-agent CLI	Primary data source (future); use --input for pre-fetched JSON
WebSearch / WebFetch	Supplementary live data
Notion MCP	Save audit report to database

Output Format

{
  "url": "https://example.com",
  "content_inventory": {
    "total_pages": 150,
    "by_type": {"blog": 80, "product": 40, "service": 20, "other": 10},
    "avg_performance_score": 45
  },
  "decaying_content": [...],
  "top_performers": [...],
  "gaps": [...],
  "clusters": [...],
  "timestamp": "2025-01-01T00:00:00"
}

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	Content Strategy
Priority	Select	Based on gap severity
Found Date	Date	Audit date (YYYY-MM-DD)
Audit ID	Rich Text	Format: CONTENT-YYYYMMDD-NNN

Language Guidelines

• Report content in Korean (한국어)
• Keep technical English terms as-is
• URLs and code remain unchanged