# SERP Maven

The SERP Maven MCP server for Claude Code connects AI agents to live Google search results through a real browser and residential proxies. It runs search queries from the IDE.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 129 repo stars
- Author: nodemaven
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/nodemaven/serpmaven
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — warning: a command downloads a script from astral.sh and runs it right away; a PowerShell command downloads a script from astral.sh and runs it right away. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/mcp/serp-maven

## What it does

The tool extracts search results into structured JSON covering organic links, ads, and local listings. Under the hood, it relies on a real Google Chrome browser managed by Patchright with session cookies to bypass checks. Traffic routes through sticky residential proxies equipped with poisoned results protection.

The setup requires Python 3.10 or newer and a residential proxy with sticky sessions. You need to provide proxy credentials via environment variables before launching.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `NODEMAVEN_LOGIN`, `NODEMAVEN_PASSWORD`, `SERPMAVEN_PROXY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env NODEMAVEN_LOGIN=<NODEMAVEN_LOGIN> --env NODEMAVEN_PASSWORD=<NODEMAVEN_PASSWORD> --env SERPMAVEN_PROXY=<SERPMAVEN_PROXY> --transport stdio serp-maven -- uvx serpmaven
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from serpmaven <command>

### Codex

**Platform CLI**
```bash
codex mcp add serp-maven --env NODEMAVEN_LOGIN=<NODEMAVEN_LOGIN> --env NODEMAVEN_PASSWORD=<NODEMAVEN_PASSWORD> --env SERPMAVEN_PROXY=<SERPMAVEN_PROXY> -- uvx serpmaven
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from serpmaven <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "serp-maven": {
            "command": "uvx",
            "args": [
                "serpmaven"
            ],
            "env": {
                "NODEMAVEN_LOGIN": "<NODEMAVEN_LOGIN>",
                "NODEMAVEN_PASSWORD": "<NODEMAVEN_PASSWORD>",
                "SERPMAVEN_PROXY": "<SERPMAVEN_PROXY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from serpmaven <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "serp-maven": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "serpmaven"
            ],
            "env": {
                "NODEMAVEN_LOGIN": "<NODEMAVEN_LOGIN>",
                "NODEMAVEN_PASSWORD": "<NODEMAVEN_PASSWORD>",
                "SERPMAVEN_PROXY": "<SERPMAVEN_PROXY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from serpmaven <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e NODEMAVEN_LOGIN=<NODEMAVEN_LOGIN> -e NODEMAVEN_PASSWORD=<NODEMAVEN_PASSWORD> -e SERPMAVEN_PROXY=<SERPMAVEN_PROXY> serp-maven uvx serpmaven
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from serpmaven <command>

## When to use it
- fetch live Google search results as JSON
- monitor keyword rankings and SEO metrics
- gather competitor data from search pages
- feed search queries directly to AI agents

## Example prompts
- Search Google for recent articles about python mcp servers
- Get organic search results for the keyword seo tools
- Query top Google results for devops automation

## Similar
- [tracking-google-serp-rankings](https://affpapa.org/en/nevibecode/skills/tracking-google-serp-rankings.md) — skill · 922 installs
- [Geekflare](https://affpapa.org/en/nevibecode/mcp/geekflare-geekflare.md) — MCP server · ★ 1 repo stars
- [crawlio-browser](https://affpapa.org/en/nevibecode/mcp/crawlio-browser.md) — MCP server · ★ 8 repo stars
- [chatgpt-search](https://affpapa.org/en/nevibecode/skills/chatgpt-search.md) — skill · ★ 116 repo stars
- [fetch](https://affpapa.org/en/nevibecode/skills/fetch.md) — skill · 3100 installs
- [browser](https://affpapa.org/en/nevibecode/skills/browser.md) — skill · 6100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
