A high-performance, cost-effective Google Search API integration for programmatic data retrieval and lead generation.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install serper-dev
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install serper-dev using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Serper Search Skill?
The serper-search skill provides a streamlined interface to the Serper.dev API, offering a faster and more affordable alternative to traditional search APIs like SerpApi. By leveraging Openclaw Skills, developers can programmatically access organic search results, news, images, and local business data from Google Maps to power automated workflows.
This skill is specifically engineered for high-volume tasks where clean, structured JSON data is required for downstream processing. Whether you are building a research agent or a data scraper, this tool ensures you get the most relevant Google data with minimal latency and at a fraction of the cost of competitors.
Serper Search Skill Use Cases
- Building automated lead generation pipelines to find niche-specific business websites.
- Conducting programmatic competitor research by monitoring organic search rankings.
- Gathering real-time news and content for automated research reports.
- Discovering local businesses via Google Maps/Places for sales outreach.
- Scraping product information and pricing for ecommerce market analysis.
How Serper Search Skill Works
- The user or agent provides a search query and optional parameters like country code (gl) or result count (num).
- The skill authenticates with the Serper.dev API using the required SERPER_API_KEY environment variable.
- A POST request is dispatched to the specific Serper endpoint, such as Search, Places, News, Images, or Shopping.
- The skill receives the raw JSON response and can perform additional processing, such as domain extraction or filtering out unwanted directories.
- The structured data is returned to the Openclaw Skills environment for final output or further automated steps.
Serper Search Skill Setup
To use this skill, you must first obtain an API key from serper.dev. Once you have your key, configure your environment:
export SERPER_API_KEY="your_key_here"
Ensure you have the necessary dependencies installed for processing results:
pip install requests tldextract
Serper Search Skill Data Schema & Taxonomy
The skill returns data in a structured JSON format. Depending on the endpoint used, the schema will vary. Below is the structure for organic and place results:
| Field | Source | Description |
|---|---|---|
| title | Organic/Places | The page title or business name |
| link | Organic | The direct URL to the resource |
| snippet | Organic | A short preview of the content |
| domain | Organic | The extracted root domain (e.g., example.com) |
| phone | Places | The direct phone number for local businesses |
| website | Places | The official website URL for the business |
| address | Places | The physical location of the business |
Serper Search Skill Advanced Features
- Multi-query templating to perform exhaustive searches across different niches and geographic locations.
- Intelligent domain exclusion to filter out high-authority directory sites like Yelp, Facebook, or TripAdvisor in lead gen workflows.
- Dedicated Places endpoint support for deep local business discovery including ratings and review counts.
- Built-in error handling for rate limits (429 errors) with configurable retry logic and sleep delays.
- Country-specific localization using the gl parameter to ensure regional search accuracy.
SKILL.md
Loading
Related Openclaw Skills
React Local Business Website Generator
A specialized skill for generating production-ready, 5-page React websites for local businesses with modern animations and responsive design.
Plugin Architecture
A specialized framework extension that enables plugins to register and display custom UI views and sidebar tabs within the Control dashboard.
Playwright Browser Setup
A streamlined utility for configuring headless Playwright Chromium automation within Clawdbot environments.
OpenClaw VPS Hardening
A comprehensive seven-layer defense-in-depth strategy designed to secure OpenClaw agents on public VPS instances using Cloudflare Zero Trust architecture.
Skill Creator
A specialized framework for designing, initializing, and packaging modular capabilities for AI agents.
Supabase Vault
A high-security secret management integration that replaces local storage with an encrypted Supabase Postgres vault for Openclaw Skills.
Featured*
