dingtalk-ai-web-search

Session start: connectivity check

At the start of each new session, first run --ping check, then perform the actual search:

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

Handle based on the result:

Result	Meaning	Handling method
✓ 连通成功，可用工具: web_search	Normal	Start searching directly
错误：未配置 MCP URL	Never configured or configuration lost	Ask the user for the MCP configuration (see below)
连接失败: ...	URL invalid or network issue	Have the user obtain the configuration again and run --save

---

When configuration is missing: ask the user for the MCP configuration

Have the user open the following page, copy the MCP configuration JSON, and provide it to you:

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

Configuration format example:

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

After receiving the configuration, run a connectivity test and save it permanently (pass the JSON as a string to -c）：

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

• Success: output ✓ 连通成功，可用工具: ... and indicate that it has been saved, and there is no need to pass it again later -c
• Failure: handle based on the error message (configuration format error / network unreachable / invalid URL)

---

Quick reference

Scenario	Command
Session start connectivity check	bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh --ping
Save configuration (JSON must be passed in with -c)	bash ... --save -c '<MCP JSON配置>'
Normal search	bash <CURRENT_SKILL_MD_PATH_DIR>/scripts/search.sh -q "关键词"
Limit time range	bash ... -q "关键词" -f oneWeek
Return more results	bash ... -q "关键词" -n 10
JSON output	bash ... -q "关键词" --json

---

Basic usage

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

---

Time filtering

# 一周内的最新文章
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

Optional values: noLimit(default) | oneDay | oneWeek | oneMonth | oneYear

---

JSON output (convenient for programmatic processing)

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

Output format:

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

---

Typical workflow

Research a technical topic

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

Get real-time information

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

Multi-round in-depth research

# 第一轮：宽泛了解
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