← Back to Skills Marketplace
665
Downloads
0
Stars
6
Active Installs
2
Versions
Install in OpenClaw
/install google-serper-search
Description
This skill should be used when the user asks to "search the web", "search for information", "find information online", "search Google", "search for images",...
README (SKILL.md)
Google Serper Search
This skill enables you to search the web and find images using the Serper API.
When to Use This Skill
Use this skill when the user:
- Asks to search for information online
- Needs current/recent information not in your knowledge base
- Requests to find images or pictures
- Wants to verify facts or get latest updates
- Asks questions that require web search
How to Use
Advanced Search
You can now use advanced parameters to filter results.
python3 scripts/serper_search.py "query" --type news --gl us --hl en --tbs "past week"
Parameters:
- Type (
--type): search, images, videos, places, maps, reviews, news, shopping, lens, scholar, patents, autocomplete. - Country (
--gl): 2-letter country code (e.g.,us,cn,jp,gb). - Language (
--hl): Google language code (e.g.,en,zh-cn,zh-tw,ja). - Date range (
--tbs):past hour,past 24 hours,past week,past month,past year.
The script returns JSON with:
knowledgeGraph: Key facts about the topicorganic: Search results with title, link, and snippetpeopleAlsoAsk: Related questionsrelatedSearches: Related search terms
Image Search
When the user needs images, run:
python3 scripts/serper_search.py "search query" --type images
Returns JSON with image URLs, thumbnails, dimensions, and sources.
Response Format
After getting search results:
- Parse the JSON response
- Present results in a clear, organized format
- Include relevant links and sources
- For images, describe what was found and provide image URLs
Example Usage
User: "Search for the latest news about AI" You: Use Bash tool to run the search script, then format and present the results.
User: "Find pictures of mountains" You: Use Bash tool to run image search, then present the image URLs and descriptions.
Usage Guidance
Before installing or enabling this skill: 1) Be aware the included script requires an API key (SERPER_API_KEY) and will send it to https://google.serper.dev — only use a key you trust to be used this way. 2) The skill's registry metadata does not declare this required env var or primary credential; ask the publisher to correct the metadata (primaryEnv should be SERPER_API_KEY). 3) Running the script via the Bash tool exposes the environment to the subprocess and may cause the API key to appear in logs or outputs; avoid using high-privilege or shared keys if you enable it. 4) Confirm you trust the Serper service and that its terms/privacy are acceptable. 5) If you want stronger assurance, request that the publisher provide an updated manifest that explicitly lists SERPER_API_KEY as required and documents data handling (what is sent to the API and what the skill stores or returns).
Capability Analysis
Type: OpenClaw Skill
Name: google-serper-search
Version: 0.1.1
The skill is a legitimate integration for the Serper API, allowing the agent to perform web and image searches. The core logic in `scripts/serper_search.py` uses standard Python libraries to communicate exclusively with the official `google.serper.dev` endpoints and handles the user-provided API key via environment variables. No evidence of data exfiltration, malicious prompt injection, or unauthorized system modification was found.
Capability Assessment
Purpose & Capability
The name, README, SKILL.md, and script all align: the skill calls the Serper API to perform web and image searches. However, the declared registry metadata lists no required environment variables or primary credential, while the code and README clearly expect a SERPER_API_KEY environment variable. That omission is inconsistent and should have been declared as the primary credential.
Instruction Scope
SKILL.md instructs the agent to run the included Python script via the Bash tool and to parse/format JSON results. The instructions do not ask the agent to read unrelated files or system secrets. The only runtime data required by the script is the SERPER_API_KEY environment variable, which SKILL.md/README mention, though SKILL.md could be clearer about needing that env var when run via the Bash tool.
Install Mechanism
This is an instruction-only skill with no install spec; it includes a small Python script that performs HTTP POST requests. No installers, downloads from unknown servers, or archive extraction are present. Risk from installation is low.
Credentials
The script requires a SERPER_API_KEY (sent in the X-API-KEY header to https://google.serper.dev). The registry metadata did not declare this required env var or a primary credential. That mismatch reduces transparency and could lead to accidental exposure of an API key (e.g., if the agent logs command output). No other unrelated credentials are requested.
Persistence & Privilege
The skill does not request always:true and does not modify system or other skills' configs. It has normal invocation privileges (agent may call it autonomously), which is expected for a search skill.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install google-serper-search - After installation, invoke the skill by name or use
/google-serper-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
- Added a README.md file with detailed usage instructions, parameters, response format, and example use cases.
- No changes to core code or functionality.
- Documentation now helps users understand advanced search and image capabilities.
v0.1.0
Initial release of the google-serper-search skill.
- Enables web and image search via the Serper API.
- Supports advanced search parameters (type, country, language, date range).
- Returns structured data (search results, knowledge graph, related questions, related searches).
- Provides clear guidance for presenting image and text search results to users.
- Includes usage examples and detailed parameter descriptions.
Metadata
Frequently Asked Questions
What is Google Serper Search?
This skill should be used when the user asks to "search the web", "search for information", "find information online", "search Google", "search for images",... It is an AI Agent Skill for Claude Code / OpenClaw, with 665 downloads so far.
How do I install Google Serper Search?
Run "/install google-serper-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Google Serper Search free?
Yes, Google Serper Search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Google Serper Search support?
Google Serper Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Google Serper Search?
It is built and maintained by twodogegg (@twodogegg); the current version is v0.1.1.
More Skills