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.3 KiB

Raw Blame History

CLAUDE.md

Overview

E-commerce SEO audit tool for product page optimization, product schema validation, category taxonomy analysis, and marketplace presence checking. Supports Naver Smart Store optimization and Korean marketplace platforms (Coupang, Gmarket, 11번가).

Quick Start

pip install -r scripts/requirements.txt

# E-commerce SEO audit
python scripts/ecommerce_auditor.py --url https://example.com --json

# Product schema validation
python scripts/product_schema_checker.py --url https://example.com/product --json

Scripts

Script	Purpose	Key Output
`ecommerce_auditor.py`	Full e-commerce SEO audit	Product page issues, category structure, marketplace presence
`product_schema_checker.py`	Validate product structured data	Schema completeness, errors, rich result eligibility
`base_client.py`	Shared utilities	RateLimiter, ConfigManager, BaseAsyncClient

E-Commerce Auditor

# Full audit
python scripts/ecommerce_auditor.py --url https://example.com --json

# Product page audit only
python scripts/ecommerce_auditor.py --url https://example.com --scope products --json

# Category taxonomy analysis
python scripts/ecommerce_auditor.py --url https://example.com --scope categories --json

# Check Korean marketplace presence
python scripts/ecommerce_auditor.py --url https://example.com --korean-marketplaces --json

Capabilities:

Product page SEO audit (titles, meta descriptions, image alt text, H1 structure)
Category taxonomy analysis (depth, breadcrumb implementation, faceted navigation)
Duplicate content detection (parameter URLs, product variants, pagination)
Pagination/infinite scroll SEO validation (rel=prev/next, canonical tags)
Internal linking structure for product discovery
Naver Smart Store optimization checks
Korean marketplace presence (Coupang, Gmarket, 11번가 product listing detection)

Product Schema Checker

# Validate single product page
python scripts/product_schema_checker.py --url https://example.com/product/123 --json

# Batch validate from sitemap
python scripts/product_schema_checker.py --sitemap https://example.com/product-sitemap.xml --sample 50 --json

Capabilities:

Product schema validation (Product, Offer, AggregateRating, Review, BreadcrumbList)
Required property completeness check (name, image, description, offers, price, availability)
Optional property recommendations (brand, sku, gtin, mpn, review, aggregateRating)
Rich result eligibility assessment
Price and availability markup validation
Merchant listing schema support
Korean market: Naver Shopping structured data requirements

Ahrefs MCP Tools Used

Tool	Purpose
`site-explorer-pages-by-traffic`	Identify top product/category pages
`site-explorer-organic-keywords`	Product page keyword performance

Output Format

{
  "url": "https://example.com",
  "product_pages_audited": 50,
  "issues": {
    "critical": [...],
    "high": [...],
    "medium": [...],
    "low": [...]
  },
  "category_structure": {
    "max_depth": 4,
    "breadcrumbs_present": true,
    "faceted_nav_issues": [...]
  },
  "schema_validation": {
    "pages_with_schema": 42,
    "pages_without_schema": 8,
    "common_errors": [...]
  },
  "korean_marketplaces": {
    "naver_smart_store": {"found": true, "url": "..."},
    "coupang": {"found": false},
    "gmarket": {"found": false}
  },
  "score": 65,
  "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	Audited website URL
Category	Select	E-Commerce SEO
Priority	Select	Based on issue severity
Found Date	Date	Audit date (YYYY-MM-DD)
Audit ID	Rich Text	Format: ECOM-YYYYMMDD-NNN

Language Guidelines

Report content in Korean (한국어)
Keep technical English terms as-is (e.g., Schema Markup, Product, Offer)
URLs and code remain unchanged

4.3 KiB Raw Blame History