MCP.so
Sign In
X

Xmlriver Mcp

@artgas1

Repository

About Xmlriver Mcp

First MCP server for XMLRiver — Russian-focused SEO API. Provides Google/Yandex SERP parsing, Yandex Wordstat keyword frequency data, and URL indexing checks via XML API. Fills the gap for Russian SEO research and Yandex-aware analysis in Claude / Cursor / Windsurf.

#mcp#seo#yandex#google#wordstat#serp#russian#xmlriver

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "xmlriver": {
      "command": "uvx",
      "args": [
        "xmlriver-mcp"
      ],
      "env": {
        "XMLRIVER_USER": "<your_user_id>",
        "XMLRIVER_KEY": "<your_api_key>"
      }
    }
  }
}

Tools

9

Parse Google SERP for a query — country, language, device, page, date filter, extra blocks (ads, FAQ, knowledge graph, AI Overview)

Parse Yandex SERP — region, language, device, page, date filter, extra blocks

Yandex Search API v2 (official) via XMLRiver — cleaner structured output

Yandex Wordstat keyword frequency, device breakdown, history, similar queries

Check if URL is indexed in Google or Yandex

Current XMLRiver balance in rubles

Current XMLRiver tariff name (Basic / Pro / Mega / Giga)

Tariff expiration date (for prepay tariffs)

Cost per 1000 requests for a given engine (google / yandex / yaxml / wordstat)

Overview

What is Xmlriver Mcp?

An MCP server for XMLRiver that provides Google and Yandex SERP parsing, Yandex Wordstat keyword frequency data, and indexation checks via the XML API. It is designed for Claude, Cursor, and Windsurf, filling a gap for Russian SEO research and Yandex‑aware analysis. Pay‑as‑you‑go pricing (≈25 ₽ per 1k requests on the Basic tariff).

How to use Xmlriver Mcp?

Install and run with uvx xmlriver-mcp. Set the XMLRIVER_USER (numeric ID) and XMLRIVER_KEY (40‑character hex) environment variables in your MCP client configuration (Claude Desktop, Claude Code, or Cursor). All tools are invoked via the MCP protocol and are read‑only.

Key features of Xmlriver Mcp

  • Google SERP parsing with country, language, device, and extra block detection (ads, FAQ, knowledge graph, AI Overview)
  • Yandex SERP parsing with region, language, and device support
  • Yandex Wordstat keyword frequency, history, and similar queries
  • URL indexation check for Google and Yandex
  • Account operations: balance, tariff, cost per 1k requests
  • All tools are read‑only with readOnlyHint: true
  • Retry strategy: 3 attempts with exponential backoff on network errors

Use cases of Xmlriver Mcp

  • SEO position tracking – monitor your own and competitor rankings on Yandex and Google
  • Keyword research – validate demand and seasonality via Yandex Wordstat
  • Featured snippet hunting – see which pages own answer boxes, knowledge graphs, and zero‑position results
  • Indexation monitoring – check new URLs for Google and Yandex indexing after publication
  • Cross‑region comparison – compare search results for the same query across different countries and regions

FAQ from Xmlriver Mcp

What authentication is required?

Register at xmlriver.com, top up your balance (minimum ≈100 ₽), and retrieve your numeric user ID and 40‑character hex key from the dashboard. Set XMLRIVER_USER and XMLRIVER_KEY as environment variables.

What are the runtime requirements?

Python 3.10 or later. No external SDK is needed; the server uses httpx, FastMCP, and a custom XML parser.

Where does the data come from?

All data is fetched from the XMLRiver API, which in turn queries Google and Yandex SERPs and Yandex Wordstat.

What are the known limits?

The XMLRiver API uses HTTP only (not HTTPS). The API key can be rotated from the dashboard if compromised. The MCP server uses stdio transport and logs only to stderr.

How is pricing structured?

Pricing depends on the tariff. For example, the Basic tariff charges 25 ₽ per 1,000 requests for Google, Yandex, and Wordstat; higher tiers (Pro, Mega, Giga) offer lower per‑request costs. Use the get_balance and get_cost tools to monitor spend.

Frequently asked questions

What authentication is required?

Register at xmlriver.com, top up your balance (minimum ≈100 ₽), and retrieve your numeric `user` ID and 40‑character hex `key` from the dashboard. Set `XMLRIVER_USER` and `XMLRIVER_KEY` as environment variables.

What are the runtime requirements?

Python 3.10 or later. No external SDK is needed; the server uses httpx, FastMCP, and a custom XML parser.

Where does the data come from?

All data is fetched from the XMLRiver API, which in turn queries Google and Yandex SERPs and Yandex Wordstat.

What are the known limits?

The XMLRiver API uses HTTP only (not HTTPS). The API key can be rotated from the dashboard if compromised. The MCP server uses stdio transport and logs only to stderr.

How is pricing structured?

Pricing depends on the tariff. For example, the Basic tariff charges 25 ₽ per 1,000 requests for Google, Yandex, and Wordstat; higher tiers (Pro, Mega, Giga) offer lower per‑request costs. Use the `get_balance` and `get_cost` tools to monitor spend.

Comments

Basic information

Category

Data & Analytics

Transports

stdio

Author

artgas1

Submitted by

Artem Gasparyan

More Data & Analytics MCP servers

Rankbits

rankbits

AI visibility analytics across 15+ providers (ChatGPT, Perplexity, Gemini, AI Overviews, and more). The MCP connector lets assistants run scans, compare competitor mentions, and track your brand's visibility in AI answer

TofuBofu AI Visibility

Arnav Neil

TofuBofu runs a free AI visibility scan for any B2B company, right inside your AI assistant. Ask it to scan a domain and it runs the questions real buyers ask across ChatGPT, Claude, Gemini, Perplexity, Google AI Overvie

LeadMarina

LeadMarina

Verified local-business leads: search any niche in any city, query your lead library, and export to Close, GoHighLevel, Google Sheets, or emailed files — every email SMTP-checked, every phone verified with line type and

Sugra API MCP

Sugra Systems, Inc.

Official MCP server for the Sugra API, giving AI agents source-attributed access to 1,500+ endpoints across 36 data domains from 160+ primary sources. Covers markets, economics, company fundamentals, government, news, cl

1

Bright Data MCP

luminati-io

A powerful Model Context Protocol (MCP) server that provides an all-in-one solution for public web access.

2.5K