> For the complete documentation index, see [llms.txt](https://docs.serphouse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.serphouse.com/agent-harnesses/agent-skills.md).

# Agent Skills

### Overview

Official AI agent skills for the SERPHouse ecosystem.

Teach AI agents how to use the SERPHouse REST API, MCP server, and Node.js SDK with accurate, grounded knowledge instead of relying on hallucinated documentation.

These skills work with any compatible AI coding assistant that supports the Skills format.

***

### Why Agent Skills?

AI agents are excellent at writing code, but they don't automatically know how third-party platforms work.

Without structured knowledge they may:

* Use incorrect endpoints
* Invent SDK methods
* Generate invalid MCP tool calls
* Miss authentication requirements
* Produce outdated examples

SERPHouse Agent Skills solve this by providing curated knowledge that your AI agent can reference while generating code or calling tools.

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>SERPHouse Agent Skill on GitHub</td><td><a href="/files/Xq0oyQfrev32xggtwIRe">/files/Xq0oyQfrev32xggtwIRe</a></td><td><a href="https://github.com/SERPHouse/agent-skills">https://github.com/SERPHouse/agent-skills</a></td></tr></tbody></table>

***

### Available Skills

| Skill       | Purpose                                                                                                               |
| ----------- | --------------------------------------------------------------------------------------------------------------------- |
| **Search**  | Routes questions to the correct SERPHouse skill.                                                                      |
| **API**     | Complete REST API reference including authentication, endpoints, parameters, examples, rate limits, and credit costs. |
| **MCP**     | Complete MCP tool reference for Claude, Cursor, OpenCode, and other MCP clients.                                      |
| **Node.js** | Full documentation for the `@serphouse/serphouse-nodejs` SDK with typed examples for every supported method.          |

***

### Repository Structure

```
skills/
├── api/
│   └── SKILL.md
├── mcp/
│   └── SKILL.md
├── nodejs/
│   └── SKILL.md
└── search/
    └── SKILL.md
```

Each directory contains a standalone `SKILL.md` file that can be installed independently.

***

### Installation

Install only the skills you need.

#### Search

Routes requests to the appropriate SERPHouse documentation automatically.

```bash
npx skills add https://github.com/SERPHouse/agent-skills --skill serphouse-search
```

***

#### API

For AI agents that generate REST API requests.

```bash
npx skills add https://github.com/SERPHouse/agent-skills --skill serphouse-api
```

Best for:

* cURL examples
* REST integrations
* Batch tasks
* Webhooks
* Custom applications

***

#### MCP

For AI agents running inside MCP-compatible clients.

```bash
npx skills add https://github.com/SERPHouse/agent-skills --skill serphouse-mcp
```

Supports clients such as:

* Claude Desktop
* Cursor
* OpenCode
* Any MCP-compatible client

***

#### Node.js

For TypeScript and Node.js development.

```bash
npx skills add https://github.com/SERPHouse/agent-skills --skill serphouse-nodejs
```

Provides documentation for:

* `@serphouse/serphouse-nodejs`
* Typed examples
* Error handling
* Every available SDK method

***

### Authentication

Generate an API key from the SERPHouse Dashboard and expose it as an environment variable.

```bash
export SERPHOUSE_API_KEY="your_api_key"
```

All SERPHouse skills use this environment variable automatically.

***

### Example Prompts

After installing the skills, your AI agent can accurately answer prompts like:

> Search Google News for the latest AI announcements using SERPHouse.

> Use SERPHouse MCP tools to compare OpenAI and Anthropic.

> Generate a Node.js script using `@serphouse/serphouse-nodejs` to fetch Google Shopping results.

> Create a batch SERP task with the SERPHouse REST API.

> Explain how to configure the SERPHouse MCP server in Cursor.

***

### Why These Skills?

| Skill      | What it solves                                                                                            |
| ---------- | --------------------------------------------------------------------------------------------------------- |
| **search** | Routes requests to the correct SERPHouse documentation so the agent always consults the right source.     |
| **api**    | Provides grounded knowledge of REST endpoints, authentication, request formats, rate limits, and pricing. |
| **mcp**    | Documents every MCP tool, parameters, and expected inputs so agents can invoke tools correctly.           |
| **nodejs** | Documents SDK methods, imports, TypeScript types, and usage patterns for reliable code generation.        |

Together these skills reduce hallucinations and enable AI agents to build working SERPHouse integrations with minimal prompting.