Files

Andrew Yim a3ff965b87 Add SEO skills 19-28, 31-32 with full Python implementations

12 new skills: Keyword Strategy, SERP Analysis, Position Tracking,
Link Building, Content Strategy, E-Commerce SEO, KPI Framework,
International SEO, AI Visibility, Knowledge Graph, Competitor Intel,
and Crawl Budget. ~20K lines of Python across 25 domain scripts.
Updated skill 11 pipeline table and repo CLAUDE.md.
Enhanced skill 18 local SEO workflow from jamie.clinic audit.

Note: Skill 26 hreflang_validator.py pending (content filter block).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-13 12:05:59 +09:00

4.5 KiB

Raw Blame History

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 — see Stage 5 notes below)
6	Search Console	`15-seo-search-console/code/scripts/gsc_client.py`

Stage 5: Local SEO — Key Requirements

Stage 5 is prompt-driven and requires Business Identity extraction as a mandatory first step:

Extract Korean name, English name, address, phone from website JSON-LD schema markup (Organization/Hospital/LocalBusiness)
Check website footer, contact page, and schema sameAs for GBP, Naver Place, and Kakao Map URLs
Use layered search fallback if listing URLs are not found on the website
Follow 18-seo-local-audit/code/CLAUDE.md for the full workflow
Korean market priorities: GBP and Naver Smart Place are both Critical; Kakao Map is High; US-centric directories (Yelp, Yellow Pages) are Low
Important: GBP and Naver Map are JS-rendered. Report unfound listings as "not discoverable via web search" — not "does not exist"

Extended SEO Skills Pipeline

Beyond the 6 core audit stages, additional specialized skills are available for deeper analysis:

Skill	Audit ID	Purpose	Command
19 - Keyword Strategy	KW	Seed expansion, intent classification, keyword gaps	`/seo-keyword-strategy`
20 - SERP Analysis	SERP	Google/Naver SERP features, competitor positions	`/seo-serp-analysis`
21 - Position Tracking	RANK	Rank monitoring, visibility scores, alerts	`/seo-position-tracking`
22 - Link Building	LINK	Backlink audit, toxic links, link gaps	`/seo-link-building`
23 - Content Strategy	CONTENT	Content audit, decay detection, briefs	`/seo-content-strategy`
24 - E-Commerce SEO	ECOM	Product page audit, product schema	`/seo-ecommerce`
25 - SEO KPI Framework	KPI	Unified KPIs, health scores, ROI	`/seo-kpi-framework`
26 - International SEO	INTL	Hreflang validation, content parity	`/seo-international`
27 - AI Visibility	AI	AI search citations, brand radar, SOV	`/seo-ai-visibility`
28 - Knowledge Graph	KG	Entity SEO, Knowledge Panel, PAA	`/seo-knowledge-graph`
31 - Competitor Intel	COMP	Competitor profiling, benchmarking	`/seo-competitor-intel`
32 - Crawl Budget	CRAWL	Log analysis, bot profiling, waste	`/seo-crawl-budget`

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

4.5 KiB Raw Blame History