SEO Tools MCP

Name: SEO Tools MCP
Author: antohins

antohins

Read-only SEO tools for Google and Yandex: XMLStock SERP, Yandex Wordstat, Google Search Console, Yandex.Webmaster and Metrica.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add seo-tools --env APARSER_PASSWORD='<APARSER_PASSWORD>' --env GOOGLE_CLIENT_SECRET='<GOOGLE_CLIENT_SECRET>' --env GA4_REFRESH_TOKEN='<GA4_REFRESH_TOKEN>' --env GSC_REFRESH_TOKEN='<GSC_REFRESH_TOKEN>' --env YANDEX_OAUTH_TOKEN='<YANDEX_OAUTH_TOKEN>' --env METRIKA_OAUTH_TOKEN='<METRIKA_OAUTH_TOKEN>' --env YANDEX_CLIENT_SECRET='<YANDEX_CLIENT_SECRET>' --env WORDSTAT_API_KEY='<WORDSTAT_API_KEY>' --env XMLRIVER_KEY='<XMLRIVER_KEY>' --env XMLSTOCK_KEY='<XMLSTOCK_KEY>' -- npx -y seo-tools-mcp-aparser

~/.codex/config.toml

[mcp_servers.seo-tools]
command = "npx"
args = ["-y", "seo-tools-mcp-aparser"]
env = { APARSER_PASSWORD = "<APARSER_PASSWORD>", GOOGLE_CLIENT_SECRET = "<GOOGLE_CLIENT_SECRET>", GA4_REFRESH_TOKEN = "<GA4_REFRESH_TOKEN>", GSC_REFRESH_TOKEN = "<GSC_REFRESH_TOKEN>", YANDEX_OAUTH_TOKEN = "<YANDEX_OAUTH_TOKEN>", METRIKA_OAUTH_TOKEN = "<METRIKA_OAUTH_TOKEN>", YANDEX_CLIENT_SECRET = "<YANDEX_CLIENT_SECRET>", WORDSTAT_API_KEY = "<WORDSTAT_API_KEY>", XMLRIVER_KEY = "<XMLRIVER_KEY>", XMLSTOCK_KEY = "<XMLSTOCK_KEY>" }

# codex mcp add seo-tools --env APARSER_PASSWORD='<APARSER_PASSWORD>' --env GOOGLE_CLIENT_SECRET='<GOOGLE_CLIENT_SECRET>' --env GA4_REFRESH_TOKEN='<GA4_REFRESH_TOKEN>' --env GSC_REFRESH_TOKEN='<GSC_REFRESH_TOKEN>' --env YANDEX_OAUTH_TOKEN='<YANDEX_OAUTH_TOKEN>' --env METRIKA_OAUTH_TOKEN='<METRIKA_OAUTH_TOKEN>' --env YANDEX_CLIENT_SECRET='<YANDEX_CLIENT_SECRET>' --env WORDSTAT_API_KEY='<WORDSTAT_API_KEY>' --env XMLRIVER_KEY='<XMLRIVER_KEY>' --env XMLSTOCK_KEY='<XMLSTOCK_KEY>' -- npx -y seo-tools-mcp-aparser

~/.cursor/mcp.json

{
  "mcpServers": {
    "seo-tools": {
      "command": "npx",
      "args": [
        "-y",
        "seo-tools-mcp-aparser"
      ],
      "env": {
        "APARSER_PASSWORD": "<APARSER_PASSWORD>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "GA4_REFRESH_TOKEN": "<GA4_REFRESH_TOKEN>",
        "GSC_REFRESH_TOKEN": "<GSC_REFRESH_TOKEN>",
        "YANDEX_OAUTH_TOKEN": "<YANDEX_OAUTH_TOKEN>",
        "METRIKA_OAUTH_TOKEN": "<METRIKA_OAUTH_TOKEN>",
        "YANDEX_CLIENT_SECRET": "<YANDEX_CLIENT_SECRET>",
        "WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
        "XMLRIVER_KEY": "<XMLRIVER_KEY>",
        "XMLSTOCK_KEY": "<XMLSTOCK_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "seo-tools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "seo-tools-mcp-aparser"
      ],
      "env": {
        "APARSER_PASSWORD": "<APARSER_PASSWORD>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "GA4_REFRESH_TOKEN": "<GA4_REFRESH_TOKEN>",
        "GSC_REFRESH_TOKEN": "<GSC_REFRESH_TOKEN>",
        "YANDEX_OAUTH_TOKEN": "<YANDEX_OAUTH_TOKEN>",
        "METRIKA_OAUTH_TOKEN": "<METRIKA_OAUTH_TOKEN>",
        "YANDEX_CLIENT_SECRET": "<YANDEX_CLIENT_SECRET>",
        "WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
        "XMLRIVER_KEY": "<XMLRIVER_KEY>",
        "XMLSTOCK_KEY": "<XMLSTOCK_KEY>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "seo-tools": {
      "command": "npx",
      "args": [
        "-y",
        "seo-tools-mcp-aparser"
      ],
      "env": {
        "APARSER_PASSWORD": "<APARSER_PASSWORD>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "GA4_REFRESH_TOKEN": "<GA4_REFRESH_TOKEN>",
        "GSC_REFRESH_TOKEN": "<GSC_REFRESH_TOKEN>",
        "YANDEX_OAUTH_TOKEN": "<YANDEX_OAUTH_TOKEN>",
        "METRIKA_OAUTH_TOKEN": "<METRIKA_OAUTH_TOKEN>",
        "YANDEX_CLIENT_SECRET": "<YANDEX_CLIENT_SECRET>",
        "WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
        "XMLRIVER_KEY": "<XMLRIVER_KEY>",
        "XMLSTOCK_KEY": "<XMLSTOCK_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "seo-tools": {
      "command": "npx",
      "args": [
        "-y",
        "seo-tools-mcp-aparser"
      ],
      "env": {
        "APARSER_PASSWORD": "<APARSER_PASSWORD>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "GA4_REFRESH_TOKEN": "<GA4_REFRESH_TOKEN>",
        "GSC_REFRESH_TOKEN": "<GSC_REFRESH_TOKEN>",
        "YANDEX_OAUTH_TOKEN": "<YANDEX_OAUTH_TOKEN>",
        "METRIKA_OAUTH_TOKEN": "<METRIKA_OAUTH_TOKEN>",
        "YANDEX_CLIENT_SECRET": "<YANDEX_CLIENT_SECRET>",
        "WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
        "XMLRIVER_KEY": "<XMLRIVER_KEY>",
        "XMLSTOCK_KEY": "<XMLSTOCK_KEY>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "seo-tools": {
      "command": "npx",
      "args": [
        "-y",
        "seo-tools-mcp-aparser"
      ],
      "env": {
        "APARSER_PASSWORD": "<APARSER_PASSWORD>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "GA4_REFRESH_TOKEN": "<GA4_REFRESH_TOKEN>",
        "GSC_REFRESH_TOKEN": "<GSC_REFRESH_TOKEN>",
        "YANDEX_OAUTH_TOKEN": "<YANDEX_OAUTH_TOKEN>",
        "METRIKA_OAUTH_TOKEN": "<METRIKA_OAUTH_TOKEN>",
        "YANDEX_CLIENT_SECRET": "<YANDEX_CLIENT_SECRET>",
        "WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
        "XMLRIVER_KEY": "<XMLRIVER_KEY>",
        "XMLSTOCK_KEY": "<XMLSTOCK_KEY>"
      }
    }
  }
}

Environment variables

APARSER_PASSWORD
GOOGLE_CLIENT_SECRET
GA4_REFRESH_TOKEN
GSC_REFRESH_TOKEN
YANDEX_OAUTH_TOKEN
METRIKA_OAUTH_TOKEN
YANDEX_CLIENT_SECRET
WORDSTAT_API_KEY
XMLRIVER_KEY
XMLSTOCK_KEY

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related