| name | serp-analysis |
| slug | serp-analysis |
| displayName | SERP Analysis · SERP分析 |
| summary | SERP分析/搜索结果 |
| description | Use when the user asks to "analyze the SERP" or "SERP分析"; maps SERP features, layout, ranking factors, search intent, AI Overviews, and snippet opportunities for a query. Not for keyword demand discovery — use keyword-research. SERP分析/搜索结果 |
| version | 17.0.0 |
| license | Apache-2.0 |
| compatibility | Claude Code and compatible agent-skill hosts |
| homepage | https://github.com/aaron-he-zhu/aaron-marketing-skills |
| when_to_use | Use when analyzing search engine results pages, SERP features, featured snippets, People Also Ask, or understanding ranking patterns for a query. |
| argument-hint | <keyword or query> |
| allowed-tools | WebFetch |
| metadata | {"author":"aaron-he-zhu","version":"17.0.0","discipline":"seo-geo","phase":"research","geo-relevance":"high","hermes":{"tags":["marketing","seo-geo","research"],"category":"seo-geo"},"openclaw":{"emoji":"🔍","homepage":"https://github.com/aaron-he-zhu/aaron-marketing-skills"}} |
SERP Analysis
Maps SERP structure, ranking patterns, and feature opportunities so the user can target a query realistically.
Quick Start
Analyze the SERP for [keyword]
What does it take to rank for [keyword]?
Skill Contract
Expected output: a prioritized SERP brief plus the standard handoff summary for memory/research/.
- Reads: target keyword(s), location/language, device, any SERP screenshots or top-10 URLs, and search context.
- Writes: a user-facing analysis and reusable summary.
- Promotes: durable keyword priorities, competitor facts, and pending strategy decisions to
memory/hot-cache.md, memory/open-loops.md, and memory/research/.
- Done when: the SERP composition and top-result ranking factors are documented from a verified live/provided SERP; dominant intent is named with evidence; and a True Difficulty score (0-100, weighted inputs per the template) plus per-site-stage fit is stated.
- Primary next skill: content-writer when the user is ready to build against the observed SERP.
Handoff Summary
Emit the standard shape from skill-contract.md §Handoff Summary Format.
Data Sources
Optional integrations: ~~SEO tool, ~~search console, ~~AI monitor. Before fetching third-party SERP pages, apply SECURITY.md §Scraping Boundaries. Without tools, ask for target keywords, SERP screenshots or top-10 URLs, and search context. See CONNECTORS.md.
Zero-dependency live SERP (keyless): python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/firecrawl.py" search "<keyword>" --limit 10 pulls a live web SERP — title/URL/description per result; add --scrape for each result's full markdown, --country/--tbs for locale and freshness — through Firecrawl's keyless free tier (~1,000 credits/mo; optional FIRECRAWL_API_KEY raises limits). Label these results Measured from a live SERP. Caveat: this is the organic result list only — feature composition (ads, AI Overviews, packs, PAA) still needs a hand-checked SERP screenshot, so mark feature claims accordingly. See scripts/connectors/README.md.
