geoseo-mcp: SEO and GEO with Yandex submission via IndexNow

geoseo-mcp

A 36-tool MCP server: Google Search Console, Bing Webmaster, IndexNow submission to Yandex, LLM citation checks, page audits and llms.txt, all local

MCP serverRussian stack

rachit8484/geoseo-mcpAuthor:Rachit8484

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/geoseo-mcp

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Assembled automatically, review before installing.

Run in a terminal

claude mcp add --transport stdio geoseo -- uvx geoseo-mcp

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "geoseo": {
      "command": "uvx",
      "args": [
        "geoseo-mcp"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

GEOSEO_GOOGLE_CLIENT_SECRETsecret, optional: Google Search Console client secret JSON file path
GEOSEO_BING_WEBMASTER_API_KEYsecret, optional: Bing Webmaster API key
GEOSEO_INDEXNOW_KEYsecret, optional: IndexNow key for URL submission
GEOSEO_PERPLEXITY_API_KEYsecret, optional: Perplexity API key
GEOSEO_OPENAI_API_KEYsecret, optional: OpenAI API key
GEOSEO_ANTHROPIC_API_KEYsecret, optional: Anthropic API key
GEOSEO_GEMINI_API_KEYsecret, optional: Gemini API key
GEOSEO_SERPAPI_API_KEYsecret, optional: SerpAPI API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in Cursor

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "geoseo": {
      "command": "uvx",
      "args": [
        "geoseo-mcp"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

GEOSEO_GOOGLE_CLIENT_SECRETsecret, optional: Google Search Console client secret JSON file path
GEOSEO_BING_WEBMASTER_API_KEYsecret, optional: Bing Webmaster API key
GEOSEO_INDEXNOW_KEYsecret, optional: IndexNow key for URL submission
GEOSEO_PERPLEXITY_API_KEYsecret, optional: Perplexity API key
GEOSEO_OPENAI_API_KEYsecret, optional: OpenAI API key
GEOSEO_ANTHROPIC_API_KEYsecret, optional: Anthropic API key
GEOSEO_GEMINI_API_KEYsecret, optional: Gemini API key
GEOSEO_SERPAPI_API_KEYsecret, optional: SerpAPI API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in VS Code

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Run in a terminal

code --add-mcp '{"name":"geoseo","type":"stdio","command":"uvx","args":["geoseo-mcp"]}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "geoseo": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "geoseo-mcp"
      ]
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

GEOSEO_GOOGLE_CLIENT_SECRETsecret, optional: Google Search Console client secret JSON file path
GEOSEO_BING_WEBMASTER_API_KEYsecret, optional: Bing Webmaster API key
GEOSEO_INDEXNOW_KEYsecret, optional: IndexNow key for URL submission
GEOSEO_PERPLEXITY_API_KEYsecret, optional: Perplexity API key
GEOSEO_OPENAI_API_KEYsecret, optional: OpenAI API key
GEOSEO_ANTHROPIC_API_KEYsecret, optional: Anthropic API key
GEOSEO_GEMINI_API_KEYsecret, optional: Gemini API key
GEOSEO_SERPAPI_API_KEYsecret, optional: SerpAPI API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add geoseo -- uvx geoseo-mcp

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.geoseo]
command = "uvx"
args = ["geoseo-mcp"]

If the file already exists, append the block to the end.

Keys and settings

GEOSEO_GOOGLE_CLIENT_SECRETsecret, optional: Google Search Console client secret JSON file path
GEOSEO_BING_WEBMASTER_API_KEYsecret, optional: Bing Webmaster API key
GEOSEO_INDEXNOW_KEYsecret, optional: IndexNow key for URL submission
GEOSEO_PERPLEXITY_API_KEYsecret, optional: Perplexity API key
GEOSEO_OPENAI_API_KEYsecret, optional: OpenAI API key
GEOSEO_ANTHROPIC_API_KEYsecret, optional: Anthropic API key
GEOSEO_GEMINI_API_KEYsecret, optional: Gemini API key
GEOSEO_SERPAPI_API_KEYsecret, optional: SerpAPI API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

gemini mcp add -s user geoseo uvx geoseo-mcp

Or add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "geoseo": {
      "command": "uvx",
      "args": [
        "geoseo-mcp"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

GEOSEO_GOOGLE_CLIENT_SECRETsecret, optional: Google Search Console client secret JSON file path
GEOSEO_BING_WEBMASTER_API_KEYsecret, optional: Bing Webmaster API key
GEOSEO_INDEXNOW_KEYsecret, optional: IndexNow key for URL submission
GEOSEO_PERPLEXITY_API_KEYsecret, optional: Perplexity API key
GEOSEO_OPENAI_API_KEYsecret, optional: OpenAI API key
GEOSEO_ANTHROPIC_API_KEYsecret, optional: Anthropic API key
GEOSEO_GEMINI_API_KEYsecret, optional: Gemini API key
GEOSEO_SERPAPI_API_KEYsecret, optional: SerpAPI API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "geoseo": {
      "command": "uvx",
      "args": [
        "geoseo-mcp"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

GEOSEO_GOOGLE_CLIENT_SECRETsecret, optional: Google Search Console client secret JSON file path
GEOSEO_BING_WEBMASTER_API_KEYsecret, optional: Bing Webmaster API key
GEOSEO_INDEXNOW_KEYsecret, optional: IndexNow key for URL submission
GEOSEO_PERPLEXITY_API_KEYsecret, optional: Perplexity API key
GEOSEO_OPENAI_API_KEYsecret, optional: OpenAI API key
GEOSEO_ANTHROPIC_API_KEYsecret, optional: Anthropic API key
GEOSEO_GEMINI_API_KEYsecret, optional: Gemini API key
GEOSEO_SERPAPI_API_KEYsecret, optional: SerpAPI API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "geoseo": {
      "command": "uvx",
      "args": [
        "geoseo-mcp"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

GEOSEO_GOOGLE_CLIENT_SECRETsecret, optional: Google Search Console client secret JSON file path
GEOSEO_BING_WEBMASTER_API_KEYsecret, optional: Bing Webmaster API key
GEOSEO_INDEXNOW_KEYsecret, optional: IndexNow key for URL submission
GEOSEO_PERPLEXITY_API_KEYsecret, optional: Perplexity API key
GEOSEO_OPENAI_API_KEYsecret, optional: OpenAI API key
GEOSEO_ANTHROPIC_API_KEYsecret, optional: Anthropic API key
GEOSEO_GEMINI_API_KEYsecret, optional: Gemini API key
GEOSEO_SERPAPI_API_KEYsecret, optional: SerpAPI API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "geoseo": {
      "command": "uvx",
      "args": [
        "geoseo-mcp"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

GEOSEO_GOOGLE_CLIENT_SECRETsecret, optional: Google Search Console client secret JSON file path
GEOSEO_BING_WEBMASTER_API_KEYsecret, optional: Bing Webmaster API key
GEOSEO_INDEXNOW_KEYsecret, optional: IndexNow key for URL submission
GEOSEO_PERPLEXITY_API_KEYsecret, optional: Perplexity API key
GEOSEO_OPENAI_API_KEYsecret, optional: OpenAI API key
GEOSEO_ANTHROPIC_API_KEYsecret, optional: Anthropic API key
GEOSEO_GEMINI_API_KEYsecret, optional: Gemini API key
GEOSEO_SERPAPI_API_KEYsecret, optional: SerpAPI API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "geoseo": {
      "type": "local",
      "command": [
        "uvx",
        "geoseo-mcp"
      ]
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

GEOSEO_GOOGLE_CLIENT_SECRETsecret, optional: Google Search Console client secret JSON file path
GEOSEO_BING_WEBMASTER_API_KEYsecret, optional: Bing Webmaster API key
GEOSEO_INDEXNOW_KEYsecret, optional: IndexNow key for URL submission
GEOSEO_PERPLEXITY_API_KEYsecret, optional: Perplexity API key
GEOSEO_OPENAI_API_KEYsecret, optional: OpenAI API key
GEOSEO_ANTHROPIC_API_KEYsecret, optional: Anthropic API key
GEOSEO_GEMINI_API_KEYsecret, optional: Gemini API key
GEOSEO_SERPAPI_API_KEYsecret, optional: SerpAPI API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "geoseo": {
      "command": "uvx",
      "args": [
        "geoseo-mcp"
      ]
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

GEOSEO_GOOGLE_CLIENT_SECRETsecret, optional: Google Search Console client secret JSON file path
GEOSEO_BING_WEBMASTER_API_KEYsecret, optional: Bing Webmaster API key
GEOSEO_INDEXNOW_KEYsecret, optional: IndexNow key for URL submission
GEOSEO_PERPLEXITY_API_KEYsecret, optional: Perplexity API key
GEOSEO_OPENAI_API_KEYsecret, optional: OpenAI API key
GEOSEO_ANTHROPIC_API_KEYsecret, optional: Anthropic API key
GEOSEO_GEMINI_API_KEYsecret, optional: Gemini API key
GEOSEO_SERPAPI_API_KEYsecret, optional: SerpAPI API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "geoseo": {
      "command": "uvx",
      "args": [
        "geoseo-mcp"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

GEOSEO_GOOGLE_CLIENT_SECRETsecret, optional: Google Search Console client secret JSON file path
GEOSEO_BING_WEBMASTER_API_KEYsecret, optional: Bing Webmaster API key
GEOSEO_INDEXNOW_KEYsecret, optional: IndexNow key for URL submission
GEOSEO_PERPLEXITY_API_KEYsecret, optional: Perplexity API key
GEOSEO_OPENAI_API_KEYsecret, optional: OpenAI API key
GEOSEO_ANTHROPIC_API_KEYsecret, optional: Anthropic API key
GEOSEO_GEMINI_API_KEYsecret, optional: Gemini API key
GEOSEO_SERPAPI_API_KEYsecret, optional: SerpAPI API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: uv

Checked against the repository on Sep 26, 2026, commit 2e22f0c.

Text for your agent

Install the server with uvx geoseo-mcp or pip install geoseo-mcp, add it to your MCP client config as shown in examples/claude-desktop.json, set an IndexNow key and its verification file on your domain, and add the other services' API keys per the instructions in docs/setup-gsc.md.

Other ways from the author

uvx geoseo-mcp

The recommended way to run it without a system install.

This is third-party code. Review the repository files before installing.

What it does

The server unifies classic SEO and optimization for AI answers in one MCP: Google Search Console data and indexing, Bing Webmaster stats and URL submission, the IndexNow protocol for quickly pushing pages to Bing, Yandex, Naver and Seznam at once, AI Overviews citation checks via SerpAPI, mention checks in Perplexity, ChatGPT, Claude and Gemini individually or all at once through a multi_llm tool, page or whole-folder HTML audits scored 0-100 on titles, meta tags, structure and schema, an internal link graph that finds orphans and dead ends, llms.txt generation and validation, and local trend tracking via SQLite. Several tools work with zero credentials: page audit, folder audit, the link graph and llms.txt generation. Yandex support specifically means URL submission via IndexNow, not a separate Yandex Webmaster API integration.

Who it is for. For SEO specialists who want to quickly submit new pages to several search engines at once, including Yandex, while also tracking citations in AI answers.

Good fit when

You want to quickly submit new or updated pages to Bing, Yandex, Naver and Seznam in one IndexNow request
You want page and internal-link-graph audits with zero credentials to try the tool first
You want to check whether your site gets cited across several LLMs at once

Not a fit when

You need full Yandex Webmaster API access: only IndexNow submission is available for Yandex here
You need a stable production tool: the project is at alpha status (v0.3)

Example request

Submit these five updated pages to Yandex, Bing and Naver via IndexNow

Limitations

The project is alpha status, version 0.3, with parts of the roadmap not yet implemented. Google Search Console needs a Google service account, Bing Webmaster and IndexNow need their own keys, and LLM citation checks need each provider's own keys. Yandex support is limited to submission through the shared IndexNow protocol, not a full Yandex Webmaster API integration.

How to disable. Remove the server from your MCP client config, or stop running the uvx geoseo-mcp command.

MCP

Transport: stdio
Authentication: API key

Security check

Submits URLs to search engines via IndexNow and the Indexing API, requiring a verification key on the domain
Some LLM provider keys and the Google service account are stored locally for external API access

README in short

The README calls the project the only open MCP unifying classic SEO and GEO across Google, Bing, Yandex and major LLMs in one server, and compares it against narrower alternatives. It lists 36 tools by surface: Google Search, Bing Webmaster, IndexNow for Bing/Yandex/Naver/Seznam, AI Overviews, LLM citations, on-page audits, an internal link graph, llms.txt and local SQLite trend tracking. It states alpha v0.3 status, installation via uvx or pip, and example tool calls that need zero credentials.

FAQ

Do I need a key to try the server?

No, page audit, folder audit, the internal link graph and llms.txt generation all work with zero credentials.

How exactly does it work with Yandex?

Through the IndexNow protocol: one URL submission goes to Bing, Yandex, Naver and Seznam at once, with no separate Yandex Webmaster API.

DataLens Skills

Official

Official DataLens (Yandex) skills for Claude Code, Codex and OpenCode: SDK, HTML reports and RLS resolution

SkillMedium riskRussian stackNo VPN needed12

Yandex Metrika MCP Server

Editors’ pick

A Yandex Metrika MCP server generated from the API spec: 108 methods, 10 tools declared by default, transparent filters and response metadata

MCP serverMedium riskRussian stackNo VPN needed2

OpenSEO

Official

An open MCP server and agent skill set for SEO: keyword research, competitors, backlinks and site audits powered by DataForSEO

MCP serverMedium risk21.5K

Claude SEO

A Claude Code plugin for SEO audits: technical SEO, E-E-A-T, schema, local and AI search via parallel subagents

PluginHigh risk17.9K

Install

What it does

Good fit when

Not a fit when

Example request

Limitations

MCP

Security check

README in short

FAQ

Related

DataLens Skills

Yandex Metrika MCP Server

OpenSEO

Claude SEO