geo-difficulty — скилл для Claude Code: сложность ранжирования
Скилл geo-difficulty оценивает, насколько сложно попасть в топ по запросу — учитывает авторитетность страниц конкурентов, присутствие в AI Overview Google и текущую позицию сайта.
MIT 134 установок ★ 750 обновлён 2026-10-21
npx skills add OpenClaudia/openclaudia-skills --skill geo-difficulty -a claude-codeЧто делает geo-difficulty
Скилл анализирует конкурентную среду SERP, используя три параметра: URL Rating страниц-конкурентов (а не домена целиком), процент страниц, которые реально отвечают на запрос, и наличие цитирований в AI Overview. Вердикт строится относительно указанного сайта: если домен уже в топ-3 или процитирован в обзоре, статус WON; если в позициях 4–10 — FOOTHOLD; иначе — NOT RANKING с указанием разрыва.
Работает через публичное API https://www.enception.ai/api/tools/geo-difficulty (без ключа), данные берутся из Ahrefs и SerpAPI. Вызов через скрипт bash scripts/score.sh принимает до 10 запросов за раз. Флаг --client <домен> включает относительную оценку. Без FFmpeg и окружения Python сам скилл работает, но если в проекте есть зависимости от этих утилит, их нужно поставить отдельно.
Какие задачи решает
- Узнать, насколько сложно попасть в топ по конкретному запросу
- Сравнить сложность нескольких ключевых слов в одном запуске
- Проверить, цитируется ли сайт в AI Overview для запроса
- Оценить разрыв между текущей позицией сайта и топом
Примеры запросов агенту
- Оцени сложность ранжирования для
ai form real estateиai slide legal - Запусти
geo-difficultyдля запросаai presentation makerс клиентомexample.com - Проверь, насколько сложно попасть в топ по
keyword difficulty seo— доменmysite.com
Как установить geo-difficulty
1Через Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill geo-difficulty -a claude-code2Вручную: положить файлы
~/.claude/skills/geo-difficulty/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/geo-difficulty/
1Через Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill geo-difficulty -a codex2Вручную: положить файлы
.agents/skills/geo-difficulty/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill geo-difficulty -a cursor2Вручную: положить файлы
.cursor/skills/geo-difficulty/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install OpenClaudia/openclaudia-skills skills/geo-difficulty2Вручную: положить файлы
.github/skills/geo-difficulty/SKILL.md1Через Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill geo-difficulty -a gemini-cli2Командой платформы
gemini skills install https://github.com/OpenClaudia/openclaudia-skills --path skills/geo-difficultyВручную: положить файлы
.devin/skills/geo-difficulty/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill geo-difficulty -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о geo-difficulty
Как установить geo-difficulty в Claude Code?
Выполни npx skills add OpenClaudia/openclaudia-skills --skill geo-difficulty -a claude-code, скилл появится в ~/.claude/skills/geo-difficulty/SKILL.md.
Что делает geo-difficulty?
Оценивает сложность ранжирования по запросу: считает медианную авторитетность страниц конкурентов, долю релевантных результатов и учитывает присутствие в AI Overview. Выдаёт общую сложность и вердикт относительно указанного сайта.
Что означают статусы WON, FOOTHOLD и NOT RANKING?
WON — сайт в топ-3 или процитирован в AI Overview. FOOTHOLD — позиции 4–10. NOT RANKING — сайт вне топа, скилл показывает разрыв, который нужно закрыть с учётом текущего DR домена.
Исходный текст
SKILL.md · MIT
---
name: geo-difficulty
description: "Score how hard a keyword is to rank for in the AI-search era — page-level URL Rating of real competitors (not just domain DR), Ahrefs keyword difficulty, and whether a given site already ranks or is cited in Google's AI Overview. Use when the user asks 'how hard is <keyword> to rank', 'geo difficulty for <keyword>', or 'keyword difficulty for <domain>'."
---
# 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.
© OpenClaudia · MIT · OpenClaudia/openclaudia-skills