SuperAPI AI 工具集

google-search

通用与其它

查看项目

更新于 10-16 10:22

技能介绍

用途:通过真实 Chrome 实例(chromux)执行 Google 搜索,可选提取页面完整内容。相比 WebSearch,它呈现与真人一致的搜索结果,支持 JavaScript 渲染,且不易被识别为机器人。适用场景包括:用户要求搜索 Google 或网络、需要用 site: 限定域名、需要按时间过滤(日/周/月/年)、需要正文与评论而非仅摘要,以及 WebSearch 结果不佳时。

运行环境:在 Claude Code 中使用自带 chromux 搜索脚本,chromux 不可用时回退到 WebSearch;在 Codex 中使用 Bash 优先的 chromux 操作,脚本路径为 Hoyeon 插件根目录下的 skills/google-search/vendor/web-search.mjs。

前置条件:需安装 chromux CLI,使用前先启动无头 Chrome:chromux launch default --headless 2>/dev/null || true。

用法:node ${baseDir}/vendor/web-search.mjs "<query>" [options]。选项:--site <domain> 添加站点过滤;--time <d|w|m|y> 时间过滤;--count <N> 最大结果数(默认 10);--no-enrich 跳过页面访问仅返回 Google 摘要(更快);--comments <N> 每页最大评论数(默认 5);--body <N> 每页最大正文字符数(默认 500);--json 输出原始 JSON;--check 验证 chromux 是否可用。

输出:文本模式默认输出标题、URL、作者、标签、正文与评论;--json 模式返回对象数组,包含 title、url、snippet、author、tags、body、comments,其中 author、tags、body、comments 仅在启用 enrichment 时存在。enrichment 对 Dev.to 和 Lobsters 使用站点专用 JS 提取器,其他站点用通用回退。

性能:--no-enrich 约 3-5 秒;启用 enrichment 每个结果页约 2-3 秒,10 条结果约 25-35 秒,仅需 URL 与摘要时建议用 --no-enrich。

限制:需安装 chromux;遇到 Google CAPTCHA 返回 0 结果需稍后重试;enrichment 时页面加载超时会跳过该 URL;无结果时返回空;chromux 不可用时回退到内置 WebSearch。