Andrew Yim
930167dbbe
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>
78 lines
2.4 KiB
Markdown
78 lines
2.4 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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
|