# SERPHouse

MCP-сервер SERPHouse подключает поиск Google, Bing и Yahoo к ИИ-ассистенту: выдача, вертикали вроде Jobs и Local и справка по локациям. Свой скрапер не нужен.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 107 установок · ★ 10 у репозитория
- Автор: serphouse
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/SERPHouse/serphouse-mcp
- Обновлён: 2026-07-22
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/serphouse

## Что делает

Сервер работает на стороне сервиса: ассистент вызывает его инструменты и получает структурированную выдачу Google, Bing и Yahoo. Кроме обычного веб-поиска есть картинки, новости, товары, видео, вакансии, локальные результаты, форумы и автодополнение. Отдельная группа инструментов — справочная: список доменов, коды языков, поиск `loc_id` по названию города и баланс аккаунта.

Ключ SERPHouse передаётся в заголовке `SERPHOUSE_API` либо прямо в пути URL. Список инструментов и ресурсы `serphouse_capabilities`, `serphouse_constraints`, `serphouse_examples` читаются без ключа, он нужен только на вызовах API. Сервер можно поднять у себя, в том числе в Docker, и подключить к локальным моделям через Ollama.

У инструментов Google и Bing ровно одно поле локации: `loc` или `loc_id`. Отправить оба сразу или не отправить ни одного — запрос не пройдёт. У Yahoo локация не нужна. Ключ в пути URL удобен для клиентов без своих заголовков, но он окажется в логах прокси, поэтому заголовок надёжнее.

## Требования
- Удалённый сервер: `https://serphouse.run.tools`

## Установка

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

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http serphouse-mcp https://serphouse.run.tools
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add serphouse --url https://serphouse.run.tools
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "serphouse": {
            "url": "https://serphouse.run.tools"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "serphouse": {
            "type": "http",
            "url": "https://serphouse.run.tools"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http serphouse https://serphouse.run.tools
```

## Когда брать
- снять выдачу Google по конкретному городу из чата
- сравнить новостные результаты Bing и Yahoo по одной теме
- получить `loc_id` по названию города
- посмотреть остаток на аккаунте SERPHouse
- собрать идеи ключевых слов из автодополнения Google

## Примеры запросов агенту
- Найди в Google первые результаты по запросу «crm software» для Austin, Texas.
- Сравни новостную выдачу Yahoo и Bing по электромобилям.
- Подбери `loc_id` для Лондона и проверь нашу позицию в мобильной выдаче Bing.

## Похожие
- [tracking-google-serp-rankings](https://affpapa.org/nevibecode/skills/tracking-google-serp-rankings.md) — скилл · 922 установки
- [google-search](https://affpapa.org/nevibecode/skills/acedatacloud-google-search.md) — скилл · 232 установки
- [serp-analyzer](https://affpapa.org/nevibecode/skills/serp-analyzer.md) — скилл · 454 установки
- [page-audit](https://affpapa.org/nevibecode/skills/page-audit.md) — скилл · ★ 416 у репозитория
- [scraping-google-search-results](https://affpapa.org/nevibecode/skills/scraping-google-search-results.md) — скилл · 917 установок
- [google](https://affpapa.org/nevibecode/skills/google.md) — скилл · 975 установок

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