Files
our-claude-skills/custom-skills/11-seo-comprehensive-audit/code/CLAUDE.md
Andrew Yim 930167dbbe Add 11-seo-comprehensive-audit orchestrator skill
New skill that runs a 6-stage SEO audit pipeline (Technical, On-Page,
Core Web Vitals, Schema, Local SEO, Search Console) and produces a
unified health score (0-100) with weighted categories. Includes Python
orchestrator script, slash command, and Notion integration for Korean
audit reports.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-13 02:37:51 +09:00

2.4 KiB

CLAUDE.md

Overview

Comprehensive SEO audit orchestrator. Runs 6 sub-skill audits (Technical, On-Page, CWV, Schema, Local, GSC), merges results into a unified report with weighted health score (0-100), and pushes to Notion.

Quick Start

# Install dependencies
pip install -r scripts/requirements.txt

# Run full audit
python scripts/seo_audit_orchestrator.py --url https://example.com

# Skip optional stages
python scripts/seo_audit_orchestrator.py --url https://example.com --skip-local --skip-gsc

# JSON output only (no Notion push)
python scripts/seo_audit_orchestrator.py --url https://example.com --json

Scripts

Script Purpose
seo_audit_orchestrator.py Orchestrate all 6 audit stages and compute health score

Pipeline

Stage Audit Script
1 Technical SEO 12-seo-technical-audit/code/scripts/robots_checker.py, sitemap_validator.py
2 On-Page SEO 13-seo-on-page-audit/code/scripts/page_analyzer.py
3 Core Web Vitals 14-seo-core-web-vitals/code/scripts/pagespeed_client.py
4 Schema Validation 16-seo-schema-validator/code/scripts/schema_validator.py
5 Local SEO 18-seo-local-audit/ (prompt-driven)
6 Search Console 15-seo-search-console/code/scripts/gsc_client.py

Health Score Weights

Category Weight
Technical SEO 20%
On-Page SEO 20%
Core Web Vitals 25%
Schema 15%
Local SEO 10%
Search Console 10%

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 종합 SEO 감사 보고서 - [domain] - YYYY-MM-DD
Site URL Audited website URL
Category Select Comprehensive Audit
Priority Select Based on health score
Found Date Date Audit 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., SEO Audit, Core Web Vitals, Schema Markup)
  • URLs and code remain unchanged