convez.ai
SkillMarketing & VendasIntermediário
muratciftc-hue

SERP Analyzer

muratciftc-hue/serp-analyzer

Análise competitiva de SERPs com detecção de gaps de conteúdo

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill de análise de SERPs alimentado por IA para Claude Code que analisa os 10 primeiros resultados de busca, compara métricas on-page e off-page com integração à API Ahrefs, detecta gaps de conteúdo e gera lista priorizada de ações.

Instalação

$npx convez-ai muratciftc-hue/serp-analyzer

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Análise competitiva de rankings de busca orgânica
  • Detecção de lacunas de conteúdo contra concorrentes
  • Estratégia de SEO baseada em dados de SERP

Veredito

Ferramenta prática para profissionais de SEO/marketing que já usam Claude Code e Ahrefs. A estratégia dual-fetch é inteligente, mas depende de MCP servers externos e requer setup técnico razoável. Útil para quem busca automação de análise competitiva de SERP.

README

A tradução para o português deste README ainda está na fila.

SERP Analyzer — Claude Code Skill

AI-powered SERP analysis skill for Claude Code. Analyzes top 10 search results for a target keyword, compares on-page and off-page metrics, detects content gaps, and generates a prioritized action list.

Installation

Option 1 — Git clone (recommended):

git clone https://github.com/muratciftc-hue/serp-analyzer.git ~/.claude/skills/serp-analyzer

Option 2 — Manual copy:

cp -r serp-analyzer ~/.claude/skills/

Usage

/serp-analyzer <keyword> [your-url] [country:xx]

Examples

# Basic — keyword only (default country: Turkey)
/serp-analyzer 5g

# With your own URL for content gap analysis
/serp-analyzer 5g https://turkcell.com.tr/5g/

# Different country
/serp-analyzer best crm software country:us

# Full — keyword + your URL + country
/serp-analyzer misir turlari https://coraltatil.com/misir-turlari country:tr

How It Fetches Pages (Dual-Fetch)

This skill uses a two-layer fetch strategy because WebFetch strips <script> tags during markdown conversion, making JSON-LD schemas invisible:

LayerMethodWhat It Gets
A — Raw HTMLcurl + python3JSON-LD schema types, meta description, microdata
B — ContentWebFetch (cascade)Word count, headings, links, FAQ text

Layer B Cascade (for JS-rendered or bot-protected sites)

  1. WebFetch — default, fastest
  2. Google Cache — webcache.googleusercontent.com/search?q=cache:[URL]
  3. Ahrefs Cache — crawled content via site-audit-page-content
  4. Chrome MCP — full JS rendering (requires Claude in Chrome extension)

If all methods fail for a URL, it's marked as "N/A" in the table — the analysis continues.

What It Analyzes

Per Competitor (Top 10 SERP results)

MetricSourceDescription
Domain Rating (DR)AhrefsSite authority score 0-100
Word CountDual-fetch Layer BTotal body text word count
H1 CountDual-fetch Layer BNumber of H1 tags
H2 CountDual-fetch Layer BNumber of H2 tags
FAQ Yes/NoBoth layersFAQPage schema (Layer A) + FAQ text (Layer B)
Schema TypeDual-fetch Layer AJSON-LD + microdata types from raw HTML
Internal Link CountDual-fetch Layer BSame-domain links count
Ref DomainsAhrefsTotal referring domains
TrafficAhrefsEstimated monthly organic traffic

Keyword Metrics (Ahrefs)

MetricDescription
Search VolumeMonthly search volume
Keyword DifficultyKD score 0-100
CPCCost per click (USD)
SERP FeaturesAI Overview, PAA, Video, Image Pack, etc.
Parent TopicBroader topic and its volume
Brand VolumeBrand-only search volume
Brand + Term VolumeBrand + keyword search volume

Content Gap Analysis

When you provide your own URL, the skill compares your page against SERP averages:

  • Word count vs SERP average
  • Heading structure (H2 count)
  • FAQ presence (% of competitors with FAQ)
  • Schema markup comparison
  • Internal linking density
  • Backlink profile gap
  • Topical coverage (H2 theme analysis)

Requirements

Required

  • Claude Code CLI or Claude Code Desktop
  • python3 (for raw HTML schema parsing — pre-installed on macOS/Linux)
  • curl (for raw HTML fetching — pre-installed on macOS/Linux)

Recommended

  • Ahrefs MCP server — SERP data, keyword metrics, backlinks, DR
    • Without Ahrefs: off-page columns (DR, traffic, backlinks) show "N/A"
    • On-page analysis still works via WebFetch + curl

Optional (better site coverage)

  • Claude in Chrome extension — JS-rendered and bot-protected sites
    • Without it: sites like Trendyol, Teknosa may show "N/A"

Output Format

The skill outputs a structured report with:

  1. Keyword metrics overview
  2. SERP feature detection (AI Overview, PAA, Video, etc.)
  3. Competitor comparison table (all 10 results)
  4. Content gap analysis (if your URL provided)
  5. Prioritized action list with targets
  6. Thematic coverage analysis (H2-based topic mapping)
  7. Fetch status report (which method worked per URL)

Data Sources

  • Off-page: Ahrefs SERP Overview, Keywords Explorer, Site Explorer APIs
  • On-page: curl raw HTML (schemas, meta tags) + WebFetch (content analysis)
  • Fallback: Google Cache, Ahrefs crawled content, Chrome MCP

Related Skills

License

MIT

Ver o original no GitHub

Bom para

Relacionados