dingtalk-ai-web-search

会话开始：连通性检查

每次新会话开始，先运行 --ping 检查，再执行实际搜索：

bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh --ping

根据结果处理：

结果	含义	处理方式
✓ 连通成功，可用工具: web_search	正常	直接开始搜索
错误：未配置 MCP URL	从未配置或配置丢失	向用户索取 MCP 配置（见下方）
连接失败: ...	URL 失效或网络问题	让用户重新获取配置并执行 --save

---

配置缺失时：向用户索取 MCP 配置

让用户打开以下页面，复制 MCP 配置 JSON 后提供给你：

https://mcp.dingtalk.com/#/detail?detailType=instanceMcpDetail&instanceId=78440

配置格式示例：

{
  "mcpServers": {
    "小宿智能搜索": {
      "type": "streamable-http",
      "url": "https://mcp-gw.dingtalk.com/server/..."
    }
  }
}

收到配置后，运行连通性测试并永久保存（将 JSON 作为字符串传入 -c）：

bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh --save -c '{"mcpServers":{"小宿智能搜索":{"type":"streamable-http","url":"<用户提供的URL>"}}}'

• 成功：输出 ✓ 连通成功，可用工具: ... 并提示已保存，后续无需再传 -c
• 失败：根据报错提示处理（配置格式错误 / 网络不通 / URL 无效）

---

快速参考

场景	命令
会话开始连通检查	bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh --ping
保存配置（需 -c 传入 JSON）	bash ... --save -c '<MCP JSON配置>'
普通搜索	bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh -q "关键词"
限定时间范围	bash ... -q "关键词" -f oneWeek
返回更多结果	bash ... -q "关键词" -n 10
JSON 输出	bash ... -q "关键词" --json

---

基础用法

bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh -q "Python asyncio 最佳实践"

---

时间筛选

# 一周内的最新文章
bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh -q "LLM 评测基准 2025" -f oneWeek

# 一个月内
bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh -q "AI 编程工具对比" -f oneMonth

可选值: noLimit（默认）| oneDay | oneWeek | oneMonth | oneYear

---

JSON 输出（便于程序处理）

bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh -q "FastAPI 性能优化" -n 5 --json

输出格式：

[
  {
    "title": "页面标题",
    "url": "https://...",
    "snippet": "内容摘要...",
    "site": "网站名称",
    "published": "2025-01-01",
    "source": "小宿智能搜索"
  }
]

---

典型工作流

调研某个技术主题

bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh -q "LangGraph checkpoint 持久化方案" -n 5

获取实时信息

# 近一周新闻
bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh -q "OpenAI o3 发布" -f oneWeek -n 8

多轮深入调研

# 第一轮：宽泛了解
bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh -q "Rust 异步运行时对比" -n 5
# 第二轮：聚焦具体问题
bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh -q "tokio vs async-std 性能基准测试 2024" -f oneYear -n 5