Files
our-claude-skills/custom-skills/20-seo-serp-analysis/desktop/SKILL.md

4.9 KiB

name, description
name description
seo-serp-analysis SERP analysis for Google and Naver search results. Triggers: SERP analysis, search results, featured snippet, SERP features, Naver SERP, 검색결과 분석, SERP 분석.

SEO SERP Analysis

Purpose

Analyze search engine result page composition for Google and Naver. Detect SERP features (featured snippets, PAA, knowledge panels, local pack, video, ads), map competitor positions, score SERP feature opportunities, and analyze Naver section distribution.

Core Capabilities

  1. Google SERP Feature Detection - Identify featured snippets, PAA, knowledge panels, local pack, video carousel, ads, image pack, site links, shopping
  2. Competitor Position Mapping - Extract domains, positions, content types for top organic results
  3. Opportunity Scoring - Score SERP opportunity (0-100) based on feature landscape and competition
  4. Search Intent Validation - Infer intent (informational, navigational, commercial, transactional, local) from SERP composition
  5. Naver SERP Composition - Detect sections (blog, cafe, knowledge iN, Smart Store, brand zone, books, shortform, influencer), map section priority, analyze brand zone presence

MCP Tool Usage

SEO Data (DataForSEO)

Primary — our-seo-agent CLI:

our serp live "<keyword>" --location 2410 --language ko
our serp competitors <domain> --location 2410
our serp ranked-keywords <domain> --location 2410 --limit 50
our serp domain-overview <domain> --location 2410

Interactive fallback — DataForSEO MCP:

mcp__dfs-mcp__serp_organic_live_advanced
mcp__dfs-mcp__dataforseo_labs_google_serp_competitors
mcp__dfs-mcp__dataforseo_labs_google_ranked_keywords
mcp__dfs-mcp__dataforseo_labs_google_domain_rank_overview

Common Parameters

  • location_code: 2410 (Korea), 2840 (US), 2392 (Japan)
  • language_code: ko, en, ja

Notion for Report Storage

mcp__notion__notion-create-pages: Save analysis report to SEO Audit Log database
mcp__notion__notion-update-page: Update existing report entries

Web Tools for Naver Analysis

WebSearch: Discover Naver search trends
WebFetch: Fetch Naver SERP HTML for section analysis

Workflow

1. Google SERP Analysis

  1. Fetch SERP via our serp live "<keyword>" --location 2410 --language ko --format json
  2. Parse SERP features from response (featured_snippet, people_also_ask, local_pack, etc.)
  3. Map competitor positions from organic_results (domain, URL, title, position)
  4. Classify content type for each result (blog, product, service, news, video)
  5. Calculate opportunity score (0-100) based on feature landscape
  6. Validate search intent from SERP composition
  7. Get competitor domain overview via our serp domain-overview <competitor> --location 2410

2. Naver SERP Analysis

  1. Fetch Naver search page for the target keyword
  2. Detect SERP sections (blog, cafe, knowledge iN, Smart Store, brand zone, news, encyclopedia, books, shortform, influencer)
  3. Map section priority (above-fold order)
  4. Check brand zone presence and extract brand name
  5. Count items per section
  6. Identify dominant content section

3. Report Generation

  1. Compile results into structured JSON
  2. Generate Korean-language report
  3. Save to Notion SEO Audit Log database

Output Format

{
  "keyword": "치과 임플란트",
  "country": "kr",
  "serp_features": {
    "featured_snippet": true,
    "people_also_ask": true,
    "local_pack": true,
    "knowledge_panel": false,
    "video_carousel": false,
    "ads_top": 3,
    "ads_bottom": 2
  },
  "competitors": [
    {
      "position": 1,
      "url": "https://example.com/page",
      "domain": "example.com",
      "title": "...",
      "content_type": "service_page"
    }
  ],
  "opportunity_score": 72,
  "intent_signals": "commercial",
  "timestamp": "2025-01-01T00:00:00"
}

Common SERP Features

Feature Impact Opportunity
Featured Snippet High visibility above organic Optimize content format for snippet capture
People Also Ask Related question visibility Create FAQ content targeting PAA
Local Pack Dominates local intent SERPs Optimize Google Business Profile
Knowledge Panel Reduces organic CTR Focus on brand queries and schema
Video Carousel Visual SERP real estate Create video content for keyword
Shopping Transactional intent signal Product feed optimization

Limitations

  • SERP data may have a delay depending on data source (not real-time)
  • Naver SERP HTML structure changes periodically
  • Brand zone detection depends on HTML class patterns
  • Cannot detect personalized SERP results

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, Priority, Found Date, Audit ID
  • Language: Korean with English technical terms
  • Audit ID Format: SERP-YYYYMMDD-NNN