Google Search Grounding 3_AI Agent skill-PHP中文网

Google Search Grounding 3

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

通过 Gemini 搜索落地（主）和 Custom Search JSON API（备）进行 Google 网页搜索。用途：(1) 附引用的综合回答（落地搜索），(2) 含摘要的原始链接结果，(3) 图片搜索。希伯来语支持极佳。优于内置 web_search (Perplexity)。

Google搜索QQGoogle网络搜索由双子座2.5 Flash提供搜索定位+自定义搜索API.QQ 这是PriMARI网络搜索工具.. . 优先超越内置的w

功能概述

Google搜索QQGoogle网络搜索由双子座2.5 Flash提供搜索定位+自定义搜索API.QQ 这是PriMARI网络搜索工具.. . 优先超越内置的w是一项面向实际任务的技能，主要用于GOOG.。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

Google 搜索 🔍

由 Gemini 2.5 Flash 驱动的 Google 网页搜索，支持 Search Grounding（搜索溯源）及 Custom Search API。

⭐ 这是主要的网页搜索工具，优先于内置的 web_search（Perplexity）。

前提要求

设置环境变量 GOOGLE_API_KEY
在 Google Cloud Console 中启用以下 API：Gemini API、Custom Search JSON API

配置项

环境变量	默认值	说明
`GOOGLE_API_KEY`	—	必需。 Google API 密钥
`GOOGLE_CSE_CX`	—	Custom Search Engine ID（仅在 raw/image 模式下必需）
`GOOGLE_SEARCH_LANG`	`he`	默认语言代码（如 he、en、ar、ja 等）
`GOOGLE_SEARCH_COUNTRY`	`IL`	默认国家/地区代码（如 IL、US、DE 等）

在 OpenClaw 配置中设置：

{
  "env": {
    "GOOGLE_API_KEY": "AIza...",
    "GOOGLE_SEARCH_LANG": "he",
    "GOOGLE_SEARCH_COUNTRY": "IL"
  }
}

脚本路径

python3 skills/google-search/lib/google_search.py  "query" [options]

输出模式

文本模式（默认）：适用于大多数场景。输出格式清晰易读，包含合成答案、信息来源及原始搜索查询。
JSON 模式（--json）：适用于程序化处理。返回内容包含置信度评分、溯源依据（grounding supports）及原始搜索查询。

运行模式

search — 带溯源的搜索（默认，推荐）

使用 Gemini 2.5 Flash + Google 搜索工具 → 生成带编号引用的综合答案。

python3 lib/google_search.py search "query" [--lang he] [--country IL] [--json]

适用场景：回答问题、追踪时事、“什么是 X” 类查询、希伯来语查询，或任何需要直接答案的场景。

示例：

# 希伯来语（默认）
python3 lib/google_search.py search "מזג אוויר תל אביב"

# 强制指定英语
python3 lib/google_search.py search "latest AI news" --lang en --country US

# 输出 JSON 格式
python3 lib/google_search.py search "OpenAI GPT-5 release date" --json

输出格式：

<合成答案文本>

Sources:
  1. Source Title
     https://example.com/article
  2. Another Source
     https://example.com/other

raw — 原始搜索结果

调用 Custom Search JSON API → 返回带标题与摘要片段的链接列表。

python3 lib/google_search.py raw "query" [-n 5] [--lang he] [--country IL] [--json]

适用场景：需要获取真实 URL、开展研究、构建参考文献列表，或仅需链接而无需答案时。

示例：

python3 lib/google_search.py raw "python asyncio tutorial" -n 5
python3 lib/google_search.py raw "best restaurants tel aviv" --json
python3 lib/google_search.py raw "rust vs go performance" -n 3 --lang en

输出格式：

1. Page Title
   https://example.com/page
   Brief snippet from the page...

2. Another Page
   https://example.com/other
   Another snippet...

image — 图像搜索

调用 Custom Search 图像搜索功能 → 返回带标题的图像 URL 列表。

python3 lib/google_search.py image "query" [-n 5] [--lang he] [--country IL] [--json]

适用场景：查找图片、视觉参考资料、缩略图等。

示例：

python3 lib/google_search.py image "aurora borealis" -n 5
python3 lib/google_search.py image "תל אביב חוף" --json

选项参考

选项	适用模式	说明	默认值
`--lang CODE`	全部	语言代码（如 he、en、ar、ja…）	环境变量 `GOOGLE_SEARCH_LANG`（he）
`--country CODE`	全部	国家/地区代码（如 IL、US、DE…）	环境变量 `GOOGLE_SEARCH_COUNTRY`（IL）
`-n NUM`	raw、image	返回结果数量（取值范围：1–10）	10
`--json`	全部	以结构化 JSON 格式输出	关闭

语言参数解析顺序： --lang 命令行参数 → GOOGLE_SEARCH_LANG 环境变量 → 未设置（自动检测）
国家/地区参数解析顺序： --country 命令行参数 → GOOGLE_SEARCH_COUNTRY 环境变量 → 未设置（自动检测）

错误处理

缺少 API 密钥： 显示清晰错误信息，并附带配置说明。
429 请求频率超限： 自动等待 5 秒后重试一次。
网络错误： 返回带有具体原因的描述性错误信息。
无搜索结果： 清晰提示 “No results found.”
请求超时： 所有 HTTP 请求均设为 30 秒超时。

配额与速率限制

API	免费额度	速率限制
Gemini API（带溯源的搜索）	提供较 generous 的免费额度	约 15 RPM（免费），付费计划支持更高并发
Custom Search JSON API（raw/image 模式）	每日 100 次查询	付费计划最高支持每日 10,000 次查询

遇到 429 错误时： 脚本将自动重试一次；若配额已完全耗尽，则自动回退至内置 web_search（Perplexity）。

多语言支持

支持任意语言的查询输入。希伯来语为默认语言：

# 希伯来语（默认，无需额外参数）
python3 lib/google_search.py search "חדשות טכנולוגיה"

# 英语
python3 lib/google_search.py search "technology news" --lang en

# 阿拉伯语
python3 lib/google_search.py search "أخبار التكنولوجيا" --lang ar