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
parent 159f7ec3f7
commit a3ff965b87
125 changed files with 25948 additions and 173 deletions
--- a/custom-skills/24-seo-ecommerce/desktop/SKILL.md
+++ b/custom-skills/24-seo-ecommerce/desktop/SKILL.md
@@ -0,0 +1,156 @@
+---
+name: seo-ecommerce
+description: |
+  E-commerce SEO audit and optimization for product pages, product schema, category taxonomy,
+  and Korean marketplace presence.
+  Triggers: product SEO, e-commerce audit, product schema, category SEO, Smart Store, marketplace SEO,
+  상품 SEO, 이커머스 감사, 쇼핑몰 SEO.
+---
+
+# E-Commerce SEO Audit
+
+## Purpose
+
+Audit e-commerce sites for product page optimization, structured data validation, category taxonomy health, duplicate content issues, and Korean marketplace presence (Naver Smart Store, Coupang, Gmarket, 11번가).
+
+## Core Capabilities
+
+1. **Product Page SEO Audit** - Title, meta description, H1, image alt text, internal links, canonical tags
+2. **Product Schema Validation** - Product, Offer, AggregateRating, Review, BreadcrumbList structured data
+3. **Category Taxonomy Analysis** - Depth check, breadcrumbs, faceted navigation handling
+4. **Duplicate Content Detection** - Parameter variants, product variants, pagination issues
+5. **Korean Marketplace Presence** - Naver Smart Store, Coupang, Gmarket, 11번가
+
+## MCP Tool Usage
+
+### Ahrefs for Product Page Discovery
+```
+mcp__ahrefs__site-explorer-pages-by-traffic: Identify top product and category pages
+mcp__ahrefs__site-explorer-organic-keywords: Product page keyword performance
+```
+
+### WebSearch for Marketplace Checks
+```
+WebSearch: Search for brand presence on Korean marketplaces
+WebFetch: Fetch and analyze marketplace listing pages
+```
+
+### Notion for Report Storage
+```
+mcp__notion__notion-create-pages: Save audit report to SEO Audit Log database
+```
+
+## Workflow
+
+### 1. Product Page Audit
+1. Discover product pages via Ahrefs pages-by-traffic or sitemap
+2. For each product page check:
+   - Title tag: contains product name, under 60 chars
+   - Meta description: includes price/feature info, under 155 chars
+   - Single H1 with product name
+   - All product images have descriptive alt text
+   - Canonical tag present and correct
+   - Sufficient internal links (related products, breadcrumbs)
+   - Open Graph tags for social sharing
+3. Score severity: critical/high/medium/low
+
+### 2. Product Schema Validation
+1. Extract JSON-LD and Microdata from product pages
+2. Validate Product type: name, image, description (required)
+3. Validate Offer: price, priceCurrency, availability (required)
+4. Validate AggregateRating: ratingValue, reviewCount (required)
+5. Validate Review: author, reviewRating (required)
+6. Check BreadcrumbList implementation
+7. Assess Google rich result eligibility
+8. Check Naver Shopping specific requirements (Korean name, KRW price, absolute image URLs)
+
+### 3. Category Taxonomy Analysis
+1. Crawl category pages from sitemap or homepage navigation
+2. Measure taxonomy depth (warn if > 4 levels)
+3. Check breadcrumb presence on every category page
+4. Identify faceted navigation URLs that are indexable without proper canonicals
+5. Count child category links for structure assessment
+
+### 4. Duplicate Content Detection
+1. Group URLs by base path (stripping query parameters)
+2. Identify parameter variants (?color=, ?size=, ?sort=)
+3. Detect product variant URL duplicates (e.g., /product-red vs /product-blue)
+4. Flag paginated pages missing self-referencing canonicals
+
+### 5. Korean Marketplace Presence
+1. Extract brand name from site (og:site_name or title)
+2. Search each marketplace for brand products:
+   - Naver Smart Store (smartstore.naver.com)
+   - Coupang (coupang.com)
+   - Gmarket (gmarket.co.kr)
+   - 11번가 (11st.co.kr)
+3. Check Naver Smart Store-specific SEO elements
+4. Verify naver-site-verification meta tag
+5. Check Korean content ratio for Naver visibility
+
+## Output Format
+
+```markdown
+## E-Commerce SEO Audit: [domain]
+
+### Score: [0-100]/100
+
+### Product Page Issues
+- **Critical**: [count] issues
+- **High**: [count] issues
+- **Medium**: [count] issues
+- **Low**: [count] issues
+
+#### Top Issues
+1. [severity] [issue_type] - [message]
+   Recommendation: [fix]
+
+### Category Structure
+- Categories found: [count]
+- Max depth: [number]
+- Breadcrumbs present: [count]
+- Faceted navigation issues: [count]
+
+### Schema Validation
+- Pages with schema: [count]/[total]
+- Valid schemas: [count]
+- Rich result eligible: [count]
+- Common errors: [list]
+
+### Korean Marketplaces
+- Naver Smart Store: [Found/Not Found]
+- Coupang: [Found/Not Found]
+- Gmarket: [Found/Not Found]
+- 11번가: [Found/Not Found]
+
+### Recommendations
+1. [Priority fixes ordered by impact]
+```
+
+## Common Issues
+
+| Issue | Impact | Fix |
+|-------|--------|-----|
+| Missing Product schema | High | Add JSON-LD Product with offers |
+| No canonical on product variants | High | Add self-referencing canonical |
+| Images without alt text | High | Add product name to alt text |
+| Category depth > 4 levels | Medium | Flatten taxonomy |
+| Missing breadcrumbs | Medium | Add BreadcrumbList schema and visible nav |
+| Faceted nav creating duplicates | High | Use canonical or noindex on filtered pages |
+| Missing Naver verification | Medium | Add naver-site-verification meta tag |
+| Price not in KRW for Korean market | Medium | Add KRW pricing to schema |
+
+## Limitations
+
+- Cannot access logged-in areas (member-only products)
+- Marketplace search results may vary by region/IP
+- Large catalogs require sampling (default 50 pages)
+- Cannot validate JavaScript-rendered product content without headless browser
+
+## Notion Output (Required)
+
+All audit reports MUST be saved to OurDigital SEO Audit Log:
+- **Database ID**: `2c8581e5-8a1e-8035-880b-e38cefc2f3ef`
+- **Properties**: Issue (title), Site (url), Category (E-Commerce SEO), Priority, Found Date, Audit ID
+- **Language**: Korean with English technical terms
+- **Audit ID Format**: ECOM-YYYYMMDD-NNN
--- a/custom-skills/24-seo-ecommerce/desktop/skill.yaml
+++ b/custom-skills/24-seo-ecommerce/desktop/skill.yaml
@@ -0,0 +1,8 @@
+name: seo-ecommerce
+description: |
+  E-commerce SEO audit and optimization. Triggers: product SEO, e-commerce audit, product schema, category SEO, Smart Store, marketplace SEO.
+allowed-tools:
+  - mcp__ahrefs__*
+  - mcp__notion__*
+  - WebSearch
+  - WebFetch
--- a/custom-skills/24-seo-ecommerce/desktop/tools/ahrefs.md
+++ b/custom-skills/24-seo-ecommerce/desktop/tools/ahrefs.md
@@ -0,0 +1,15 @@
+# Ahrefs
+
+> TODO: Document tool usage for this skill
+
+## Available Commands
+
+- [ ] List commands
+
+## Configuration
+
+- [ ] Add configuration details
+
+## Examples
+
+- [ ] Add usage examples
--- a/custom-skills/24-seo-ecommerce/desktop/tools/notion.md
+++ b/custom-skills/24-seo-ecommerce/desktop/tools/notion.md
@@ -0,0 +1,15 @@
+# Notion
+
+> TODO: Document tool usage for this skill
+
+## Available Commands
+
+- [ ] List commands
+
+## Configuration
+
+- [ ] Add configuration details
+
+## Examples
+
+- [ ] Add usage examples
--- a/custom-skills/24-seo-ecommerce/desktop/tools/websearch.md
+++ b/custom-skills/24-seo-ecommerce/desktop/tools/websearch.md
@@ -0,0 +1,15 @@
+# WebSearch
+
+> TODO: Document tool usage for this skill
+
+## Available Commands
+
+- [ ] List commands
+
+## Configuration
+
+- [ ] Add configuration details
+
+## Examples
+
+- [ ] Add usage examples