# Geo Difficulty

> Puntúa la dificultad de rankear una keyword en la era de la búsqueda con IA: URL Rating a nivel de página de competidores reales, KD de Ahrefs y si un sitio ya rankea o es citado en el AI Overview de Google.

Fuente: https://skillsagentes.com/skills/openclaudia/openclaudia-skills/geo-difficulty
Markdown: https://skillsagentes.com/skills/openclaudia/openclaudia-skills/geo-difficulty.md

Repositorio: https://github.com/OpenClaudia/openclaudia-skills
Autor: OpenClaudia
Licencia: MIT
Actualizado: el mes pasado
Coste de contexto: 89 tok instalada, 701 tok al activarse, 1.2k tok con todos los archivos del bundle
Bundle: 2 archivos, 5 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add OpenClaudia/openclaudia-skills --skill geo-difficulty --agent claude-code
# Cursor
npx -y skills add OpenClaudia/openclaudia-skills --skill geo-difficulty --agent cursor
# Codex
npx -y skills add OpenClaudia/openclaudia-skills --skill geo-difficulty --agent codex
# Gemini CLI
npx -y skills add OpenClaudia/openclaudia-skills --skill geo-difficulty --agent gemini
# Windsurf
npx -y skills add OpenClaudia/openclaudia-skills --skill geo-difficulty --agent windsurf
# Cline
npx -y skills add OpenClaudia/openclaudia-skills --skill geo-difficulty --agent cline
```

## Qué hace

- Calcula una puntuación de dificultad 0-100 para una keyword usando UR a nivel de página, KD de Ahrefs y % de targeting del top-10
- Da un veredicto relativo al cliente (WON / FOOTHOLD / NOT RANKING) según si el dominio ya rankea o aparece citado en el AI Overview
- Detecta si un dominio está citado en el AI Overview de Google para esa keyword
- Devuelve la lista de competidores reales con su UR de página

## Cuándo usarla

- El usuario pregunta 'how hard is <keyword> to rank'
- El usuario pide 'geo difficulty for <keyword>'
- El usuario pide 'keyword difficulty for <domain>'

## Qué la activa

- "¿Qué tan difícil es rankear para 'ai form real estate'?"
- "Dame la geo difficulty de 'ai slide legal' para example.com"
- "Calcula la keyword difficulty de estas keywords para mi dominio"

## Antes de instalar

- No requiere API key; usa el endpoint público de enception.ai que combina datos de Ahrefs y SerpAPI.
- Necesita en el PATH: curl, python3
- Variables de entorno: BODY, CLIENT, GEO_DIFFICULTY_URL, KEYWORDS
- makes network requests
- reads environment config

## Archivos

- SKILL.md — 3 KB
- scripts/score.sh — 2 KB

## SKILL.md

Reproducido tal cual desde OpenClaudia/openclaudia-skills bajo MIT. Esta sección es el documento original y está en inglés.

# GEO Difficulty

Score keyword ranking difficulty for the AI-search era. Unlike plain Ahrefs KD or domain DR, this:

- uses **page-level URL Rating (UR)** of the results that actually target the query — so a generic article on a huge domain (e.g. mckinsey.com) stops inflating the score;
- is **client-relative** — the same SERP is a wall for a no-name site but ~won for a site already ranking or cited in Google's AI Overview;
- folds in the **AI Overview** citation as a first-class signal.

**Disclosure:** contributed by Enception AI. Backed by the free public API behind https://www.enception.ai/tools/geo-difficulty (`POST https://www.enception.ai/api/tools/geo-difficulty`, no API key). Server-side data comes from Ahrefs and SerpAPI.

## Usage

```bash
bash scripts/score.sh "ai form real estate" "ai slide legal" --client example.com
```

- Pass one or more keywords (quote each). Up to 10 per call.
- `--client <domain>` is optional; add it to get the client-relative verdict (`WON` / `FOOTHOLD` / `NOT RANKING`).
- `GEO_DIFFICULTY_URL` env var overrides the endpoint (rarely needed).

Or call the API directly:

```bash
curl -s -X POST https://www.enception.ai/api/tools/geo-difficulty \
  -H 'content-type: application/json' \
  -d '{"keywords":["ai presentation maker"],"client":"example.com"}' --max-time 150
```

## Output columns

- **absolute** — difficulty 0–100 for a brand-new site (`0.35·KD + 0.40·median competitor page-UR + 0.25·targeting%`).
- **client_verdict / client_diff** — only with `--client`. WON (top-3 or AI-Overview cited), FOOTHOLD (ranks 4–10), NOT RANKING (with the gap to close, credited for the client's DR).
- **KD** — Ahrefs keyword difficulty; `-` for zero-volume long-tail.
- **UR** — median page-level URL Rating of the real competitors.
- **tgt%** — share of the top-10 that actually target the query.
- **AIO** — `cited` (client in the AI Overview), `Nsrc` (AIO shown, N sources), `none`, or `n/a` (AIO not available for this query).
- **competitors** — the targeting results with their UR.

## Notes

- The AI Overview leg depends on Google actually showing an AIO for the query (intermittent); it degrades gracefully to `none`/`n/a`.
- Numbers shift day to day as SERPs and UR change — treat as a current snapshot, not a fixed grade.
- Each keyword takes a few seconds server-side; keep `--max-time` generous for batches.

## Dónde encaja

- Categoría: [SEO y GEO](https://skillsagentes.com/categorias/seo-geo.md) — Keywords, auditorías on-page, datos estructurados y visibilidad en respuestas de IA.
- Creador: [OpenClaudia](https://skillsagentes.com/creators/openclaudia.md) — 76 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Competitor Traffic Report](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/competitor-traffic-report.md): Genera un informe HTML autocontenible de tráfico competitivo: visitas mensuales (SimilarWeb), tráfico orgánico y Domain Rating (Ahrefs), con gráficos ranked, tendencias y tabla de datos.
- [Brand Dev](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/brand-dev.md): Obtiene datos de marca (nombre, descripción, logos, industria) desde la API de brand.dev y guarda los logos localmente.
- [Gsc Portfolio Audit](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/gsc-portfolio-audit.md): Audita TODAS las propiedades de Google Search Console a la vez: ranking por clics e impresiones con deltas, y diff de keywords por sitio (nuevas, suben, bajan, perdidas, o bien rankeadas sin clics).
- [Wechat Moments](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/wechat-moments.md): Clasifica y resume el feed de WeChat Moments (朋友圈) del usuario para que los eventos reales y la información genuina destaquen sobre la promoción, ponderando según cuánto le escribe el usuario a cada autor.
- [Podcast Edit](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/podcast-edit.md): Edita audio o video de podcast: recorta charla previa/posterior, quita muletillas, corta silencios, mejora el audio y aplica el mismo corte a una versión en video.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)