# Serphouse Search

> Route SERPHouse questions to the right skill — meta-orchestrator for SERP knowledge

- **Type:** Skill
- **Install:** `agentstack add skill-serphouse-agent-skills-search`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [SERPHouse](https://agentstack.voostack.com/s/serphouse)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [SERPHouse](https://github.com/SERPHouse)
- **Source:** https://github.com/SERPHouse/agent-skills/tree/master/skills/search

## Install

```sh
agentstack add skill-serphouse-agent-skills-search
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# SERPHouse Search & Knowledge Retrieval Skill

This skill teaches an agent **how to find any SERPHouse documentation detail** using the three authoritative sources in this project. Always ground answers in these sources — never guess endpoints, parameters, or behavior.

## The Three Authoritative Sources

| Source | File | Use When... |
|--------|------|-------------|
| **REST API** | `src/api/SKILL.md` | The user wants curl commands, raw HTTP requests, endpoint URLs, rate limits, webhooks |
| **MCP Server** | `src/mcp/SKILL.md` | The user wants to connect an AI client (Claude, Cursor, etc.) to live SERP data via MCP tools |
| **Node.js SDK** | `src/nodejs/SKILL.md` | The user is writing JavaScript/TypeScript code using `@serphouse/serphouse-nodejs` |

## How to Search for Any Detail

### Step 1: Determine which source to consult

- If the question is about **HTTP endpoints, auth, curl, webhooks, or rate limits** → `src/api/SKILL.md`
- If the question is about **MCP client config, tool names, or server setup** → `src/mcp/SKILL.md`
- If the question is about **code examples, SDK setup, TypeScript types, or error handling** → `src/nodejs/SKILL.md`

### Step 2: Search the source file

Use the `grep` tool on the relevant SKILL.md to find the specific detail:

```
grep -- "desired search term" src//SKILL.md
```

Example searches:
- "What endpoint for Google Images?" → grep `google-image` in `src/api/SKILL.md`
- "How to set up MCP auth?" → grep `headers` or `auth` in `src/mcp/SKILL.md`
- "How do I catch errors in the SDK?" → grep `SERPHouseError` or `catch` in `src/nodejs/SKILL.md`

### Step 3: If the detail isn't found

If a search term yields no results in the SKILL.md file:

1. **Try alternative terms** — e.g., if "account info" returns nothing, try "account_info" or "balance"
2. **Check the official docs** at https://docs.serphouse.com for endpoint-specific parameter details (also referenced in `src/nodejs/SKILL.md:293`)
3. **State clearly** that this detail is not in the project's knowledge base rather than fabricating it

## Anti-Hallucination Rules

- **Never invent** endpoint URLs, tool names, method names, parameter names, or parameter rules
- **Never assume** an endpoint exists based on naming patterns — always verify in the source
- **Never guess** the response shape of an endpoint — reference the actual docs
- **Never invent** credit costs or rate limits — they are documented in `src/api/SKILL.md`
- If asked about an engine or feature not listed in any source file, say so instead of guessing
- For the SDK, the response `results` shape varies per endpoint — refer to the SERPHouse API docs for the actual shape (`src/nodejs/SKILL.md:160`)
- The `doc/` folder in the SDK repo and https://docs.serphouse.com have endpoint-specific details not in these skill files

## Quick Reference: What Exists vs. What Does Not

**Confirmed engines:** Google (web, news, images, shopping, jobs, videos, short videos, forums, local, autocomplete, advanced), Bing (web, news, images), Yahoo (web, news, images)

**Confirmed MCP tools (21):** `serphouse_domain_list`, `serphouse_language_list`, `serphouse_location_search`, `serphouse_account_info`, `serphouse_google_web`, `serphouse_google_image`, `serphouse_google_news`, `serphouse_google_shop`, `serphouse_serp_google_advanced`, `serphouse_bing_web`, `serphouse_bing_image`, `serphouse_bing_news`, `serphouse_yahoo_web`, `serphouse_yahoo_image`, `serphouse_yahoo_news`, `serphouse_google_jobs`, `serphouse_google_autocomplete`, `serphouse_google_videos`, `serphouse_google_short_videos`, `serphouse_google_forums`, `serphouse_google_local`

**Not present (do not invent):** DuckDuckGo, Baidu, Yandex, YouTube Search, Amazon Search, TikTok Search, Pinterest, Reddit Search, Instagram, Twitter/X — none of these are in any source file.

## Cross-Reference Table

| Feature | API Endpoint | MCP Tool | SDK Method |
|---------|-------------|----------|------------|
| Google Web | `POST /google-web` | `serphouse_google_web` | `client.google.search()` |
| Google News | `POST /google-news` | `serphouse_google_news` | `client.google.news()` |
| Google Images | `POST /google-image` | `serphouse_google_image` | `client.google.image()` |
| Google Shopping | `POST /google-shop` | `serphouse_google_shop` | `client.google.shopping()` |
| Google Jobs | `POST /google-jobs-api` | `serphouse_google_jobs` | `client.google.jobs()` |
| Google Videos | `POST /google-videos-api` | `serphouse_google_videos` | `client.google.video()` |
| Google Short Videos | `POST /google-short-videos-api` | `serphouse_google_short_videos` | `client.google.short_video()` |
| Google Forums | `POST /google-forums-api` | `serphouse_google_forums` | `client.google.forums()` |
| Google Local | `POST /google-local-api` | `serphouse_google_local` | `client.google.local()` |
| Google Autocomplete | `POST /google-autocomplete-api` | `serphouse_google_autocomplete` | `client.google.autocomplete()` |
| Google Advanced | `POST /serp/google_advanced` | `serphouse_serp_google_advanced` | Not in SDK (use REST) |
| Bing Web | `POST /bing-web` | `serphouse_bing_web` | `client.bing.search()` |
| Bing News | `POST /bing-news` | `serphouse_bing_news` | `client.bing.news()` |
| Bing Image | `POST /bing-image` | `serphouse_bing_image` | `client.bing.image()` |
| Yahoo Web | `POST /yahoo-web` | `serphouse_yahoo_web` | `client.yahoo.search()` |
| Yahoo News | `POST /yahoo-news` | `serphouse_yahoo_news` | `client.yahoo.news()` |
| Yahoo Image | `POST /yahoo-image` | `serphouse_yahoo_image` | `client.yahoo.image()` |
| Domain List | `GET /domain/list` | `serphouse_domain_list` | `client.extra.domain_list()` |
| Language List | `GET /language/list/{type}` | `serphouse_language_list` | `client.extra.language_list()` |
| Location Search | `GET /location/search` | `serphouse_location_search` | `client.extra.location_search()` |
| Account Info | `GET /account/info` | `serphouse_account_info` | `client.extra.account_info()` |

## Workflow for Answering Questions

1. **Read the question** and identify whether it's about API, MCP, or SDK
2. **Read the relevant SKILL.md** fully or grep for keywords
3. **Cross-reference** with the table above if needed
4. **Answer using only what's in the source** — cite line numbers where helpful
5. **If the answer isn't in the source**, say so — do not hallucinate

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [SERPHouse](https://github.com/SERPHouse)
- **Source:** [SERPHouse/agent-skills](https://github.com/SERPHouse/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-serphouse-agent-skills-search
- Seller: https://agentstack.voostack.com/s/serphouse
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.