关于 web-search
web-search 是使用 DuckDuckGo 的搜索技能,面向需要文本、新闻或图片搜索的用户。它支持设置地区、时间范围和 SafeSearch,并可将结果保存为 JSON。
主要功能
- 01文本、新闻和图片搜索
- 02指定地区代码
- 03按时间范围筛选
- 04设置 SafeSearch
- 05输出 JSON 结果
适用场景
- 01搜索韩国或日本的本地结果
- 02查询指定时间段的新闻
- 03查找图片 URL
- 04保存结果供程序处理
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ bear2u/ my-skills --skill web-search安装后在 Claude Code 中输入/web-search确认已加载。
附带文件scripts/search.py
详细介绍
DuckDuckGo 网页搜索
利用 DuckDuckGo 搜索引擎进行文本、新闻和图片搜索的技能。
适用场景
在以下情况下使用:
- 无法使用内置 WebSearch 时(美国以外地区)
- 需要专门搜索新闻时
- 需要搜索图片 URL 时
- 需要将搜索结果保存为 JSON 或以编程方式处理时
- 需要精细指定时间范围(日/周/月/年)时
- 需要获取特定地区(韩国、日本等)的搜索结果时
优先使用内置 WebSearch 的情况:
- 在美国地区进行简单的文本搜索
- 快速核实事实
核心工作流
步骤 1:判断搜索类型
根据用户请求判断搜索类型:
- 文本搜索(默认):常规网页搜索
- 新闻搜索:包含“新闻”“最近消息”“news”等关键词
- 图片搜索:包含“图片”“照片”“image”“picture”等关键词
步骤 2:运行脚本
python3 ~/.claude/skills/web-search/scripts/search.py -q "검색어" -t text -n 5
步骤 3:整理结果
将 JSON 输出整理成便于用户阅读的形式后提供。
参数
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
-q | 是 | - | 搜索关键词 |
-t | 否 | text | text、news、images |
-n | 否 | 5 | 最大结果数 |
-r | 否 | wt-wt | 地区代码 |
-s | 否 | moderate | SafeSearch:on、moderate、off |
-p | 否 | None | 时间范围:d(天)、w(周)、m(月)、y(年) |
主要地区代码
- 全球:
wt-wt| 韩国:kr-kr| 美国:us-en| 日本:jp-jp| 英国:uk-en
示例
文本搜索
python3 ~/.claude/skills/web-search/scripts/search.py -q "Claude Code Anthropic" -t text -n 5
搜索韩国新闻(最近 1 周)
python3 ~/.claude/skills/web-search/scripts/search.py -q "AI 인공지능" -t news -n 10 -r kr-kr -p w
图片搜索
python3 ~/.claude/skills/web-search/scripts/search.py -q "modern web design" -t images -n 5
将结果保存到文件
python3 ~/.claude/skills/web-search/scripts/search.py -q "React 19" -t text -n 20 > results.json
搜索运算符
在 query 中使用:
site:example.com- 在特定网站内搜索filetype:pdf- 指定文件类型"exact phrase"- 精确短语-exclude- 排除特定词语
错误处理
- 速率限制:稍后重试或减少结果数
- 超时:检查网络后重试
- 未安装软件包:脚本会尝试自动安装。若失败,请手动运行
pip install -U ddgs
评论
支持 Markdown