Linkup JS SDK 搜索与获取

要解决的问题

让 Agent 直接调用搜索 API 时，通常会踩两类坑：一是标准检索和深度检索的参数与返回结构不一致，适配代码要反复重写；二是搜索结果里的 URL 指向原始 HTML，导航栏、广告、脚本等噪声混在其中，下游推理很难直接消费。这个技能把 Linkup API 封装成一个仍在维护的 JS SDK 客户端，把这两件事统一收口。

技能如何工作

核心能力分两块：

• Sourced 网络搜索：通过 Linkup 客户端发起标准搜索与深度搜索（deep search）。前者适合快速拿摘要，后者面向需要多步检索的复杂问题。
• 干净内容获取：对结果中的 URL 执行 fetch 操作，SDK 可返回渲染后的页面内容并做清洗，方便直接喂给下游推理。

大致流程是：构造查询 → 指定搜索模式 → 拿到结构化结果 → 对候选链接发起抓取 → 得到清洗后的正文。调用方不必关心渲染和解析的细节。

适用边界与注意点

• 抓取质量取决于目标页面的渲染情况，动态加载严重或反爬严格的站点可能返回不完整内容。
• 深度搜索的响应时间通常长于标准搜索，不适合对延迟敏感的链路。
• 清洗后的正文保留主干信息，但不保证表格、图表等非文本结构完整。