Skip to content
MCP server

EdGEO

Local SEO, GEO and Search Console toolkit: audit pages, crawl, compare AI answers

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.1.4
Listing updated
1 day ago

About EdGEO

EdGEO is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

EdGEO runs entirely on your machine with no account, hosted service, telemetry or subscription. Its tools inspect public pages, crawl a bounded part of a site, analyze AI answers for brand mentions and domain citations, and read your own Google Search Console data with a read-only OAuth scope.

Page audits cover HTTP status and redirects, canonical and robots directives, headings, hreflang, Open Graph and parseable JSON-LD. A crawl makes at most 50 same-host fetch attempts, honours robots.txt and crawl delay, and does not claim sitewide coverage. For AI answers it can query an Ollama server on loopback or the Gemini API, the latter only after explicit consent per call. Every observation records provider, model, locale and timestamp.

Its position is cautious: an API answer is not what a person sees in ChatGPT or Google AI Overviews, and it does not promise rankings. Search Console CSVs can be imported locally, including Indonesian headers. Node.js 20.18.1 or later is required.

Install

Run in a terminal

claude mcp add edgeo --env GEMINI_API_KEY='<GEMINI_API_KEY>' -- npx -y edgeo-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "edgeo": {
      "command": "npx",
      "args": [
        "-y",
        "edgeo-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "edgeo": {
      "command": "npx",
      "args": [
        "-y",
        "edgeo-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "edgeo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "edgeo-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "edgeo": {
      "command": "npx",
      "args": [
        "-y",
        "edgeo-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "edgeo": {
      "command": "npx",
      "args": [
        "-y",
        "edgeo-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Configuration

  • GEMINI_API_KEYOptional Google Gemini API key. Used only when the user explicitly consents to sending a prompt to Gemini.

What it does

Page audits
Checks status, canonical, robots, headings, hreflang and JSON-LD.
Bounded crawl
Up to 50 same-host fetches honouring robots.txt.
AI answer analysis
Counts brand mentions and domain citations.
Search Console access
Read-only queries on your own properties.
CSV import
Parses exported Search Console data locally.
Local-first
No accounts, telemetry or hosted service.

Good for

  • Audit a landing page's technical SEO
  • Check whether an AI answer cites your domain
  • Pull Search Console queries for a date range
  • Compare AI answers under matching conditions

Pricing

Open source

Free, open source

EdGEO FAQ

Does it need an account?

No EdGEO account or hosted service is required.

Is it free?

Yes, it is a free open-source toolkit; Search Console API use is subject to Google's quotas.

Does it send prompts to Gemini by default?

No, only with explicit consent and a GEMINI_API_KEY.

Does it promise rankings?

No; it reports sources and conditions and promises no rankings.

Is EdGEO free?

Yes. EdGEO is open source, so you can use and self-host it for free.

How do I add EdGEO to Claude Code?

Run this command in your terminal: claude mcp add edgeo --env GEMINI_API_KEY='<GEMINI_API_KEY>' -- npx -y edgeo-mcp

What are the best alternatives to EdGEO?

The closest alternatives to EdGEO are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, Red Center Studio free tools and ASOScan.

Alternatives to EdGEO

  1. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  2. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  3. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO
  4. Free website checks for AI readiness, DNS dependencies, domain health and Bubble errors

    • 5 tools
    • Remote
    • Free
    • Marketing and SEO
  5. ASOScan

    MCP server

    ASO data for your own iOS and Android apps: rankings, keywords, reviews, scores

    • Remote
    • Free trial
    • Marketing and SEO
  6. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO