searching-with-serpapi

searching-with-serpapi is a skill for Claude Code, Codex from aryrabelo/serpapi-agent-toolkit. It costs 104 tokens per session (1,506 once invoked), scanned A, original, MIT.

A guide for using SerpApi, a service that returns live search-engine results as structured data. It covers web, news, shopping, local, jobs, flights, academic, image, and video searches.

In plain words
What is it for?
Use it when answers need current or niche information, such as prices, news, rankings, job listings, travel options, or content from a specific webpage.
Why use it?
It helps an agent decide when to search, choose the right search type, limit unnecessary result data, remove duplicates, and cite findings.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it when answers need current or niche information, such as prices, news, rankings, job listings, travel options, or content from a specific webpage.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/aryrabelo/serpapi-agent-toolkit/searching-with-serpapi
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.

Any agent
npx skills add aryrabelo/serpapi-agent-toolkit --skill searching-with-serpapi
Clone the repo
git clone --depth 1 https://github.com/aryrabelo/serpapi-agent-toolkit

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for searching-with-serpapi

README.md
[![agentmods](https://agentmods.dev/badge/skills/aryrabelo/serpapi-agent-toolkit/searching-with-serpapi.svg)](https://agentmods.dev/skills/aryrabelo/serpapi-agent-toolkit/searching-with-serpapi)
Your own site
<a href="https://agentmods.dev/skills/aryrabelo/serpapi-agent-toolkit/searching-with-serpapi"><img src="https://agentmods.dev/badge/skills/aryrabelo/serpapi-agent-toolkit/searching-with-serpapi.svg" alt="Measured on agentmods" height="20"></a>
Per session 104 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,506 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00104 $0.01506
Opus 5 $0.00052 $0.00753
Sonnet 5 $0.00021 $0.00301
Haiku 4.5 $0.00010 $0.00151

Measured 7d ago against content hash 9567b3faf21f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

searching-with-serpapi scanned grade A with 0 findings 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 7d 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/searching-with-serpapi/SKILL.md · 89 lines

How it starts

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

Searching with SerpApi

SerpApi runs a query against a real search engine, solves CAPTCHAs and proxies, and returns clean structured JSON. This skill is the procedure layer: it assumes you already have a SerpApi search capability available (the official serpapi-mcp MCP server, or the serp CLI in this repo) and tells you how to use it well so you spend few tokens and get trustworthy results.

The single biggest mistake agents make with a SERP tool is dumping the full raw JSON into context. SerpApi responses are large. Treat the context window as a public good: ask for the narrowest result that answers the question.

Search when the answer is time-sensitive, niche, or must be cited (prices, news, rankings, "latest", a specific page's current content, anything post-training-cutoff). Do not search for stable general knowledge you already hold, for math, or to re-fetch something already in context. A wasted search costs tokens and latency on both sides.

Step 1 — pick the engine by intent

engine defaults to google_light (fastest). Override it to match the intent:

Intent Engine
General web results, fastest google_light
Full Google SERP (answer box, knowledge graph, AI Overview) google
News / recency google_news
Shopping / product listings + prices google_shopping
Local businesses, maps google_local
Job postings google_jobs
Flights / hotels google_flights / google_hotels
Academic google_scholar
Images / video google_images / youtube_search
Marketplaces amazon, ebay, walmart
Non-Google web bing, duckduckgo, baidu, yandex, yahoo

If you are unsure which parameters an engine accepts, read the engine resource first: serpapi://engines lists every engine, and serpapi://engines/<engine> gives that engine's parameters. Read the one engine you need, not the whole index.

Step 2 — choose output mode: compact first

Read the full file on GitHub · 89 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. 7d ago First seen · 89 lines · 104 tokens per session scan A 9567b3faf21f

Subscribe to this mod's changes

searching-with-serpapi is a skill published in the GitHub repository aryrabelo/serpapi-agent-toolkit (5 stars, last pushed 3mo ago), licensed MIT. It adds 104 tokens to every session and 1,506 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. 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

system-prompts

Write system prompts, tool docs, and agent definitions. Project tag conventions + RFC 2119 keywords + dense compression. Use when authoring or editing any prompt the model reads.

can1357/oh-my-pi · 40 tokens

tool-prompt-optimization

Optimize the description prompts an AI agent reads to learn its built-in tools (the .md files under prompts/tools/). Two halves: (1) measure how much of a prompt is already inferable from the tool's JSON parameter schema + name, to prune redundancy with evidence; (2) house authoring rules for what belongs in a tool…

can1357/oh-my-pi · 0 tokens

semantic-compression

Re-encode verbose prose into a dense telegraphic register — punctuation as connectives, label frames, verbless assertions — without losing normativity or precision. Use when compressing system prompts, tool/function descriptions, skill bodies, or agent instructions; reducing token count or context bloat; making…

can1357/oh-my-pi · 77 tokens

clinical-reports

Write comprehensive clinical reports including case reports (CARE guidelines), diagnostic reports (radiology/pathology/lab), clinical trial reports (ICH-E3, SAE, CSR), and patient documentation (SOAP, H&P, discharge summaries). Full support with templates, regulatory compliance (HIPAA, FDA, ICH-GCP), and validation…

synthetic-sciences/openscience · 71 tokens

imaging-data-commons

Query and download public cancer imaging data from NCI Imaging Data Commons using idc-index. Use for accessing large-scale radiology (CT, MR, PET) and pathology datasets for AI training or research. No authentication required. Query by metadata, visualize in browser, check licenses.

synthetic-sciences/openscience · 62 tokens

clinical-decision-support

Generate professional clinical decision support (CDS) documents for pharmaceutical and clinical research settings, including patient cohort analyses (biomarker-stratified with outcomes) and treatment recommendation reports (evidence-based guidelines with decision algorithms). Supports GRADE evidence grading…

synthetic-sciences/openscience · 97 tokens