← 返回 Skills 市场

Google Serper Search

Name: Google Serper Search
Author: twodogegg

作者 twodogegg · GitHub ↗ · v0.1.1 · MIT-0

cross-platform ⚠ suspicious

665

总下载

当前安装

版本数

在 OpenClaw 中安装

/install 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",...

使用说明 (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 topic
organic: Search results with title, link, and snippet
peopleAlsoAsk: Related questions
relatedSearches: 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.

安全使用建议

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).

功能分析

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.

能力评估

ℹ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install google-serper-search
安装完成后，直接呼叫该 Skill 的名称或使用 /google-serper-search 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug google-serper-search

版本 0.1.1

许可证 MIT-0

累计安装 6

当前安装数 6

历史版本数 2

常见问题