← Back to Skills Marketplace
serper-search
by
Samoppakiks
· GitHub ↗
· v1.0.0
2675
Downloads
2
Stars
20
Active Installs
1
Versions
Install in OpenClaw
/install serper-search
Description
Fetches real Google search or news results with links, snippets, knowledge graph data, and related questions via the Serper.dev API.
Usage Guidance
This plugin sends search queries to Serper.dev (endpoints: https://google.serper.dev/search and /news) and requires a Serper API key (set SERPER_API_KEY or plugin config.apiKey) to work. Before installing: confirm you trust serper.dev (your queries and any contained sensitive info will be transmitted to that service), be aware of rate limits and billing on Serper if you exceed free quotas, and supply the API key only to plugins you trust. Note the minor documentation mismatch: the registry did not list the required env var even though the code uses it — you'll need to provide the key for the tool to register and run.
Capability Analysis
Type: OpenClaw Skill
Name: serper-search
Version: 1.0.0
The OpenClaw AgentSkills skill bundle for Serper Google Search is benign. The `index.ts` file correctly implements the stated functionality, making network calls only to the legitimate `google.serper.dev` API endpoint using the provided API key and user query. There is no evidence of data exfiltration beyond the necessary API interaction, no malicious execution (e.g., `eval`, `exec`, `curl|bash`), no persistence mechanisms, and no prompt injection attempts against the AI agent in `SKILL.md`. All files align with the stated purpose of providing Google search results.
Capability Assessment
Purpose & Capability
Name, SKILL.md, manifest, and index.ts all implement a Serper.dev Google search integration. Minor inconsistency: the registry metadata lists no required env vars, but the SKILL.md and index.ts expect a SERPER_API_KEY (or plugin config.apiKey) for operation.
Instruction Scope
Runtime instructions and code are narrowly scoped to performing search requests to Serper.dev and returning structured results. There are no instructions to read unrelated files, access other credentials, or send data to unexpected endpoints.
Install Mechanism
There is no external download/install script; the package includes source and a normal package.json. The only dependency is @sinclair/typebox, which is reasonable for runtime parameter typing. SKILL.md mentions symlinking typebox from host node_modules, but package.json also lists it — a minor doc vs manifest mismatch, not an installation risk.
Credentials
The only secret the plugin uses is the Serper API key (SERPER_API_KEY) or the plugin config.apiKey, which is proportional to the stated purpose. However, the registry's 'required env vars' list is empty while the plugin actually requires/uses an API key to function; users should be aware they must supply that key.
Persistence & Privilege
The skill does not request permanent/always-on inclusion, does not modify other plugins or global agent settings, and has no elevated system privileges. It registers a single tool and only activates if an API key is present.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install serper-search - After installation, invoke the skill by name or use
/serper-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the Serper Google Search Plugin.
- Provides real Google Search and News results via the Serper.dev API.
- Supports web, news, and knowledge graph queries with links, snippets, facts, and "People Also Ask".
- Easy setup: Just add your Serper.dev API key to the configuration.
- Registers a simple tool with query, result count, and type (web/news) parameters.
- Returns structured JSON with relevant search information.
Metadata
Frequently Asked Questions
What is serper-search?
Fetches real Google search or news results with links, snippets, knowledge graph data, and related questions via the Serper.dev API. It is an AI Agent Skill for Claude Code / OpenClaw, with 2675 downloads so far.
How do I install serper-search?
Run "/install serper-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is serper-search free?
Yes, serper-search is completely free (open-source). You can download, install and use it at no cost.
Which platforms does serper-search support?
serper-search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created serper-search?
It is built and maintained by Samoppakiks (@samoppakiks); the current version is v1.0.0.
More Skills