名称： nimble-web-search
描述： >
基于 Nimble Search API 的实时网络智能工具。提供 8 种专业聚焦模式（通用、编程、新闻、学术、购物、社交、地理、本地）的智能网络搜索。
当您需要搜索网络、查找最新信息、发现网址、研究主题或收集最新数据时，此技能可提供实时搜索结果。
使用场景：搜索信息、查找近期新闻、查阅学术论文、搜索代码示例、查找购物结果、发现社交媒体帖子、研究主题或获取最新实时数据。
许可证： MIT
元数据：
version: "0.1.0"
author: Nimbleway
repository: https://github.com/Nimbleway/agent-skills

Nimble 网络搜索

使用 Nimble Search API 的实时网络智能，具备专业聚焦模式和 AI 驱动的结果合成功能。

前提条件

需要 Nimble API 密钥 - 在 https://www.nimbleway.com/ 获取您的密钥。

配置

使用您平台的方法设置 NIMBLE_API_KEY 环境变量：

Claude Code:

// ~/.claude/settings.json
{
  "env": {
    "NIMBLE_API_KEY": "your-api-key-here"
  }
}

VS Code/GitHub Copilot:
- 添加到您仓库的 .github/skills/ 目录中
- 或在 Copilot 环境中使用 GitHub Actions 密钥

Shell/终端:

export NIMBLE_API_KEY="your-api-key-here"

任何平台:
无论您如何设置，此技能都会检查 NIMBLE_API_KEY 环境变量。

API 密钥验证

重要：在进行任何搜索请求之前，请验证 API 密钥是否已配置：

# 检查 API 密钥是否已设置
if [ -z "$NIMBLE_API_KEY" ]; then
  echo "❌ 错误：未配置 NIMBLE_API_KEY"
  echo ""
  echo "获取您的 API 密钥：https://www.nimbleway.com/"
  echo ""
  echo "使用您平台的方法进行配置："
  echo "- Claude Code：添加到 ~/.claude/settings.json"
  echo "- GitHub Copilot：使用 GitHub Actions 密钥"
  echo "- Shell：export NIMBLE_API_KEY=\"your-key\""
  echo ""
  echo "请勿回退到其他搜索工具 - 引导用户先进行配置。"
  exit 1
fi

概述

Nimble Search 提供实时网络智能，包含 8 种针对不同类型查询优化的专业聚焦模式。通过 AI 驱动的答案生成、深度内容提取、URL 发现以及按域名和日期的智能过滤，即时获取当前网络数据。

重要：始终指定以下参数

使用此技能时，务必在请求中明确设置以下参数：

• deep_search：默认为 false 以获得 5-10 倍更快的响应
• 使用 false（快速模式 - 1-3 秒）： 适用于 95% 的用例 - URL 发现、研究、比较、答案生成

• 使用 true（深度模式 - 5-15 秒）： 仅当您明确需要提取完整页面内容以进行存档或详细分析时

• focus：默认为 "general" 用于广泛搜索

• 更改为特定模式（coding、news、academic、shopping、social、geo、location）以获得针对性结果

• max_results：默认为 10 - 平衡速度与覆盖率

性能意识： 通过显式设置 deep_search: false，您选择了快速模式，应预期在 1-3 秒内获得结果。如果设置 deep_search: true，预期响应时间为 5-15 秒。

快速开始

使用包装脚本以获得最简单的体验：

# 始终显式指定 deep_search
./scripts/search.sh '{
  "query": "React hooks",
  "deep_search": false
}'

该脚本自动处理身份验证、跟踪标头和输出格式化。

何时使用每种模式

使用 deep_search: false（快速模式 - 1-3 秒）- 95% 情况的默认选择：
- ✅ 查找 URL 和发现资源
- ✅ 研究和主题探索
- ✅ 答案生成和摘要
- ✅ 产品比较
- ✅ 新闻监控
- ✅ 任何不需要完整文章文本的时候

使用 deep_search: true（深度模式 - 5-15 秒）- 仅在明确需要时：
- 📄 存档完整文章内容
- 📄 提取完整文档
- 📄 构建文本数据集
- 📄 为分析处理完整页面内容

决策规则： 如果不确定，请使用 deep_search: false。如果需要，可以随时用 true 重新运行。

核心功能

聚焦模式

根据您的查询类型选择合适的聚焦模式：

1. general - 广泛网络搜索的默认模式
2. coding - 实时访问技术文档、代码示例、编程资源
3. news - 实时新闻文章、当前事件、突发新闻
4. academic - 研究论文、学术文章、学术资源
5. shopping - 实时产品搜索、电子商务结果、价格比较
6. social - 实时社交媒体帖子、讨论、热门社区内容
7. geo - 基于位置的搜索、地理信息
8. location - 本地商业搜索、特定地点查询

搜索功能

LLM 答案生成
- 请求基于搜索结果合成的 AI 生成答案
- 由 Claude 提供支持，生成高质量摘要
- 包含来源 URL 的引用
- 最佳用于：研究问题、主题概述、比较分析

URL 发现
- 提取查询最相关的 1-20 个 URL
- 适用于构建阅读列表和参考集合
- 返回带有标题和描述的 URL
- 最佳用于：资源收集、链接建设、研究准备

深度内容提取
- 默认（推荐）： deep_search=false - 最快响应，返回标题、描述和 URL
- 可选： deep_search=true - 较慢，提取完整页面内容
- 重要： 大多数用例使用 deep_search=false（默认）即可完美工作
- 当 deep_search=true 时可用的格式：markdown、plain_text、simplified_html
- 仅为以下情况启用深度搜索：详细内容分析、存档或全面文本提取需求

域名过滤
- 包含特定域名（例如，github.com、stackoverflow.com）
- 排除域名以移除不需要的来源
- 组合多个域名以进行聚焦搜索
- 最佳用于：针对性研究、品牌监控、竞争分析

时间过滤
- 推荐： 使用 time_range 进行实时新鲜度过滤（hour、day、week、month、year）
- 替代方案： 使用 start_date/end_date 进行精确日期范围过滤（YYYY-MM-DD）
- 注意：time_range 和日期过滤器是互斥的
- 最佳用于：实时新闻监控、近期动态、时间分析

使用模式

以下所有示例均使用 ./scripts/search.sh 包装脚本以简化操作。有关原始 API 用法，请参阅 API 集成 部分。

基本搜索

快速模式下的快速搜索（始终显式指定 deep_search）：

./scripts/search.sh '{
  "query": "React Server Components 教程",
  "deep_search": false
}'

对于技术内容，指定编程聚焦（仍为快速模式）：

./scripts/search.sh '{
  "query": "React Server Components 教程",
  "focus": "coding",
  "deep_search": false
}'

带 AI 摘要的研究

从多个来源获取综合见解（快速模式与答案生成配合良好）：

./scripts/search.sh '{
  "query": "2026 年 AI 对软件开发的影响",
  "deep_search": false,
  "include_answer": true
}'

特定域名搜索

针对特定权威来源（快速模式）：

./scripts/search.sh '{
  "query": "async await 模式",
  "focus": "coding",
  "deep_search": false,
  "include_domains": ["github.com", "stackoverflow.com", "dev.to"],
  "max_results": 8
}'

实时新闻监控

实时跟踪当前事件和突发新闻（快速模式）：

./scripts/search.sh '{
  "query": "量子计算的最新进展",
  "focus": "news",
  "deep_search": false,
  "time_range": "week",
  "max_results": 15,
  "include_answer": true
}'

学术研究 - 快速模式（推荐）

使用快速模式查找和合成学术内容：

./scripts/search.sh '{
  "query": "机器学习可解释性方法",
  "focus": "academic",
  "deep_search": false,
  "max_results": 20,
  "include_answer": true
}'

何时使用深度模式： 仅当您需要提取完整论文内容以进行存档时使用 "deep_search": true：

./scripts/search.sh '{
  "query": "机器学习可解释性方法",
  "focus": "academic",
  "deep_search": true,
  "max_results": 5,
  "output_format": "markdown"
}'

注意： 深度模式慢 5-15 倍。仅在明确需要时使用。

实时购物研究

比较产品和当前价格（快速模式）：

./scripts/search.sh '{
  "query": "适合编程的最佳机械键盘",
  "focus": "shopping",
  "deep_search": false,
  "max_results": 10,
  "include_answer": true
}'

并行搜索策略

何时使用并行搜索

在以下情况下并行运行多个实时搜索：
- 比较视角：跨不同聚焦模式搜索同一主题
- 多面研究：同时调查主题的不同方面
- 竞争分析：一次搜索多个域名或竞争对手
- 实时监控：同时跟踪多个主题或关键词
- 交叉验证：实时跨不同来源类型验证信息

实现方法

方法 1：后台进程（推荐）

使用包装脚本并发运行多个搜索：

# 并行启动多个搜索
./scripts/search.sh '{"query": "React", "focus": "coding"}' > react_coding.json &
./scripts/search.sh '{"query": "React", "focus": "news"}' > react_news.json &
./scripts/search.sh '{"query": "React", "focus": "academic"}' > react_academic.json &

# 等待所有完成
wait

# 合并结果
jq -s '.' react_*.json > combined_results.json

方法 2：使用 xargs 的循环（受控并行）

通过速率限制处理多个查询：

# 创建查询文件
cat > queries.txt <<EOF
{"query": "AI 框架", "focus": "coding"}
{"query": "AI 监管", "focus": "news"}
{"query": "AI 研究", "focus": "academic"}
EOF

# 使用最多 3 个并行进程运行
cat queries.txt | xargs -n1 -P3 -I{} ./scripts/search.sh '{}'

方法 3：聚焦模式比较

跨不同聚焦模式搜索同一查询：

QUERY="人工智能趋势"

for focus in "general" "coding" "news" "academic"; do
  (
    ./scripts/search.sh "{\"query\": \"$QUERY\", \"focus\": \"$focus\"}" \
      > "${focus}_results.json"
  ) &
done

wait
echo "所有搜索完成！"

并行执行的最佳实践

1. 速率限制：将并行请求限制在 3-5 个，以避免压垮 API
   - 使用 xargs -P3 设置最大并发请求数
   - 在增加并行度之前检查您的 API 层级限制

2. 错误处理：优雅地捕获和处理失败
   bash ./scripts/search.sh '{"query": "test"}' || echo "搜索失败" >> errors.log

3. 结果聚合：在所有搜索完成后合并结果
   ```bash
   # 等待所有搜索
   wait

# 合并 JSON 结果
jq -s 'map(.results) | flatten' result*.json > combined.json
```

4. 进度跟踪：监控完成状态
   ```bash
   echo "正在运行 5 个并行搜索..."

for i in {1..5}; do
./scripts/search.sh "{\"query\": \"query$i\"}" > "result$i.json" &
done

wait
echo "所有搜索完成！"
```

示例：多视角研究

#!/bin/bash
# 跨多个聚焦模式同时研究一个主题

QUERY="人工智能代码生成"
OUTPUT_DIR="./search_results"
mkdir -p "$OUTPUT_DIR"

# 跨不同聚焦模式并行运行搜索
for focus in "general" "coding" "news" "academic"; do
  (
    ./scripts/search.sh "{
      \"query\": \"$QUERY\",
      \"focus\": \"$focus\",
      \"max_results\": 10
    }" > "$OUTPUT_DIR/${focus}_results.json"
  ) &
done

# 等待所有搜索完成
wait

# 聚合和分析结果
jq -s '{
  general: .[0].results,
  coding: .[1].results,
  news: .[2].results,
  academic: .[3].results
}' "$OUTPUT_DIR"/*.json > "$OUTPUT_DIR/combined_analysis.json"

echo "✓ 多视角搜索完成"

性能考虑

• 最佳并行度：3-5 个并发请求可平衡速度和 API 限制
• 内存使用：每个并行请求都会消耗内存；对于大型结果集需进行监控
• 网络带宽：并行请求可能会在慢速连接上饱和带宽
• API 成本：更多并行请求 = 更快消耗 API 配额

何时不应使用并行搜索

• 单一、聚焦的查询，答案明确
• 顺序研究，每次搜索为下一次提供信息
• API 配额有限或昂贵
• 结果需要在下次搜索前进行处理
• 不需要多视角的简单 URL 收集

API 集成

注意： 对于大多数用例，请使用 使用模式 部分所示的 ./scripts/search.sh 包装脚本。下面的原始 API 示例适用于需要直接 API 访问或自定义集成的高级用户。

必需配置

在进行任何 API 请求之前，始终验证 API 密钥是否已配置：

# 验证 API 密钥是否已设置
if [ -z "$NIMBLE_API_KEY" ]; then
  echo "❌ 未配置 Nimble API 密钥。"
  echo "在 https://www.nimbleway.com/ 获取您的密钥"
  echo ""
  echo "使用您平台的方法设置 NIMBLE_API_KEY 环境变量。"
  exit 1
fi

此技能需要 NIMBLE_API_KEY 环境变量。有关平台特定的设置说明，请参阅 前提条件。

在以下网址获取您的 API 密钥：https://www.nimbleway.com/

API 端点

POST https://nimble-retriever.webit.live/search

请求格式

{
  "query": "搜索查询字符串",  // 必需
  "focus": "general",  // 可选：默认 "general" | coding|news|academic|shopping|social|geo|location
  "max_results": 10,  // 可选：默认 10（范围：1-100）
  "include_answer": false,  // 可选：默认 false
  "deep_search": false,  // 可选：默认 false（推荐：保持 false 以获得速度）
  "output_format": "markdown",  // 可选：默认 "markdown" | plain_text|simplified_html
  "include_domains": ["domain1.com"],  // 可选：默认 []（无过滤）
  "exclude_domains": ["domain3.com"],  // 可选：默认 []（无过滤）
  "time_range": "week",  // 可选：hour|day|week|month|year
  "start_date": "2026-01-01",  // 可选：使用 time_range 或 start_date/end_date（不能同时使用）
  "end_date": "2026-12-31"  // 可选
}

关键默认值：
- focus："general" - 更改为特定模式以获得针对性结果
- deep_search：false - 除非需要完整页面内容，否则保持 false
- max_results：10 - 平衡速度与覆盖率

响应格式

{
  "results": [
    {
      "url": "https://example.com/page",
      "title": "页面标题",
      "description": "页面描述",
      "content": "完整页面内容（如果 deep_search=true）",
      "published_date": "2026-01-15"
    }
  ],
  "include_answer": "AI 生成的摘要（如果 include_answer=true）",
  "urls": ["url1", "url2", "url3"],
  "total_results": 10
}

最佳实践

聚焦模式选择

使用 coding 用于：
- 编程问题
- 技术文档
- 代码示例和教程
- API 参考
- 框架指南

使用 news 用于：
- 实时当前事件
- 实时突发新闻
- 近期公告
- 热门话题
- 时效性信息

使用 academic 用于：
- 研究论文
- 学术文章
- 科学研究
- 学术期刊
- 引用和参考文献

使用 shopping 用于：
- 产品搜索
- 价格比较
- 电子商务研究
- 产品评论
- 购买指南

**