Nimble 的 Search API 通过无头浏览器实时浏览互联网提供实时网络搜索,而不是查询预构建的索引。该工具处理 JavaScript 渲染、动态内容和复杂的导航流,适用于需要访问当前网络数据的智能体工作流,包括分页、过滤器和客户端渲染背后的内容。
概述
集成详情
| 类 | 包 | 可序列化 | JS 支持 | 最新包版本 |
|---|---|---|---|---|
| NimbleSearchTool | langchain-nimble | ❌ | ❌ |
工具功能
| 返回工件 | 原生异步 | 返回数据 | 定价 |
|---|---|---|---|
| ❌ | ✅ | 标题、URL、内容(markdown/plain_text/HTML)、元数据 | 提供免费试用 |
- 快速模式与深度模式:深度模式(默认)用于含 JavaScript 渲染的完整内容提取,快速模式用于仅获取 SERP 快速结果
- AI 生成摘要:可选地在原始搜索结果旁边生成简洁的回答
- 域名和日期过滤:按特定域名或日期范围过滤以获得精确结果
- 基于主题的路由:针对通用、新闻或基于位置的查询进行优化路由
- 灵活的输出格式:plain_text、markdown(默认)或 simplified_html
- 生产就绪:原生异步支持、自动重试、连接池
设置
该集成位于langchain-nimble 包中。
凭证
您需要一个 Nimble API 密钥才能使用此工具。在 Nimble 注册以获取您的 API 密钥并访问免费试用。实例化
现在我们可以实例化工具:在智能体中使用
我们可以将 Nimble 搜索工具与智能体结合使用,赋予其动态网络搜索能力。以下是使用 LangGraph 的完整示例:高级配置
该工具支持针对不同使用场景的广泛配置:| 参数 | 类型 | 默认值 | 描述 |
|---|---|---|---|
num_results | int | 10 | 返回的最大结果数(1-20) |
deep_search | bool | True | 深度模式(默认)用于完整内容提取,快速模式(False)仅获取 SERP 结果 |
topic | str | ”general” | 针对特定内容类型优化搜索:“general”、“news” 或 “location” |
include_answer | bool | False | 在搜索结果旁边生成 AI 驱动的摘要回答 |
include_domains | list[str] | None | 白名单特定域名(如 [“wikipedia.org”, “.edu”]) |
exclude_domains | list[str] | None | 黑名单特定域名以过滤掉不想要的内容 |
start_date | str | None | 过滤指定日期之后的结果(YYYY-MM-DD 或 YYYY) |
end_date | str | None | 过滤指定日期之前的结果(YYYY-MM-DD 或 YYYY) |
parsing_type | str | ”markdown” | 输出格式:“plain_text”、“markdown” 或 “simplified_html” |
locale | str | ”en” | 搜索区域(如 “en-US”) |
country | str | ”US” | 本地化结果的国家代码(如 “US”) |
api_key | str | env var | Nimble API 密钥(默认为 NIMBLE_API_KEY 环境变量) |
最佳实践
快速模式与深度模式
-
深度模式(
deep_search=True,默认):- 从网页提取完整内容
- 最适合详细分析、RAG 应用和全面研究
- 处理 JavaScript 渲染和动态内容
-
快速模式(
deep_search=False):- 仅包含标题和摘要的快速 SERP 结果
- 针对速度至关重要的高吞吐量查询进行优化
- 每次查询成本更低
何时使用 include_answer
- 当您希望在原始搜索结果之外获得简洁的 AI 生成摘要时,启用
include_answer=True - 适用于无需自行处理所有原始内容即可快速获取洞见的场景
过滤技巧
- 域名过滤:使用
include_domains进行学术研究或需要可信来源时;使用exclude_domains过滤掉不需要的内容类型 - 日期过滤:结合
start_date和end_date进行时效性查询或最新新闻搜索 - 主题路由:使用
topic参数针对通用网页内容、新闻文章或基于位置的信息优化搜索
性能优化
- 选择合适的模式:高吞吐量查询时使用快速模式(
deep_search=False);全面内容提取时使用深度模式(默认) - 并发运行多个搜索时使用异步操作(
ainvoke) - 将
num_results调整为所需的最小结果数以减少响应时间 - 利用域名过滤聚焦于优质来源并减少噪音
API 参考
有关所有NimbleSearchRetriever 功能和配置的详细文档,请访问 Nimble API 文档。
将这些文档连接到 Claude、VSCode 等,通过 MCP 获取实时解答。

