{ "schemaVersion": "1.0", "item": { "slug": "serpapi", "name": "SerpAPI", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/ianpcook/serpapi", "canonicalUrl": "https://clawhub.ai/ianpcook/serpapi", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/serpapi", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=serpapi", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "scripts/serp.py" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "slug": "serpapi", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-08T17:51:53.065Z", "expiresAt": "2026-05-15T17:51:53.065Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=serpapi", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=serpapi", "contentDisposition": "attachment; filename=\"serpapi-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "serpapi" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/serpapi" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/serpapi", "agentPageUrl": "https://openagent3.xyz/skills/serpapi/agent", "manifestUrl": "https://openagent3.xyz/skills/serpapi/agent.json", "briefUrl": "https://openagent3.xyz/skills/serpapi/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "SerpAPI - Unified Search", "body": "SerpAPI provides structured data from Google, Amazon, Yelp, OpenTable, and 20+ other search engines through a single API." }, { "title": "Setup", "body": "Get an API key from https://serpapi.com (free tier: 100 searches/month)\nSet environment variable: export SERPAPI_API_KEY=your-key-here\nOptionally set default location in /TOOLS.md:\n## SerpAPI\nDefault location: Pittsburgh, PA" }, { "title": "Usage", "body": "# General syntax\n/scripts/serp.py \"\" [options]\n\n# Examples\nserp.py google \"best coffee shops\"\nserp.py google_maps \"restaurants near me\" --location \"15238\"\nserp.py amazon \"mechanical keyboard\" --num 10\nserp.py yelp \"pizza\" --location \"New York, NY\"\nserp.py google_shopping \"standing desk\"" }, { "title": "Engines", "body": "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" }, { "title": "Options", "body": "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)" }, { "title": "When to Use Which Engine", "body": "Finding local businesses/restaurants:\n\ngoogle_maps — Best for discovering places, hours, reviews\nyelp — Deep reviews and ratings for restaurants/services\nopentable — Restaurant-specific, dining reviews\n\nShopping/Products:\n\ngoogle_shopping — Compare prices across merchants\namazon — Amazon-specific search with Prime info\nwalmart — Walmart inventory and prices\nebay — Used items, auctions, collectibles\n\nGeneral research:\n\ngoogle — Web pages, articles, general info\ngoogle_news — Current events, news articles\ngoogle_images — Finding images" }, { "title": "Find restaurants near a location", "body": "serp.py google_maps \"italian restaurants\" --location \"Pittsburgh, PA\" --num 5" }, { "title": "Compare product prices", "body": "serp.py google_shopping \"sony wh-1000xm5\" --num 10" }, { "title": "Check Amazon reviews and pricing", "body": "serp.py amazon \"standing desk\" --num 10" }, { "title": "Get Yelp reviews for local services", "body": "serp.py yelp \"plumber\" --location \"15238\"" }, { "title": "Search news on a topic", "body": "serp.py google_news \"AI regulation\" --num 5" }, { "title": "Output Formats", "body": "JSON (default): Full structured data from SerpAPI. Best for programmatic use or when you need all details.\n\nText (--format text): Human-readable summary. Best for quick answers." }, { "title": "Integration Notes", "body": "Results are structured JSON — parse and extract what you need\nLocal results include GPS coordinates for mapping\nShopping results include extracted prices for comparison\nKnowledge graph provides entity information when available\nRate limits: 100/month on free tier, check your plan at serpapi.com/dashboard" } ], "body": "SerpAPI - Unified Search\n\nSerpAPI provides structured data from Google, Amazon, Yelp, OpenTable, and 20+ other search engines through a single API.\n\nSetup\nGet an API key from https://serpapi.com (free tier: 100 searches/month)\nSet environment variable: export SERPAPI_API_KEY=your-key-here\nOptionally set default location in /TOOLS.md:\n## SerpAPI\nDefault location: Pittsburgh, PA\n\nUsage\n# General syntax\n/scripts/serp.py \"\" [options]\n\n# Examples\nserp.py google \"best coffee shops\"\nserp.py google_maps \"restaurants near me\" --location \"15238\"\nserp.py amazon \"mechanical keyboard\" --num 10\nserp.py yelp \"pizza\" --location \"New York, NY\"\nserp.py google_shopping \"standing desk\"\n\nEngines\nEngine\tUse for\tKey features\ngoogle\tGeneral web search\tOrganic results, knowledge graph, local pack\ngoogle_maps\tLocal places/businesses\tRatings, reviews, hours, GPS coordinates\ngoogle_shopping\tProduct search\tPrices, merchants, reviews\ngoogle_images\tImage search\tThumbnails, sources\ngoogle_news\tNews articles\tHeadlines, sources, dates\namazon\tAmazon products\tPrices, ratings, reviews, Prime status\nyelp\tLocal businesses\tReviews, ratings, categories\nopentable\tRestaurant reviews\tDining reviews, ratings\nwalmart\tWalmart products\tPrices, availability\nebay\teBay listings\tPrices, bids, conditions\ntripadvisor\tTravel/attractions\tHotels, restaurants, things to do\nOptions\nOption\tDescription\n--location, -l\tLocation for local results (city, zip, address)\n--num, -n\tNumber of results (default: 10)\n--format, -f\tOutput format: json (default) or text\n--type, -t\tGoogle search type: shop, isch, nws, vid\n--page, -p\tPage number for pagination\n--gl\tCountry code (e.g., us, uk, de)\n--hl\tLanguage code (e.g., en, es, fr)\nWhen to Use Which Engine\n\nFinding local businesses/restaurants:\n\ngoogle_maps — Best for discovering places, hours, reviews\nyelp — Deep reviews and ratings for restaurants/services\nopentable — Restaurant-specific, dining reviews\n\nShopping/Products:\n\ngoogle_shopping — Compare prices across merchants\namazon — Amazon-specific search with Prime info\nwalmart — Walmart inventory and prices\nebay — Used items, auctions, collectibles\n\nGeneral research:\n\ngoogle — Web pages, articles, general info\ngoogle_news — Current events, news articles\ngoogle_images — Finding images\nExamples\nFind restaurants near a location\nserp.py google_maps \"italian restaurants\" --location \"Pittsburgh, PA\" --num 5\n\nCompare product prices\nserp.py google_shopping \"sony wh-1000xm5\" --num 10\n\nCheck Amazon reviews and pricing\nserp.py amazon \"standing desk\" --num 10\n\nGet Yelp reviews for local services\nserp.py yelp \"plumber\" --location \"15238\"\n\nSearch news on a topic\nserp.py google_news \"AI regulation\" --num 5\n\nOutput Formats\n\nJSON (default): Full structured data from SerpAPI. Best for programmatic use or when you need all details.\n\nText (--format text): Human-readable summary. Best for quick answers.\n\nIntegration Notes\nResults are structured JSON — parse and extract what you need\nLocal results include GPS coordinates for mapping\nShopping results include extracted prices for comparison\nKnowledge graph provides entity information when available\nRate limits: 100/month on free tier, check your plan at serpapi.com/dashboard" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/ianpcook/serpapi", "publisherUrl": "https://clawhub.ai/ianpcook/serpapi", "owner": "ianpcook", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/serpapi", "downloadUrl": "https://openagent3.xyz/downloads/serpapi", "agentUrl": "https://openagent3.xyz/skills/serpapi/agent", "manifestUrl": "https://openagent3.xyz/skills/serpapi/agent.json", "briefUrl": "https://openagent3.xyz/skills/serpapi/agent.md" } }