# serpapi

Search - Unified Search via SkillBoss API Hub SkillBoss API Hub provides structured web search results powered by multiple search engines (Google, Amazon, Yelp, OpenTable, and more) through a single unified API. Setup Get your API key from SkillBoss API Hub Set environment variable: export SKILLBOSS_API_KEY=your-key-here Optionally set default location in /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 featuresgoogleGeneral web searchOrganic results, knowledge graph, local packgoogle_mapsLocal places/businessesRatings, reviews, hours, GPS coordinatesgoogle_shoppingProduct searchPrices, merchants, reviewsgoogle_imagesImage searchThumbnails, sourcesgoogle_newsNews articlesHeadlines, sources, datesamazonAmazon productsPrices, ratings, reviews, Prime statusyelpLocal businessesReviews, ratings, categoriesopentableRestaurant reviewsDining reviews, ratingswalmartWalmart productsPrices, availabilityebayeBay listingsPrices, bids, conditionstripadvisorTravel/attractionsHotels, restaurants, things to do Options OptionDescription--location, -lLocation for local results (city, zip, address)--num, -nNumber of results (default: 10)--format, -fOutput format: json (default) or text--type, -tGoogle search type: shop, isch, nws, vid--page, -pPage number for pagination--glCountry code (e.g., us, uk, de)--hlLanguage 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 SkillBoss API Hub. 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 All searches are routed automatically via SkillBoss API Hub (/v1/pilot)