Awesome-openclaw-skills serpapi

Unified search API across Google, Amazon, Yelp, OpenTable, Walmart, and more. Use when searching for products, local businesses, restaurants, shopping, images, news, or any web search. One API key, many engines.

install
source · Clone the upstream repo
git clone https://github.com/sundial-org/awesome-openclaw-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/serpapi" ~/.claude/skills/sundial-org-awesome-openclaw-skills-serpapi && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/serpapi" ~/.openclaw/skills/sundial-org-awesome-openclaw-skills-serpapi && rm -rf "$T"
manifest: skills/serpapi/SKILL.md
source content

SerpAPI - Unified Search

SerpAPI provides structured data from Google, Amazon, Yelp, OpenTable, and 20+ other search engines through a single API.

Setup

  1. Get an API key from https://serpapi.com (free tier: 100 searches/month)
  2. Set environment variable:
    export SERPAPI_API_KEY=your-key-here
  3. Optionally set default location in
    <workspace>/TOOLS.md
    :
    ## SerpAPI
    Default location: Pittsburgh, PA
    

Usage

# General syntax
<skill>/scripts/serp.py <engine> "<query>" [options]

# Examples
serp.py google "best coffee shops"
serp.py google_maps "restaurants near me" --location "15238"
serp.py amazon "mechanical keyboard" --num 10
serp.py yelp "pizza" --location "New York, NY"
serp.py google_shopping "standing desk"

Engines

EngineUse forKey features
google
General web searchOrganic results, knowledge graph, local pack
google_maps
Local places/businessesRatings, reviews, hours, GPS coordinates
google_shopping
Product searchPrices, merchants, reviews
google_images
Image searchThumbnails, sources
google_news
News articlesHeadlines, sources, dates
amazon
Amazon productsPrices, ratings, reviews, Prime status
yelp
Local businessesReviews, ratings, categories
opentable
Restaurant reviewsDining reviews, ratings
walmart
Walmart productsPrices, availability
ebay
eBay listingsPrices, bids, conditions
tripadvisor
Travel/attractionsHotels, restaurants, things to do

Options

OptionDescription
--location
,
-l
Location for local results (city, zip, address)
--num
,
-n
Number of results (default: 10)
--format
,
-f
Output format:
json
(default) or
text
--type
,
-t
Google search type:
shop
,
isch
,
nws
,
vid
--page
,
-p
Page number for pagination
--gl
Country code (e.g.,
us
,
uk
,
de
)
--hl
Language code (e.g.,
en
,
es
,
fr
)

When to Use Which Engine

Finding local businesses/restaurants:

  • google_maps
    — Best for discovering places, hours, reviews
  • yelp
    — Deep reviews and ratings for restaurants/services
  • opentable
    — Restaurant-specific, dining reviews

Shopping/Products:

  • google_shopping
    — Compare prices across merchants
  • amazon
    — Amazon-specific search with Prime info
  • walmart
    — Walmart inventory and prices
  • ebay
    — Used items, auctions, collectibles

General research:

  • google
    — Web pages, articles, general info
  • google_news
    — Current events, news articles
  • google_images
    — Finding images

Examples

Find restaurants near a location

serp.py google_maps "italian restaurants" --location "Pittsburgh, PA" --num 5

Compare product prices

serp.py google_shopping "sony wh-1000xm5" --num 10

Check Amazon reviews and pricing

serp.py amazon "standing desk" --num 10

Get Yelp reviews for local services

serp.py yelp "plumber" --location "15238"

Search news on a topic

serp.py google_news "AI regulation" --num 5

Output Formats

JSON (default): Full structured data from SerpAPI. Best for programmatic use or when you need all details.

Text (

--format text
): Human-readable summary. Best for quick answers.

Integration Notes

  • Results are structured JSON — parse and extract what you need
  • Local results include GPS coordinates for mapping
  • Shopping results include extracted prices for comparison
  • Knowledge graph provides entity information when available
  • Rate limits: 100/month on free tier, check your plan at serpapi.com/dashboard