mcpField
G
geo-difficulty

geo-difficulty

github.com/openclaudiaMarketing & growth722124 installsUpdated 1w ago
Repository

About geo-difficulty

geo-difficulty is a GEO keyword difficulty skill for SEO practitioners, combining URL Rating from relevant competitor pages, keyword difficulty, and AI Overview citations. It can assess ranking prospects relative to a specified site, with results representing a current search snapshot.

Key features

  1. 01Score absolute keyword difficulty
  2. 02Include competitor page URL Ratings
  3. 03Use AI Overview citations as a signal
  4. 04Give site-relative ranking verdicts
  5. 05Show competitor results and metrics

Use cases

  1. 01Compare AI-search difficulty across keywords
  2. 02Assess a site's current search position
  3. 03Identify gaps for keywords not yet ranking

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/openclaudia/openclaudia-skills --skill geo-difficulty

After installing, type/geo-difficultyin Claude Code to confirm it loaded.

Bundled filesscripts/score.sh

Details

From the project README

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 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:

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.

Comments

Markdown supported