SerpApi Search Skill

Universal web search skill for AI coding agents with support for 100+ search engines.

Search the web, news, images, shopping, videos, maps, flights, hotels, jobs, and academic databases directly from your AI agent. Powered by SerpApi.

Quick Start

1. Get your API key from the SerpApi Dashboard.
2. Set the environment variable: export SERPAPI_KEY=your_key_here
3. Install the skill to your agent (see Installation below).
4. Start searching! See SKILL.md for usage examples.

What's Included

• SKILL.md: Core skill definition and usage guide.
• ENGINES.md: Catalog of 100+ supported search engines.
• api-key-setup.md: Detailed configuration guide for all agents.
• AGENTS.md: Discovery file for agent integration.
• LICENSE: MIT License terms.

Installation

Pick the installation method for your agent.

Claude Code

git clone https://github.com/serpapi/serpapi-search-skill.git
# Global install (available to all projects):
cp -r serpapi-search-skill/skills/serpapi-search ~/.claude/skills/
# Project-scoped install:
cp -r serpapi-search-skill/skills/serpapi-search .claude/skills/

See api-key-setup.md for MCP configuration.

Cursor

cp -r skills/serpapi-search .cursor/skills/

Or use the Remote Rules URL pointing to your repository's SKILL.md.

Codex

cp -r skills/serpapi-search .agents/skills/

Windsurf

cp -r skills/serpapi-search .windsurf/skills/

OpenClaw

cp -r skills/serpapi-search ~/.openclaw/skills/

NemoClaw (inside sandbox)

# 1. Install serpapi-cli inside the sandbox
go install github.com/serpapi/serpapi-cli/cmd/serpapi@latest
export SERPAPI_KEY=your_key_here

# 2. Copy the skill into the workspace
cp -r skills/serpapi-search skills/serpapi-search

# 3. Apply the network policy
openshell policy set skills/serpapi-search/serpapi.yaml

# 4. Add to ~/.openclaw/openclaw.json
# { "skills": { "entries": { "serpapi-search": { "enabled": true,
#   "apiKey": { "source": "env", "provider": "default", "id": "SERPAPI_KEY" } } } } }

# 5. Make permanent
nemoclaw onboard

Or paste this into any AI assistant with access to your NemoClaw workspace:

Fetch https://raw.githubusercontent.com/serpapi/serpapi-search-skill/main/skills/serpapi-search/SKILL.md
and save it to skills/serpapi-search/SKILL.md.

Fetch https://raw.githubusercontent.com/serpapi/serpapi-search-skill/main/skills/serpapi-search/serpapi.yaml
and save it to nemoclaw-blueprint/policies/presets/serpapi.yaml.

Add this to ~/.openclaw/openclaw.json (home directory, not workspace):
{
  "skills": {
    "entries": {
      "serpapi-search": {
        "enabled": true,
        "apiKey": { "source": "env", "provider": "default", "id": "SERPAPI_KEY" }
      }
    }
  }
}

Then run: nemoclaw onboard

OpenCode

cp -r skills/serpapi-search .opencode/skills/

OpenCode also automatically reads skills from .claude/skills/ and .agents/skills/.

Universal (curl)

Download the skill definition directly to any directory:

curl -O https://raw.githubusercontent.com/serpapi/serpapi-search-skill/main/skills/serpapi-search/SKILL.md

serpapi CLI

If you prefer a CLI over raw curl, install the serpapi CLI:

brew install serpapi/serpapi-cli/serpapi

Then search directly from your shell:

export SERPAPI_KEY=your_key_here
serpapi search engine=google_light q="coffee shops in Austin"

API Key Setup

Configure your SERPAPI_KEY for secure access. Detailed instructions for environment variables, MCP settings, and CI/CD are available in api-key-setup.md.

Available Engines

Search across 100+ platforms including Google, Bing, DuckDuckGo, YouTube, and Amazon. Use Light endpoints for faster responses and lower cost:

• google_light: Fastest general web search (default).
• google_images_light: Optimized image search.
• google_news_light: Latest news results.
• google_shopping_light: Product pricing and availability.
• google_videos_light: Video search.
• duckduckgo_light: Privacy-focused web results.

See ENGINES.md for the full list of 107 engines.

Links

• SerpApi Website
• API Dashboard
• Search Playground
• Documentation

License

MIT License. See LICENSE for details.