网络搜索

使用DuckDuckGo的即时答案API进行免费网络搜索。无需API密钥。

快速开始

# Basic search
cd /home/hxx/clawd/tools && ./web-search.sh "your query"

# Examples
./web-search.sh "what is artificial intelligence"
./web-search.sh "python programming"
./web-search.sh "define recursion"
./web-search.sh "2+2"

命令行选项

核心选项

• -h, --help- 显示帮助信息及使用示例
• --format <format>- 输出格式：text、markdown、plain（默认：text）
  • text：彩色终端输出（默认）
  • markdown：干净的Markdown格式（无ANSI颜色）
  • plain：无颜色的纯文本
• --no-color- 禁用彩色输出（同)--max-related <N>
• - 控制显示的相关主题数量（默认：5）--quiet
• - 最小输出模式（仅显示结果，无页眉/页脚）输出到文件

使用Shell重定向将结果保存到文件：

它返回什么

# Save to file
./web-search.sh "query" > output.txt

# With markdown format
./web-search.sh --format markdown "query" > results.md

# With no colors for logs
./web-search.sh --no-color "query" > search.log

该工具提供几种结果类型：

答案

• - 针对计算、转换、天气等的直接答案摘要
• - 维基百科风格的摘要，包含来源和URL定义
• - 词语/术语的定义相关主题
• - 额外的相关结果（可配置，默认5个）最佳实践

具体明确

1. - 查询越具体，获得的即时答案越好尝试不同问法
2. Try variations- 若无结果，请重新表述查询
3. 适用于查询事实信息- 定义、计算、快速查找效果最佳
4. 检查网址- 始终提供DuckDuckGo链接以便完整搜索
5. 使用适当的格式：
   • 终端输出：--format text（彩色，默认）
   • 文档：--format markdown> file.md`
   • 日志/管道处理：--format plain或--no-color

限制

• 不提供完整的网页搜索结果（仅限即时答案）
• 部分查询返回的结果有限，具体取决于DuckDuckGo的数据
• 部分摘要存在字符编码问题（已知限制）
• 需要互联网连接以查询DuckDuckGo API
• 并非所有查询类型都会返回即时答案（例如，复杂的数学计算如sqrt(144)）
• 并非所有术语都能找到定义
• 可能无法显示最新新闻（DuckDuckGo侧重于常青内容）

使用示例

基础搜索

# Simple query
./web-search.sh "open source AI models"

# Wikipedia-style query
./web-search.sh "what is recursion"

Markdown格式

# Clean markdown output
./web-search.sh --format markdown "python programming"

# Save to markdown file
./web-search.sh --format markdown "AI research" > research.md

纯文本/无颜色

# For logs or piping
./web-search.sh --format plain "search query"

# Disable colors explicitly
./web-search.sh --no-color "search query"

控制相关主题

# Show fewer related topics
./web-search.sh --max-related 3 "machine learning"

# Show more related topics
./web-search.sh --max-related 10 "open source"

静默模式

# Minimal output (just results)
./web-search.sh --quiet "what is 42 + 7"

组合选项

# Markdown, no color, saved to file
./web-search.sh --format markdown --no-color "topic" > results.md

# Quiet with custom related count
./web-search.sh --quiet --max-related 2 "definition"

已测试场景

经测试验证可正常工作：

• ✅ 计算：2+2、500的10%
• ✅ 单位换算：100英里换算为公里
• ✅ 维基百科查询：什么是人工智能
• ✅ 编程：什么是Python如何安装Docker✅ 人物：
• 埃隆·马斯克是谁✅ 科学事实：
• 光速✅ 天气：
• 东京天气✅ 边界情况：空查询、特殊字符、无结果
• ✅ 输出格式：文本、Markdown、纯文本
• ✅ 标志：--help、--format、--no-color、--max-related、--quiet
• 查看

test-outputs.md获取详细测试结果。故障排除

"未找到直接结果"

尝试重新表述您的查询，或使用提供的 DuckDuckGo 链接进行完整搜索。

网络错误

检查网络连接。该工具需要网络访问。

字符编码问题

某些摘要显示乱码字符。这是基本解析的一个已知问题（安装

Some abstracts display garbled characters. This is a known issue with basic parsing (installjq以获取更好的结果。

“未找到jq”警告

该工具无需jq即可工作，它使用基本文本提取，但安装jq可以改善JSON解析：

# Ubuntu/Debian
sudo apt-get install jq

# macOS
brew install jq

# Via package managers
npm install -g jq

输出格式

文本格式（默认）

• 蓝色- 标题和搜索信息
• 绿色- 结果标记和内容
• 黄色- 来源、URL和警告
• 红色- 错误

使用--format plain或--no-color来禁用颜色。

Markdown格式

简洁的Markdown格式，包含：

• ##章节标题
• **粗体**用于强调
• -项目符号列表
• *斜体*用于元数据
• [链接]()用于URL

纯文本格式

无ANSI代码或Markdown格式 - 适用于日志和管道传输。

要求

• curl或wget（用于HTTP请求）
• 可选：jq（用于更好的JSON解析）