serphouse-mcp

---
name: serphouse-mcp
description: Teach AI agents to use SERPHouse MCP tools for live SERP data, Google verticals, and SEO intelligence
---

# SERPHouse MCP Server Skill

Connect AI assistants to live SERP data, Google verticals, and SEO intelligence — powered by [SERPHouse](https://serphouse.com). Run Google, Bing, and Yahoo searches, resolve locations, and query Jobs, Local, Videos, and more via any MCP-compatible client.

## When to Use

Trigger when the user's request involves **live search engine data**:

| Category | Example prompts |
|---|---|
| **Rank tracking** | "Where do we rank for 'crm software' on Google US desktop?" |
| **Competitor analysis** | "Who owns the top 5 spots for 'project management software' in London?" |
| **Local search** | "Top Google Local results for 'emergency plumber' in Chicago." |
| **Keyword discovery** | "What does Autocomplete suggest for 'best saas for'?" |
| **Position monitoring** | "Run a mobile Bing SERP check for our brand in NYC." |
| **Multi-engine** | "Compare Yahoo and Google news results for 'electric vehicles'." |
| **Image/News/Video** | "Search Google Images for 'minimalist logo'." |
| **Job listings** | "Search Google Jobs for 'software engineer' in San Francisco." |
| **Location resolution** | "Find the loc_id for Austin, Texas." |
| **Account info** | "Check my SERPHouse account balance." |

Do **not** trigger for static/internal queries (e.g., "summarize our docs").

## How to Add

### 1. Get an API Key

Sign up at [SERPHouse Dashboard](https://www.serphouse.com).

### 2. Add to Client Config

**Header-based auth (recommended):**

```json
{
  "mcpServers": {
    "serphouse": {
      "type": "http",
      "url": "https://mcp.serphouse.com/mcp",
      "headers": {
        "SERPHOUSE_API": "<your_serphouse_api_key>"
      }
    }
  }
}
```

**URL-path auth (for clients without custom header support):**

```json
{
  "mcpServers": {
    "serphouse": {
      "type": "http",
      "url": "https://mcp.serphouse.com/<your_serphouse_api_key>/mcp"
    }
  }
}
```

## Available Tools (21 total)

### Reference Tools
`serphouse_domain_list`, `serphouse_language_list`, `serphouse_location_search`, `serphouse_account_info`

### Google SERP
`serphouse_google_web`, `serphouse_google_image`, `serphouse_google_news`, `serphouse_google_shop`, `serphouse_serp_google_advanced`

### Bing SERP
`serphouse_bing_web`, `serphouse_bing_image`, `serphouse_bing_news`

### Yahoo SERP
`serphouse_yahoo_web`, `serphouse_yahoo_image`, `serphouse_yahoo_news`

### Google Verticals
`serphouse_google_jobs`, `serphouse_google_autocomplete`, `serphouse_google_videos`, `serphouse_google_short_videos`, `serphouse_google_forums`, `serphouse_google_local`

## Usage Rules

- **Google and Bing SERP** tools require exactly **one** location field: `loc` (e.g. `"Austin,Texas,United States"`) or `loc_id` (resolved via `serphouse_location_search`). Never send both or omit both.
- **Yahoo SERP** tools do **not** require location.
- Tools/resources can be discovered without a key; key required only when calling tools.