技能介绍

要解决什么问题

做行业调研、竞品扫描或写报告时，你往往需要先拿到公开网页上的候选来源：谁在做同类产品、目录站里有哪些条目、某次发布被哪些页面引用。手工在浏览器里翻搜索结果既慢，也不方便把「一组排序后的 URL + 摘要」交给后续的抽取或引用流程。

技能如何工作

本技能通过 Vernclaw 的托管检索栈，由 vernclaw-cli 在开放互联网上执行查询。调用时需传入必填参数 --query；可选 --limit 在提供方支持时限制返回条数。执行模式为同步：invoke 默认向 stdout 输出紧凑 JSON，自动化场景应先解析数值型 status，再读 data；终端人工查看可用 --pretty，但不适合脚本解析。

归一化后的 data 通常包含：

Results returned：结果数量
Top title / Top URL：最高排名结果的标题与链接
Items：各行结果的 title、URL，以及在可用时的 snippet

典型流程是：先用本技能收集排序 URL，若需要可读正文，再对接 extract.url 等后续能力。

边界与注意

结果非个性化，多次运行可能略有差异；默认条数由提供方管理，大量结果可能被截断。使用前需完成 CLI 认证（交互式 vernclaw-cli login，或无头环境用 API Key）。CLI 会在常规 connector 输出中省略 provider 原始 payload，不要假设能拿到未归一化的原始响应。

截图预览

使用场景

撰写行业或市场扫描报告前，用 `--query` 拉取公开网页的排序结果与摘要，再决定哪些 URL 进入引用或抽取流程
做竞品盘点时需要快速发现对手官网、目录站条目与上线报道链接，先汇总成带 snippet 的结果列表
自动化 Agent 在调用 `extract.url` 读正文之前，先同步搜索拿到若干候选链接并校验最高排名的 title/URL
整理对外资料或脚注时，需要一批可核查的公开来源链接，而不是在浏览器里手工复制搜索结果

适合人员

负责输出竞品与市场简报的产品经理，需要先把公开页面链接与摘要收齐再写结论
写研究报告或内部分析稿的分析师，习惯用 CLI JSON 输出把搜索结果接进后续脚本或文档流程
在 CI 或无头环境里编排检索步骤的工程师，需先 `vernclaw-cli login --api-key` 再按 query 批量取 ranked items
维护引用规范的内容编辑，要在成稿前核对「Top URL」与 items 列表里每条来源是否可公开访问