Serper网页搜索

技能简介

Serper通过Google Serper API执行搜索，并自动抓取结果页面的完整正文内容。单次调用返回多条结果的全文数据，无需额外使用其他网页抓取工具。

能做什么

• 获取Google搜索结果及对应网页的完整正文
• 并行抓取多个页面，单页超时3秒
• 支持通用搜索与新闻/时事两种模式
• 按语言和地区过滤搜索结果
• 流式输出，逐条返回处理完成的结果

使用说明

安装指令：需配置Python环境，安装依赖包（trafilatura等），并将Serper API key写入.env文件。

基础调用：

python3 scripts/search.py -q "搜索关键词" [--mode MODE] [--gl 国家代码] [--hl 语言代码]

参数说明：

• -q：搜索查询语句（必填）
• --mode：default（通用，5条结果）或 current（近一周+新闻，各3条）
• --gl/--hl：国家与语言代码，非英语查询必须指定

示例：

# 英文通用搜索
python3 scripts/search.py -q "how does HTTPS work"

# 英文时事搜索
python3 scripts/search.py -q "OpenAI latest announcements" --mode current

# 德语搜索（必须指定区域参数）
python3 scripts/search.py -q "Klimapolitik Deutschland" --gl de --hl de

关键约束：单次精心构造的查询通常已足够，同一主题避免多次调用；禁止对返回的URL再次使用其他网页抓取工具。

输入与输出

见下方输入与输出表格。

风险提示

• API调用消耗额度，需妥善保管密钥
• 3秒超时可能导致部分页面内容缺失
• 非英语查询未设置gl/hl参数将返回错误结果
• 频繁调用或触发速率限制
• 抓取内容受原网站版权约束

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/nesdeq/serper/SKILL.md
来源类型：开源技能仓库