技能使用指南

web-search-api（Web搜索API（免费）—SearXNGSkill）Skill 是什么？如何安装使用？

web-search-api 技能基于免费的 SearXNG 公共实例，为 AI 代理提供无 API 密钥、无速率限制、隐私优先的网页搜索能力，聚合 Google、Bing、DuckDuckGo 等 70 多个来源，支持新闻、科学、IT 等类别过滤与多实例自动轮换。本文详解安装启用步骤、调用示例、竞品对比与成本节省测算，帮助开发者零成本搭建稳定的联网搜索链路。立即阅读，让 AI 代理免费上网。

Web搜索API（免费）—SearXNGSkillweb-search-api
11 个章节 约 18 分钟阅读 AI 智能生成

Web搜索API（免费）—SearXNGSkill：零成本、无速率限制、隐私优先的 AI 搜索能力

核心结论速览：

  • 完全免费：无需 API Key、无需计费账号、无速率限制，AI 代理可以放心高频调用搜索。
  • 多引擎聚合：一次请求即可汇总 Google、Bing、DuckDuckGo 等 70 多个来源的结果，覆盖面优于单一引擎。
  • 隐私优先：查询过程匿名、无用户跟踪，适合对数据合规敏感的业务。
  • 抗故障设计：技能内置实例自动发现、探活探测、多实例轮换与 30 分钟缓存机制，单个实例挂掉不影响整体可用性。
  • 成本可量化：相比按次计费的商业搜索 API，每月上万次查询可实现明显的年度成本节省。

1. 该技能叫什么？如何下载安装 AI 技能提升开发效率？

基本信息

项目 内容
技能中文名 Web搜索API（免费）—SearXNGSkill
技能英文名 web-search-api
技能 ID 13101
技术底座 SearXNG（开源的元搜索引擎）公共实例
核心能力 面向 AI 代理的免费、无速率限制、隐私优先的网页搜索 API

它解决什么问题

开发 AI 代理时，「让模型联网查资料」往往是最容易被卡住的一环：

  • 商业搜索 API 按次计费，代理一旦进入批量循环，账单会迅速膨胀；
  • 官方 API 需要申请密钥、绑定支付方式、配置配额，接入链路长；
  • 免费方案大多没有官方接口，稳定性无法保证；
  • 用户查询内容被搜索服务商记录，存在隐私与合规风险。

该技能把 SearXNG 的公共实例封装成一套「开箱即用」的搜索调用方案：直接向实例的 /search 接口发请求、拿回 JSON 格式结果，同时附带实例发现、探测、轮换、缓存与故障回退的完整实践，让 AI 代理在不花钱的前提下拥有稳定的联网搜索能力。

安装思路与步骤

「一键安装 AI 技能」的核心逻辑，是把搜索能力以技能的形式挂载到 AI 代理上，代理在需要联网时自动调用，而不是由人手动去复制粘贴搜索结果。具体操作大致分三步：

第一步：确认安装前提

  • 运行环境可正常访问公网，且能访问公共 SearXNG 实例与 searx.space 实例状态页；
  • 若使用技能文档中的代码示例，建议具备支持 fetch 的运行时（如 Node.js 18 及以上）；
  • 明确自己的使用目标是「通用网页搜索」还是「新闻/科学/IT 等垂直类别搜索」，便于后续配置默认参数。

第二步：通过技能入口安装启用

  • 在所用 AI 代理客户端或技能市场的技能列表中，按技能英文名 web-search-api 或技能 ID 13101 检索并添加该技能；
  • 添加后将技能启用（部分客户端需要重启会话或新建对话才会生效）；
  • 具体的安装命令、市场地址、账号要求与版本信息，以官方说明为准，本文不虚构具体命令。

第三步：验证是否生效

启用后，向代理提一个明确需要联网的问题（例如「帮我查一下最近一周的开源 AI 代理相关新闻」），然后从两个角度验证：

  1. 看返回结构：正确的结果通常包含标题（title）、链接（url）、摘要（content）以及来源引擎（engine）字段；
  2. 看是否附来源：能给出可点击的真实链接和多来源信息，说明搜索链路已打通。

如果客户端支持直接执行命令，也可以先用一条独立的网络请求确认实例连通性，这是文档中给出的真实调用形式：

curl -s "https://searx.party/search?q=开源AI代理&format=json" | jq '.results[] | {title, url, content}'

能正常返回结果数组，说明网络侧与实例侧都没问题，此时若技能仍无结果，问题通常出在技能配置或代理调用环节。

2. 该技能的主要功能和特点

  • 零成本接入：无 API 密钥、无计费账号、无查询配额，Agent 可以按需调用而不必担心账单。
  • 无速率限制（约定式）：官方不设硬性配额限制，但要保持礼貌使用，文档建议单实例控制在约 100 次请求/分钟以内。
  • 多引擎聚合：SearXNG 作为元搜索层，聚合 Google、Bing、DuckDuckGo 以及 70 多个来源的结果，减少单一引擎遗漏。
  • 隐私保护：查询过程匿名、无跟踪，不建立用户画像，适合对搜索内容敏感的行业场景。
  • 类别化搜索：支持 general（综合网页）、news（新闻）、images（图片）、videos（视频）、music（音乐）、files（文件）、it（技术资源）、science（科学论文）、social media（社交网络）等类别过滤，结果相关性显著提升。
  • 高级查询参数：可指定语言（language）、时间范围（time_range：日/周/月/年）、安全搜索等级（safesearch：关闭/适中/严格）、指定引擎（engines，如仅用 google、bing）。
  • 实例自动发现与轮换：可从 searx.space 的实例数据中筛选高可用实例，并通过探测请求验证哪些实例真正可用。
  • 工作实例缓存：探测结果缓存 30 分钟后复用，只有出现错误才重新探测刷新，避免每次搜索都做无谓探测。
  • 失败重试与回退：内置最多 7 次重试的轮换逻辑，当实例返回空结果或异常时自动切换，直到拿到有效结果。
  • AI 代理友好：文档直接提供了写给代理的「系统提示」模板，代理可以据此自行选择实例、构造请求、处理缓存与回退。

和普通工具相比强在哪？ 一般的「搜索插件」要么绑定付费 API，要么只对接单一引擎且缺少故障处理。该技能的价值不只是「能搜」，而是「免费 + 多来源 + 有缓存 + 有回退」这一整套工程化组合，恰好补上了 AI 代理联网时最缺的稳定性。

3. 如何使用该技能？

以下步骤覆盖从最简调用到工程化封装的完整路径，示例取自技能文档并做了场景化说明。

步骤 1：获取可用的 SearXNG 实例

先从公开的实例状态数据中筛选可用实例，按等级与网络隐私属性过滤：

curl -s "https://searx.space/data/instances.json" | jq -r '.instances | to_entries[] | select(.value.http.grade == "A" or .value.http.grade == "A+") | select(.value.network.asn_privacy == 1) | .key' | head -10

也可以直接使用文档给出的推荐实例，如 searx.party（主用）、searx.tiekoetter.com、searx.ninja（备用）。

步骤 2：发起一次基本搜索

最小可用请求只需要三个要素：实例地址、查询词、format=json。

INSTANCE="https://searx.party"
QUERY="开源AI代理"
curl -s "${INSTANCE}/search?q=${QUERY}&format=json" | jq '.results[] | {title, url, content}'

步骤 3：在代码里封装搜索函数

把请求封装成函数，统一做参数拼装与结果裁剪，返回只要标题、链接、摘要和来源引擎：

async function searxSearch(query, instance = 'https://searx.party') {
  const params = new URLSearchParams({
    q: query,
    format: 'json',
    language: 'en',
    safesearch: 0
  });
  const res = await fetch(`${instance}/search?${params}`);
  const data = await res.json();
  return data.results.map(r => ({
    title: r.title,
    url: r.url,
    content: r.content,
    engine: r.engine
  }));
}

调用 searxSearch('加密货币价格') 后取前 5 条即可交给模型总结。

步骤 4：加上多实例轮换与缓存（推荐用于生产）

文档给出的完整方案包含三个关键环节：

  1. 探测：用固定探测查询（如 besoeasy）逐个测试实例，8 秒超时，返回结果数组即视为可用；
  2. 缓存：把可用实例列表缓存 30 分钟，减少无效探测；
  3. 轮换重试：最多 7 次重试，中途在关键节点（第 1 次与第 4 次附近）刷新实例缓存。

上层只需调用 searxMultiSearch(query)，即可拿到「实际使用的实例 + 结果列表」。

步骤 5：按类别精准搜索

需要新闻或论文时，追加 categories 参数即可：

curl -s "https://searx.party/search?q=bitcoin&format=json&categories=news" | jq '.results[].title'
curl -s "https://searx.party/search?q=machine+learning&format=json&categories=science" | jq '.results[].url'

步骤 6：使用高级参数精细控制

典型组合场景：查「最近一周的 AI 新闻，只要 Google 和 Bing 的结果」。

searxAdvancedSearch({
  query: 'AI新闻',
  timeRange: 'week',
  categories: 'news',
  engines: 'google,bing'
}).then(data => console.log(data.results));

输出说明：核心字段为 title（标题）、url（链接）、content（摘要）、engine（来源引擎）。建议在交给模型前做两件事：限制返回条数（如 5-10 条）、对结果按 1-24 小时缓存，避免重复查询。

上手路径建议：先让代理用「单实例 + 类目过滤」跑通闭环，再逐步补上多实例发现、缓存与超时控制；文档也建议给搜索请求设置 5-10 秒超时，并优先选择中位响应时间低于 1.5 秒的实例。

4. 同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
本技能（web-search-api / SearXNG） 面向 AI 代理的免费隐私搜索方案 多引擎聚合 70+ 来源、类别过滤、语言/时间范围/引擎指定、多实例轮换与缓存 低：无需密钥，添加技能即可调用；稳定性依赖公共实例质量 AI 代理联网检索、批量搜索、隐私敏感业务 优势：零成本、无配额、匿名、抗单点故障；不足：公共实例响应速度与可用性会波动，个别实例可能关闭 JSON 输出
Google 自定义搜索 API 商业搜索 API 结果质量高、生态成熟、文档完善 中：需申请密钥与计费账号，按次计费（文档参考价约 5 美元/1000 次查询） 对结果质量要求极高、预算充足的产品 优势：结果权威稳定；不足：成本随调用量线性增长，存在跟踪，大规模代理场景不经济
Bing 搜索 API 商业搜索 API 网页、图片、新闻等多类接口 中：需订阅与密钥，费率随套餐变化（文档参考价约 3-7 美元/1000 次查询） 企业级搜索集成、需要商业 SLA 的场景 优势：接口规范、可用性承诺；不足：需要付费与配额管理，隐私层面存在跟踪
DuckDuckGo API 免费隐私搜索 隐私保护、可直接查询 低：无需密钥，但非官方接口，稳定性不足 轻量、低频的搜索需求 优势：免费、隐私友好；不足：无官方 API 承诺、易不稳定，不适合作为生产级基础设施

选型建议：追求零成本与隐私、且能接受一定工程封装（缓存 + 轮换 + 超时）的 AI 代理项目，优先选本技能；若业务对搜索结果的法律责任、SLA 与结果一致性有硬性要求，再考虑商业 API 作为主链路，把 SearXNG 作为降级备用通道。

5. 该技能的典型应用场景与实际体验情况

场景一：AI 代理的日常联网研究（开发者/研究者视角）

痛点是代理在做行业调研、竞品分析时需要频繁联网，用商业 API 成本不可控。使用方式是让代理在技能提示中固定「优先使用 SearXNG」，遇到空结果自动换实例。实际体验：查询响应通常在数秒内完成，多引擎聚合后信息面更全，摘要字段足以支撑模型做初步归纳；需要注意的是开头几天要观察哪些实例在你的网络环境下稳定，建议先跑一轮探活再固定 3-5 个实例。

场景二：新媒体与内容运营的选题监控

痛点是运营需要持续追踪某话题的最新动态，人工刷网页效率低。使用方式是用 categories=news 加上 time_range=week 或 day，定时拉取结果并汇总。实际体验：新闻类目过滤后噪声明显减少，时效性参数对「只看最近一周」的需求非常贴合；注意事项是个别实例的新闻来源覆盖不同，建议同时保留 2 个以上实例以交叉验证。

场景三：技术选型与学术资料检索

痛点是工程师找技术文档、研究者找论文时，通用搜索容易混入营销内容。使用方式是用 categories=it 检索技术资源、categories=science 检索科学论文，再用 engines 限定来源。实际体验：类别过滤对结果质量的提升非常直观，能明显减少无关页面；注意部分垂直类别的结果数量少于综合搜索，可能需要换关键词或放宽时间范围。

场景四：数据管道中的批量检索

痛点是批量抓取前的链接发现环节需要大量搜索请求，付费方案成本高。使用方式是按文档最佳实践做三层保障：结果缓存 1-24 小时、实例轮换 3-5 个、单实例控制在约 100 次请求/分钟并加 1-2 秒间隔。实际体验：加入缓存后重复查询几乎为零，整体吞吐显著提升；注意必须做好超时与异常捕获，公共实例偶发返回空结果属于正常现象，重试即可恢复。

整体上手评价：安装与调用门槛低，掌握一个 GET 请求就能跑通；难点不在「搜」，而在「稳」，即实例健康监控、超时设置与缓存策略这三件事。文档已把这些工程细节全部写明并给出可运行代码，按图施工基本可以跳过踩坑阶段。

6. 该技能能为用户带来的价值

1. 成本从「按次计费」变成「接近于零」

按技能文档给出的测算口径：以 AI 代理每月执行 10,000 次搜索为例，Google 自定义搜索约 50 美元/月，Bing 搜索 API 约 30-70 美元/月，而 SearXNG 方案为 0 美元；折算到年度，节省区间约为 360-840 美元。若代理规模达到每月 10 万次查询，年度节省可达 3,000-8,000 美元。

2. 把「能不能联网」的门槛降到最低

不需要注册账号、不需要信用卡、不需要审批配额，添加技能即可开始搜索。对个人开发者、学生团队和做原型验证的项目来说，这是从「想做」到「能做」的关键一步。

3. 降低合规与隐私风险

匿名查询、不建立用户画像，对金融、医疗、法律等对查询内容敏感的行业尤为友好，减少了「用户搜索行为被第三方记录」带来的合规负担。

4. 提升代理输出的可信度

多引擎聚合让结果来源更多元，返回中带有 engine 字段可直接标注来源；配合标题、链接、摘要三段式结构，模型更容易给出可核验的答案，降低幻觉风险。

5. 长期可维护的架构价值

实例发现、探活、轮换、缓存、重试这一整套模式具有通用性。把它沉淀到自己的 Agent 基础设施里后，未来无论切换到任何搜索提供方，这套容错框架都能直接复用。

7. 常见问题 FAQ

Q1：这个技能怎么安装？需要写代码吗？

在 AI 代理客户端或技能市场中按英文名 web-search-api 或技能 ID 13101 添加并启用即可，具体入口与命令以官方说明为准。基本使用（发请求、读结果）不需要写代码，用命令行或代理直接调用就行；如果要长期稳定运行，建议参考技能文档中的 Node.js 示例补上多实例轮换与缓存。

Q2：真的完全免费吗？会不会有隐藏收费或调用次数限制？

按技能文档说明，它基于 SearXNG 的公共实例，无需 API 密钥、无计费、无硬性速率限制。但需要注意两点：一是要「礼貌使用」，文档建议单实例控制在约 100 次请求/分钟以内，并在请求间加 1-2 秒延迟；二是公共实例由社区维护，可用性会波动，这不是收费问题，而是需要靠轮换和缓存来兜底。

Q3：搜索结果和 Google 官方 API 相比准不准？

它不是自建搜索引擎，而是通过 SearXNG 聚合 Google、Bing、DuckDuckGo 等 70 多个来源的结果，因此覆盖面和多样性通常更好，通过 engines 参数还可以指定只取 Google 或 Bing 的结果。需要注意的是不同实例启用的引擎集合可能不同，重要结论建议交叉核对原始链接。

Q4：调用时返回空结果或报错怎么办？

按文档的故障排除思路逐条排查：先换列表中的其他实例；再确认实例是否在线（查看 searx.space 的实时健康信息）；若报 JSON 解析错误，可能是该实例禁用了 format=json，换实例即可；遇到「请求过多」则轮换实例并加大请求间隔；响应慢时优先选择地理上更近、中位响应时间低于 1.5 秒的实例。工程上建议设置 5-10 秒超时并开启缓存，能消除大部分偶发失败。

Q5：和商业搜索 API 应该怎么选？适合谁用？

如果你是 AI 代理开发者、独立开发者、做原型验证的团队，或业务对成本与隐私敏感，本技能是非常合适的默认选择；如果业务要求商业 SLA、结果高度一致性和法律责任界定，建议以商业 API 为主链路，把本技能作为降级备用——两条链路并存往往是最稳妥的架构。