# EdGEO

> EdGEO is an open-source MCP server for marketing and seo. Local SEO, GEO and Search Console toolkit: audit pages, crawl, compare AI answers. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Repository:** https://github.com/edgarcia-id/edgeo
- **MCP Registry name:** io.github.edgarcia-id/edgeo
- **Categories:** marketing and SEO
- **Listing updated:** 2026-11-16

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

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

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [ASOScan](https://ai-powered.com/mcp/asoscan): ASOScan is an MCP server for marketing and seo.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Daniels AI Design Studio](https://ai-powered.com/mcp/daniels-ai-design-studio): Daniels AI Design Studio is an MCP server for design and media.

---
Source: https://ai-powered.com/mcp/edgeo
