# SERP Maven

MCP-сервер SERP Maven для Claude Code подключает к ИИ-агентам живой поиск Google через настоящий браузер и резидентные прокси. Запускается на запросах к поиску из среды разработки.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 129 у репозитория
- Автор: nodemaven
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/nodemaven/serpmaven
- Обновлён: 2026-11-16
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — внимание: команда скачивает скрипт с astral.sh и сразу его запускает; команда PowerShell скачивает скрипт с astral.sh и сразу его выполняет. Без явного «да» человека такие команды не запускай.
- HTML: https://affpapa.org/nevibecode/mcp/serp-maven

## Что делает

Инструмент собирает поисковую выдачу в структурированный JSON с органическими результатами, рекламой и картами. Под капотом используется реальный браузер Google Chrome под управлением Patchright со смягчением проверок через куки. Трафик пропускается через сессионные прокси с защитой от отравленных страниц.

Для работы требуются Python 3.10 или новее, а также настроенный прокси с поддержкой постоянных сессий. Перед запуском нужно сохранить учетные данные прокси в переменные окружения для авторизации.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `NODEMAVEN_LOGIN`, `NODEMAVEN_PASSWORD`, `SERPMAVEN_PROXY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```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
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from serpmaven <команда>

### Codex

**Командой платформы**
```bash
codex mcp add serp-maven --env NODEMAVEN_LOGIN=<NODEMAVEN_LOGIN> --env NODEMAVEN_PASSWORD=<NODEMAVEN_PASSWORD> --env SERPMAVEN_PROXY=<SERPMAVEN_PROXY> -- uvx serpmaven
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from serpmaven <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "serp-maven": {
            "command": "uvx",
            "args": [
                "serpmaven"
            ],
            "env": {
                "NODEMAVEN_LOGIN": "<NODEMAVEN_LOGIN>",
                "NODEMAVEN_PASSWORD": "<NODEMAVEN_PASSWORD>",
                "SERPMAVEN_PROXY": "<SERPMAVEN_PROXY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from serpmaven <команда>

### GitHub Copilot

**Файл настроек**
Файл `.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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from serpmaven <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e NODEMAVEN_LOGIN=<NODEMAVEN_LOGIN> -e NODEMAVEN_PASSWORD=<NODEMAVEN_PASSWORD> -e SERPMAVEN_PROXY=<SERPMAVEN_PROXY> serp-maven uvx serpmaven
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from serpmaven <команда>

## Когда брать
- получать выдачу Google в формате JSON
- отслеживать позиции сайтов в поисковой системе
- собирать данные для анализа конкурентов
- передавать поисковые результаты ИИ-агентам

## Примеры запросов агенту
- Найди в Google свежие статьи по запросу python mcp servers
- Собери через поиск органические результаты для ключевой фразы seo tools
- Запроси топ выдачи Google по запросу devops automation

## Похожие
- [tracking-google-serp-rankings](https://affpapa.org/nevibecode/skills/tracking-google-serp-rankings.md) — скилл · 922 установки
- [Geekflare](https://affpapa.org/nevibecode/mcp/geekflare-geekflare.md) — MCP-сервер · ★ 1 у репозитория
- [crawlio-browser](https://affpapa.org/nevibecode/mcp/crawlio-browser.md) — MCP-сервер · ★ 8 у репозитория
- [chatgpt-search](https://affpapa.org/nevibecode/skills/chatgpt-search.md) — скилл · ★ 116 у репозитория
- [fetch](https://affpapa.org/nevibecode/skills/fetch.md) — скилл · 3100 установок
- [browser](https://affpapa.org/nevibecode/skills/browser.md) — скилл · 6100 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
