CLAUDE.md

Overview

Competitor intelligence and benchmarking tool for comprehensive SEO competitive analysis. Auto-discovers competitors via our-seo-agent CLI, builds competitor profile cards (DR, traffic, keywords, backlinks, content volume), creates head-to-head comparison matrices, tracks traffic trends, analyzes keyword overlap, compares content freshness/volume, and scores competitive threats. Supports Korean market competitor analysis including Naver Blog/Cafe presence.

Quick Start

pip install -r scripts/requirements.txt

# Competitor profiling
python scripts/competitor_profiler.py --target https://example.com --json

# Competitive monitoring
python scripts/competitive_monitor.py --target https://example.com --period 30 --json

Scripts

Script	Purpose	Key Output
`competitor_profiler.py`	Build competitor profiles and comparison matrix	Competitor cards, head-to-head matrix, threat scores
`competitive_monitor.py`	Track competitive changes over time	Traffic trends, keyword movement, content velocity
`base_client.py`	Shared utilities	RateLimiter, ConfigManager, BaseAsyncClient

Competitor Profiler

# Auto-discover and profile competitors
python scripts/competitor_profiler.py --target https://example.com --json

# Specify competitors manually
python scripts/competitor_profiler.py --target https://example.com --competitor https://comp1.com --competitor https://comp2.com --json

# Limit auto-discovery count
python scripts/competitor_profiler.py --target https://example.com --max-competitors 10 --json

# Include Korean market analysis
python scripts/competitor_profiler.py --target https://example.com --korean-market --json

Capabilities:

Competitor auto-discovery via our-seo-agent CLI or pre-fetched data
Competitor profile cards:
- Domain Rating (DR)
- Organic traffic estimate
- Total organic keywords
- Referring domains count
- Top pages count
- Content volume estimate
Head-to-head comparison matrix across all SEO dimensions
Keyword overlap analysis (shared, unique to target, unique to competitor, gap)
Content volume and freshness comparison
Competitive threat scoring (0-100) based on growth trajectory, keyword overlap, DR gap
Korean market: Naver Blog/Cafe presence detection for competitors

Competitive Monitor

# 30-day competitive monitoring
python scripts/competitive_monitor.py --target https://example.com --period 30 --json

# With specific competitors
python scripts/competitive_monitor.py --target https://example.com --competitor https://comp1.com --period 60 --json

# Traffic trend comparison
python scripts/competitive_monitor.py --target https://example.com --scope traffic --period 90 --json

Capabilities:

Traffic trend comparison (6-12 month history)
DR trend comparison over time
New/lost keyword tracking per competitor
Referring domain growth comparison
Content publication velocity comparison
Top page changes (new top pages, declining pages)
Alert generation for significant competitive movements
Market share estimation based on organic traffic

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

{
  "target": "example.com",
  "competitors": [
    {
      "domain": "competitor1.com",
      "profile": {
        "domain_rating": 55,
        "organic_traffic": 25000,
        "organic_keywords": 3500,
        "referring_domains": 1200,
        "top_pages": 150
      },
      "threat_score": 78,
      "keyword_overlap": {
        "shared": 450,
        "unique_competitor": 800,
        "unique_target": 600,
        "gap": 350
      }
    }
  ],
  "comparison_matrix": {},
  "market_position": "challenger",
  "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	Target website URL
Category	Select	Competitor Intelligence
Priority	Select	Based on threat level
Found Date	Date	Report date (YYYY-MM-DD)
Audit ID	Rich Text	Format: COMP-YYYYMMDD-NNN

Language Guidelines

Report content in Korean (한국어)
Keep technical English terms as-is (e.g., Domain Rating, Organic Traffic, Threat Score)
URLs and code remain unchanged

4.8 KiB Raw Permalink Blame History