核心用法
Nimble Web Tools 是一套面向 AI Agent 的实时网络情报 CLI 工具，通过 search、extract、map、crawl 四大命令将互联网转化为结构化数据。安装后需配置 NIMBLE_API_KEY，通过 nimble --version 验证。
search：8 种聚焦模式（general/coding/news/academic/shopping/social/geo/location），默认必须添加 --deep-search=false 以获得 1-3 秒快速响应，仅当需要完整页面文本时才启用深度模式。推荐配合 --include-answer 获取 AI 合成摘要，失败时自动降级。
extract：从任意 URL 提取内容，务必使用 --parse --format markdown 获取 LLM 友好的 Markdown，避免原始 HTML 撑爆上下文窗口。支持 JS 渲染（--render）、地理定位、浏览器模拟等高级选项。
map：快速发现站点 URL 结构，返回 URL 元数据而非内容，用于规划提取工作流。
crawl：异步批量爬取整站，必须设置 `--limit` 避免无限爬取。返回原始 HTML，不适合直接喂给 LLM；推荐 map+extract 组合获取 Markdown。
显著优点
- 速度优势：
--deep-search=false模式下搜索 1-3 秒，较深度模式快 5-10 倍 - 结构化输出：原生支持 Markdown/JSON/YAML，通过 GJSON 变换精确提取字段
- 智能聚焦：8 种搜索主题自动优化结果相关性，学术、新闻、代码等场景精准匹配
- 反爬绕过：内置 stealth unblocking、JS 渲染、地理代理，解决多数防护墙
- 成本可控：分层 API 设计，快速模式覆盖 95% 场景，高级功能按需启用
潜在缺点与局限性
- 付费门槛：
--include-answer等企业功能需升级计划，返回 402/403 时需手动降级 - LinkedIn 封锁：个人资料无法直接提取，只能依赖 social 搜索的聚合数据
- Crawl 结果笨重：批量爬取返回 60-115KB 原始 HTML/页，无 Markdown 选项，必须后处理
- 异步复杂度：crawl 需轮询状态管理（15-60 秒间隔），且 status 可能误报失败
- 配置依赖：必须预装 Node.js CLI 并注入 API Key，无法开箱即用
适合人群
- AI Agent 开发者需高频、实时网页数据的场景
- 研究人员需学术/新闻/代码的精准检索与结构化提取
- 数据工程师构建网站归档或 RAG 知识库的批量管道
- Claude Code / Cursor 等 IDE 用户替代内置搜索工具
常规风险
- API 密钥泄露：
NIMBLE_API_KEY需妥善保管，建议写入~/.claude/settings.json而非硬编码 - 速率限制：高频请求触发 429，需实现退避重试或升级套餐
- 数据合规：爬取受版权保护内容或违反 robots.txt 可能引发法律风险
- 幻觉传递：
--include-answer的 AI 摘要可能引入合成错误，关键信息应交叉验证来源 - 成本失控：忘记
--limit的 crawl 可能消耗大量额度，深搜模式滥用显著增加延迟与费用