serphouse-api

Instructions for calling the SERPHouse REST API with curl to search the web and collect search-engine results and SEO data. SERP means search-engine results page.

In plain words
What is it for?
Use it to run searches, inspect rankings and search-result pages, gather SEO intelligence, and retrieve data from SERPHouse endpoints.
Why use it?
It gives an agent a documented way to authenticate and request Google, Bing, and Yahoo results across web, news, images, shopping, jobs, local, video, and other searches.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/serphouse/agent-skills/api
Any agent
npx skills add SERPHouse/agent-skills --skill api
Clone the repo
git clone --depth 1 https://github.com/SERPHouse/agent-skills

Made for: Claude Code, Codex.

Per session 28 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,355 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00028 $0.02355
Opus 5 $0.00014 $0.01177
Sonnet 5 $0.00006 $0.00471
Haiku 4.5 $0.00003 $0.00235

Measured 2d ago against content hash 7beca3833388, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

serphouse-api scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

description: Teach AI agents to call SERPHouse REST APIs with curl for web search, SERP data, and SEO intelligence
skills/api/SKILL.md · 260 lines

How it starts

The opening of the file, as written. The whole thing — 260 lines — stays where its author put it; the contents beside it link to each section on GitHub.

SERPHouse API Skill

This skill equips the agent to search the web and scrape SERP data via the SERPHouse API. The agent can search Google, Bing, Yahoo — web, news, images, shopping, jobs, forums, local, video, and more.

How to Use

  1. On first invocation, the user must provide a SERPHOUSE_API_KEY. The agent will store and reuse it for subsequent searches.
  2. The agent uses curl to call SERPHouse endpoints unless the codebase provides a dedicated client.
  3. Always prefer curl examples when showing the user how to use an endpoint — include the full command with api_token=<KEY> or Authorization: Bearer <KEY>.

Authentication

Pass your API key in one of two ways:

  • Header: Authorization: Bearer <KEY>
  • Query param: api_token=<KEY>

Base URL: https://api.serphouse.com

curl Examples for Every Endpoint

1. SERP API (General)

Live GET search (realtime):

curl "https://api.serphouse.com/serp/live?q=best+coding+courses&serp_type=web&api_token=$SERPHOUSE_API_KEY"

Live POST search:

curl -X POST https://api.serphouse.com/serp/live \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"best coding courses","domain":"google.com","lang":"en","device":"desktop","serp_type":"web"}'

Schedule batch tasks (up to 100):

curl -X POST https://api.serphouse.com/serp/schedule \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"q":"python tutorial","domain":"google.com","lang":"en","device":"desktop","serp_type":"web"}]'

Google Advanced (top 100 results):

curl -X POST https://api.serphouse.com/serp/google_advanced \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"machine learning","domain":"google.com","lang":"en","device":"desktop","max_pages":5}'

Check task status:

curl "https://api.serphouse.com/serp/check?id=TASK_ID&api_token=$SERPHOUSE_API_KEY"

Read the full file on GitHub · 260 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 260 lines · 28 tokens per session scan A 7beca3833388

Subscribe to this mod's changes

serphouse-api is a skill published in the GitHub repository SERPHouse/agent-skills (2 stars, last pushed 1mo ago), licensed MIT. It adds 28 tokens to every session and 2,355 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

document

Workflow Phase 10 — orchestrator for documentation work. Surveys the diff, routes any page on a documentation surface through technical-writer, standalone technical reference through the documentation skill, tutorials through technical-tutorials, and all other prose body work (inline docs, README updates, user-facing…

friedbotstudio/baseline · 94 tokens

recall

Harmonia recall - surface relevant past learnings for the current repo mid-session. Use ONLY when explicitly invoked as /harmonia:recall.

foliveira/harmonia · 33 tokens

remember

Harmonia remember - capture a single learning into the right memory tier. Use ONLY when explicitly invoked as /harmonia:remember.

foliveira/harmonia · 29 tokens

explaining-code

Explains code with visual diagrams and analogies. Use when explaining how code works, teaching about a codebase, or when the user asks "how does this work?".

spacecake-labs/spacecake · 38 tokens

teach-impeccable

One-time setup that gathers design context for your project and saves it to your AI config file. Run once to establish persistent design guidelines.

rwliebs/Dossier · 33 tokens

alego-doc-standards

Use when writing, moving, reviewing, or auditing documentation in the alego repo — choosing hierarchy and detail, separating tutorials from references, checking tutorial progression, trimming doc slop, responding to a verify-doc-budgets failure, or requests like "improve the docs", "audit the docs", "where should this…

singula-ai/alego · 82 tokens