our-claude-skills/custom-skills/24-seo-ecommerce/desktop/SKILL.md

name, description

name	description
seo-ecommerce	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

SEO Data

our-seo-agent CLI: Primary product page data source (future); use --input for pre-fetched JSON
WebSearch / WebFetch: Supplementary product page data

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 our-seo-agent CLI, pre-fetched JSON, or sitemap crawl
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

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