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

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

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