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
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
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