---
name: dingtalk-ai-web-search
description: 网页搜索与实时信息检索。需要查找最新资讯、实时数据、技术文档、热点事件，或用户说"搜一下"、"帮我查"、"查资料"、"web search"等时使用。基于小宿AI智能搜索，支持关键词搜索、时间范围过滤（一天/一周/一月/一年）、自定义结果数量、JSON 输出。
---
## 会话开始：连通性检查
**每次新会话开始，先运行 `--ping` 检查，再执行实际搜索：**
```bash
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
```
配置格式示例：
```json
{
"mcpServers": {
"小宿智能搜索": {
"type": "streamable-http",
"url": "https://mcp-gw.dingtalk.com/server/..."
}
}
}
```
收到配置后，运行连通性测试并永久保存（将 JSON 作为字符串传入 `-c`）：
```bash
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
bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh -q "Python asyncio 最佳实践"
```
---
## 时间筛选
```bash
# 一周内的最新文章
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
bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh -q "FastAPI 性能优化" -n 5 --json
```
输出格式：
```json
[
{
"title": "页面标题",
"url": "https://...",
"snippet": "内容摘要...",
"site": "网站名称",
"published": "2025-01-01",
"source": "小宿智能搜索"
}
]
```
---
## 典型工作流
### 调研某个技术主题
```bash
bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh -q "LangGraph checkpoint 持久化方案" -n 5
```
### 获取实时信息
```bash
# 近一周新闻
bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh -q "OpenAI o3 发布" -f oneWeek -n 8
```
### 多轮深入调研
```bash
# 第一轮：宽泛了解
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
```