Skip to content

README.md

Latest commit

 

History

History
167 lines (126 loc) · 5.38 KB

README.md

File metadata and controls

167 lines (126 loc) · 5.38 KB

SerpApi Search Skill

License: MIT

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: 
    npx skills add serpapi/skills
  4. Start searching! See SKILL.md for usage.

What's Included

Installation

The easiest way to install across all your agents at once:

npx skills add serpapi/skills

This installs via the skills CLI and supports Claude Code, Cursor, Codex, OpenCode, Windsurf, and 40+ more agents.

For agent-specific or manual installation:

Claude Code

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

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

Cursor

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

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

Codex

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

Windsurf

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

OpenClaw

cp -r skills/serpapi-web-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-web-search skills/serpapi-web-search

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

# 4. Add to ~/.openclaw/openclaw.json
# { "skills": { "entries": { "serpapi-web-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/skills/main/skills/serpapi-web-search/SKILL.md
and save it to skills/serpapi-web-search/SKILL.md.

Fetch https://raw.githubusercontent.com/serpapi/skills/main/skills/serpapi-web-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-web-search": {
        "enabled": true,
        "apiKey": { "source": "env", "provider": "default", "id": "SERPAPI_KEY" }
      }
    }
  }
}

Then run: nemoclaw onboard

OpenCode

cp -r skills/serpapi-web-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/skills/main/skills/serpapi-web-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 rules/ENGINES.md for the full list of 107 engines.

Links

License

MIT License. See LICENSE for details.