← Back to Skills Marketplace
4894
Downloads
7
Stars
23
Active Installs
3
Versions
Install in OpenClaw
/install serper
Description
Google search via Serper API with full page content extraction. Fast API lookup + concurrent page scraping (3s timeout). One well-crafted query returns rich results — avoid multiple calls. Two modes, explicit locale control. API key via .env.
Usage Guidance
Install only if you are comfortable using a Serper API key and having search terms sent to Serper while result URLs are fetched from external sites. Avoid sensitive secrets, private internal URLs, or confidential investigations as queries, and treat extracted webpage text as untrusted research material.
Capability Analysis
Type: OpenClaw Skill
Name: serper
Version: 3.0.2
The OpenClaw skill bundle for Serper is benign. The `scripts/search.py` script legitimately uses the Serper API for web search and `trafilatura` for content extraction, requiring network access to `google.serper.dev` and arbitrary web pages. It retrieves the `SERPER_API_KEY` from environment variables or a `.env` file, which is standard practice for API-based tools. The `SKILL.md` instructions guide the AI agent on efficient and responsible use of the skill, including defensive instructions to prevent redundant web fetching, rather than attempting malicious prompt injection. No evidence of data exfiltration, malicious execution, persistence, obfuscation, or supply chain attacks was found.
Capability Assessment
Purpose & Capability
The artifacts coherently describe Google search through Serper plus full-page content extraction, and the Python script implements that behavior without unrelated capabilities.
Instruction Scope
Runtime instructions are scoped to when and how to search, locale selection, and avoiding redundant fetching; there is no hidden role change, prompt override, or unrelated workflow.
Install Mechanism
Installation is manual and user-scoped, but it asks users to install the unpinned third-party Python package trafilatura.
Credentials
The skill requires a Serper API key, sends search queries to google.serper.dev, and fetches returned URLs; this is proportionate for a search skill but has privacy implications for sensitive queries.
Persistence & Privilege
The code reads environment variables or a local .env for the API key and shows no background persistence, privilege escalation, broad local file access, destructive actions, or credential exfiltration.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install serper - After installation, invoke the skill by name or use
/serper - Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.0.2
- No code or documentation changes detected in this release.
- Version number update only; functionality and documentation remain unchanged.
v3.0.1
- Added LICENSE and README.md files for legal clarity and documentation.
- Updated documentation to emphasize the new fast API lookup and concurrent page scraping model (3-second timeout per page).
- Output format changed to streamed JSON array, with results emitted one at a time as pages finish.
- Stronger guidance to use only one well-crafted query per invocation for maximum efficiency—multiple sequential queries are discouraged.
- Clarified differences between modes, strict locale requirements, and best practices.
v3.0.0
Serper 3.0.0 — Major update with full page content extraction and explicit locale support
- Adds full-text page content extraction using trafilatura; not just snippets but entire article text from each result.
- Introduces two precise search modes: `default` for general/all-time queries and `current` for news/recent info.
- Requires explicit locale flags (`--gl`, `--hl`) for all non-English or location-specific searches.
- New CLI structure for flexible search modes and locale control.
- Output is clean per-line JSON: first with summary, then each full page/article as retrieved.
- Detailed usage guidance and strict do-not-use for overlapping web-fetch tools.
Metadata
Frequently Asked Questions
What is serper?
Google search via Serper API with full page content extraction. Fast API lookup + concurrent page scraping (3s timeout). One well-crafted query returns rich results — avoid multiple calls. Two modes, explicit locale control. API key via .env. It is an AI Agent Skill for Claude Code / OpenClaw, with 4894 downloads so far.
How do I install serper?
Run "/install serper" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is serper free?
Yes, serper is completely free (open-source). You can download, install and use it at no cost.
Which platforms does serper support?
serper is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created serper?
It is built and maintained by nesdeq (@nesdeq); the current version is v3.0.2.
More Skills