功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。

谷歌搜索工具（免费版）

概述

谷歌搜索工具免费版是一款基于 Google Custom Search Engine (CSE) 的联网搜索工具。通过 Google 官方 API 获取实时、权威的搜索结果，适合需要高质量信息检索的个人用户。仅需配置 Google API Key 和搜索引擎 ID，即可开始使用。

核心能力

已知限制

执行已知限制操作,使用input_params参数进行配置,支持创建/查询/导出等操作。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

每日搜索配额限制（Google

每日搜索配额限制（Google API 免费额度）

输出: 返回每日搜索配额限制（Google的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

单次查询最多返回 10 条结果

单次查询最多返回 10 条结果

输出: 返回单次查询最多返回 10 条结果的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

不支持批量查询和结果导出

不支持批量查询和结果导出

输出: 返回不支持批量查询和结果导出的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

不支持自定义站点限定搜索

不支持自定义站点限定搜索

输出: 返回不支持自定义站点限定搜索的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

不支持搜索历史保存

不支持搜索历史保存

输出: 返回不支持搜索历史保存的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

输出: 返回已知限制的执行结果,包含操作状态和输出数据。 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：Custom、Search、Engine、的联网搜索工具、支持实时信息检索、与结果结构化输出、适合个人研究与学、习使用、核心能力、进行精准搜索、返回结构化的搜索、包含标题、支持中英文关键词、简单的、Key、配置流程等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：学术资料检索

学生或研究人员查找特定主题的学术资料。

# 搜索学术论文相关内容
python3 scripts/search.py "transformer attention mechanism survey 2026"

预期输出包含相关论文、研究博客和学术资源的链接与摘要。

场景二：技术文档查找

开发者查找特定技术的官方文档和教程。

# 搜索技术文档
py "Docker compose networking best practices"

返回官方文档、技术博客和社区讨论的链接，帮助快速定位权威资料。

场景三：实时信息获取

用户需要获取最新的新闻或动态信息。

# 搜索最新动态
py "2026年 人工智能 最新进展"

不适用场景

以下场景谷歌搜索工具不适合处理：

• 黑帽SEO手段
• 搜索引擎作弊
• 付费广告投放管理

触发条件

需要SEO优化、关键词分析、排名提升、搜索流量优化时使用。不适用于非本工具能力范围的需求。

快速开始

配置 API 凭证

1. 创建 Google Cloud 项目：

   • 访问 Google Cloud Console
   • 创建新项目并启用 Custom Search API

2. 获取 API Key：

   • 在 API 凭证页面创建 API Key
   • 保存 Key 值备用

3. 创建搜索引擎 ID (CX)：

   • 访问 Programmable Search Engine 配置页面
   • 创建新的搜索引擎，获取 CX ID

4. 配置环境变量：

# 创建 .env 文件
cat > .env <<EOF
GOOGLE_API_KEY=your_api_key_here
GOOGLE_CSE_ID=your_cx_id_here
EOF

# 或直接设置环境变量
export GOOGLE_API_KEY=your_api_key_here
export GOOGLE_CSE_ID=your_cx_id_here

执行首次搜索

# 基础搜索

# 指定返回结果数量
py "machine learning" --max 5

验证配置

# 本技能的核心实现逻辑
# 请参考上方使用说明进行配置和调用
echo "implementation_ready"

示例

基础搜索配置

# 使用环境变量

# 直接传入凭证（不推荐，用于测试）
GOOGLE_API_KEY=未指定 GOOGLE_CSE_ID=yyy \

参数说明

优选实践

搜索关键词优化

API 配额管理

# 本技能的核心实现逻辑
# 请参考上方使用说明进行配置和调用
echo "implementation_ready"

结果筛选建议

1. 优先查看前 3 条：Google 排序通常最相关
2. 查看摘要：摘要包含关键词上下文
3. 验证来源：优先选择官方域名
4. 时效性：注意结果的发布时间

常见问题

API Key 无效

# 检查环境变量
echo $GOOGLE_API_KEY
echo $GOOGLE_CSE_ID

# 验证 Key 格式

可能原因：

• Key 未启用 Custom Search API
• Key 已过期或被撤销
• 环境变量未正确设置

搜索返回空结果

# 检查搜索引擎配置
# 确认 CSE 配置为搜索全网（而非限定站点）

# 尝试英文关键词
py "english keywords"

# 检查配额是否用尽

API 配额用尽

Google Custom Search API 免费额度：
- 每日 100 次查询
- 每次查询最多 10 条结果
- 超出需付费使用

建议：
- 优化查询，减少无效搜索
- 缓存常用结果
- 错峰使用（UTC 时间每日 0 点重置）

网络连接问题

# 测试 Google API 连通性
curl -I https://www.googleapis.com

# 使用代理（如需要）
export HTTPS_PROXY=http://proxy:port

依赖说明

运行环境

• Agent 平台：支持 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
• 操作系统：Windows / macOS / Linux
• Python 版本：3.7 及以上
• 网络环境：需可访问 Google API 服务

依赖详情

API Key 配置

# 必需的 API Key
GOOGLE_API_KEY=your_api_key_here      # Google API 密钥
GOOGLE_CSE_ID=your_cx_id_here         # 自定义搜索引擎 ID

# 获取方式：
# 1. 访问 Google Cloud Console
# 2. 创建项目并启用 Custom Search API
# 3. 创建 API Key
# 4. 访问 cse.google.com 创建搜索引擎
# 5. 获取搜索引擎 ID (CX)

可用性分类

• 分类：MD+EXEC（纯 Markdown 指令，部分功能需要 exec 命令行执行能力）
• 说明：基于 Markdown 的 AI Skill，通过自然语言指令驱动 Agent 执行任务
• 适用人群：个人研究者、学生、开发者
• 升级建议：如需批量搜索、结果导出、自定义站点搜索等高级功能，请使用 PRO 版本

错误处理

安全注意事项

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。

效率量化分析

差异化对比

核心功能

• 自动化执行: 基于指令驱动的自动化流程
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据