mcpField
G
google-serper-search

google-serper-search

github.com/shuliuzhenhua-sys生产力0243 次安装32 周前更新
代码仓库

关于 google-serper-search

google-serper-search 是通过 Python 脚本调用 Serper API 并整理相关结果的技能。它支持多种搜索类别，以及地区、语言和时间筛选。

主要功能

  1. 01通过 Serper API 执行搜索
  2. 02搜索网页、新闻、图片、地图等
  3. 03按国家、语言和时间筛选
  4. 04以 JSON 返回结果

适用场景

  1. 01查找某主题的近期新闻
  2. 02搜索图片或地点
  3. 03将结果限定到特定国家或语言
  4. 04获取结构化结果用于摘要

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/shuliuzhenhua-sys/google-serper-search --skill google-serper-search

安装后在 Claude Code 中输入/google-serper-search确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
agents/
openai.yaml
references/
api_response.md
configuration.md
scripts/
serper_search.py

详细介绍

Google Serper 搜索

使用 scripts/serper_search.py 调用 Serper API 并返回 JSON 搜索结果。

检查配置

搜索前，确认 SERPER_API_KEY 可用。

运行：

printenv SERPER_API_KEY

如果变量为空，请阅读 references/configuration.md，并在继续操作前将其设置在当前 shell 或 shell 配置文件中。

执行搜索

使用：

python3 scripts/serper_search.py "query"

请求需要筛选条件时，请使用：

python3 scripts/serper_search.py "query" --type news --gl us --hl en --tbs "past week"

支持的 --type 值：

  • search
  • images
  • videos
  • places
  • maps
  • reviews
  • news
  • shopping
  • lens
  • scholar
  • patents
  • autocomplete

别名：

  • web -> search
  • image -> images
  • img -> images

支持的 --tbs 快捷选项：

  • past hour
  • past 24 hours
  • past week
  • past month
  • past year

当请求需要区域或语言特定的结果时，使用 --gl 指定国家/地区，使用 --hl 指定语言。

解读结果

需要了解结果架构时，请阅读 references/api_response.md。

对于网页和新闻结果，优先查看：

  • knowledgeGraph
  • organic
  • peopleAlsoAsk
  • relatedSearches

对于图片结果，优先查看：

  • 图片标题
  • imageUrl
  • thumbnailUrl
  • 尺寸
  • 来源页面

呈现答案

总结最相关的结果，而不是直接输出原始 JSON，除非用户要求提供原始响应。

在最终答案中包含来源链接。

如果脚本返回 error 字段，请明确指出配置缺失或 API 错误。

评论

支持 Markdown