# SERPHouse

SERPHouse plugs live Google, Bing and Yahoo results into an AI assistant, plus verticals like Jobs and Local and a location lookup. No scraper of your own.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 107 installs · ★ 10 repo stars
- Author: serphouse
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SERPHouse/serphouse-mcp
- Updated: 2026-07-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/serphouse

## What it does

The server is hosted, so the assistant talks to it over HTTP and gets structured results back. Search tools cover Google, Bing and Yahoo, while Google verticals reach further: images, news, shopping, videos, jobs, local packs, forums, autocomplete. A reference group handles domains, language codes, city-to-`loc_id` resolution and account balance.

Authentication comes in two shapes. Clients that allow custom headers send the key as `SERPHOUSE_API`; others put it in the URL path. Tool discovery works without a key, and one is only needed when a call reaches the SERPHouse API. Running the server yourself is an option, Docker included, and Ollama lets local Llama models use it.

Location handling is where calls break. Each Google and Bing tool wants exactly one of `loc` or `loc_id`. Supply both, or neither, and the request fails. Yahoo tools take no location at all. The URL-path method leaves your key where proxy logs can catch it, so the header is the safer pick.

## Requirements
- Remote server: `https://serphouse.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http serphouse-mcp https://serphouse.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add serphouse --url https://serphouse.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "serphouse": {
            "url": "https://serphouse.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "serphouse": {
            "type": "http",
            "url": "https://serphouse.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http serphouse https://serphouse.run.tools
```

## When to use it
- pull Google results for a specific city from the chat
- compare Bing and Yahoo news on one topic
- turn a city name into a `loc_id`
- check the SERPHouse account balance
- mine keyword ideas from Google autocomplete

## Example prompts
- Show the top Google results for 'crm software' in Austin, Texas.
- Compare Yahoo and Bing news coverage on electric vehicles.
- Find the `loc_id` for London and check our mobile Bing rank.

## Similar
- [tracking-google-serp-rankings](https://affpapa.org/en/nevibecode/skills/tracking-google-serp-rankings.md) — skill · 922 installs
- [google-search](https://affpapa.org/en/nevibecode/skills/acedatacloud-google-search.md) — skill · 232 installs
- [serp-analyzer](https://affpapa.org/en/nevibecode/skills/serp-analyzer.md) — skill · 454 installs
- [page-audit](https://affpapa.org/en/nevibecode/skills/page-audit.md) — skill · ★ 416 repo stars
- [scraping-google-search-results](https://affpapa.org/en/nevibecode/skills/scraping-google-search-results.md) — skill · 917 installs
- [google](https://affpapa.org/en/nevibecode/skills/google.md) — skill · 975 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
