Serphouse Search

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
• Source: SERPHouse/agent-skills
• License: MIT

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