web-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

DuckDuckGo Web Search

DuckDuckGo 网页搜索

DuckDuckGo 검색 엔진을 활용한 텍스트, 뉴스, 이미지 검색 스킬.

一款基于DuckDuckGo搜索引擎的文本、新闻、图片搜索Skill。

When to Use

使用场景

다음 상황에서 사용:

빌트인 WebSearch를 사용할 수 없을 때 (US 외 지역)
뉴스 전용 검색이 필요할 때
이미지 URL을 검색해야 할 때
검색 결과를 JSON으로 저장하거나 프로그래밍적으로 처리해야 할 때
시간 범위(일/주/월/년)를 세밀하게 지정해야 할 때
특정 지역(한국, 일본 등) 기준 검색 결과가 필요할 때

빌트인 WebSearch를 우선 사용하는 경우:

US 지역의 단순 텍스트 검색
빠른 사실 확인

适用于以下场景：

无法使用内置WebSearch时（美国以外地区）
需要专属新闻搜索时
需要搜索图片URL时
需要将搜索结果保存为JSON或进行程序化处理时
需要精细指定时间范围（日/周/月/年）时
需要特定地区（韩国、日本等）的搜索结果时

优先使用内置WebSearch的场景：

美国地区的简单文本搜索
快速事实查证

Core Workflow

核心工作流程

Step 1: 검색 유형 판별

步骤1：判断搜索类型

사용자 요청에서 검색 유형 파악:

텍스트 검색 (기본): 일반적인 웹 검색
뉴스 검색: "뉴스", "최근 소식", "news" 키워드 포함
이미지 검색: "이미지", "사진", "image", "picture" 키워드 포함

从用户请求中识别搜索类型：

文本搜索（默认）：常规网页搜索
新闻搜索：包含“新闻”、“最新消息”、“news”关键词
图片搜索：包含“图片”、“照片”、“image”、“picture”关键词

Step 2: 스크립트 실행

步骤2：执行脚本

bash

python3 ~/.claude/skills/web-search/scripts/search.py -q "검색어" -t text -n 5

bash

python3 ~/.claude/skills/web-search/scripts/search.py -q "搜索关键词" -t text -n 5

Step 3: 결과 정리

步骤3：整理结果

JSON 출력을 사용자에게 읽기 좋은 형태로 정리하여 전달.

将JSON输出整理为用户易读的格式后返回。

Parameters

参数说明

파라미터	필수	기본값	설명
`-q`	Yes	-	검색 키워드
`-t`	No	text	text, news, images
`-n`	No	5	최대 결과 수
`-r`	No	wt-wt	지역 코드
`-s`	No	moderate	SafeSearch: on, moderate, off
`-p`	No	None	기간: d(일), w(주), m(월), y(년)

参数	必填	默认值	说明
`-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
```

全球:
```
wt-wt
```
| 韩国:
```
kr-kr
```
| 美国:
```
us-en
```
| 日本:
```
jp-jp
```
| 英国:
```
uk-en
```

Examples

使用示例

텍스트 검색

文本搜索

bash

python3 ~/.claude/skills/web-search/scripts/search.py -q "Claude Code Anthropic" -t text -n 5

bash

python3 ~/.claude/skills/web-search/scripts/search.py -q "Claude Code Anthropic" -t text -n 5

한국 뉴스 검색 (최근 1주)

韩国新闻搜索（最近1周）

bash

python3 ~/.claude/skills/web-search/scripts/search.py -q "AI 인공지능" -t news -n 10 -r kr-kr -p w

bash

python3 ~/.claude/skills/web-search/scripts/search.py -q "AI 人工智能" -t news -n 10 -r kr-kr -p w

이미지 검색

图片搜索

bash

python3 ~/.claude/skills/web-search/scripts/search.py -q "modern web design" -t images -n 5

bash

python3 ~/.claude/skills/web-search/scripts/search.py -q "modern web design" -t images -n 5

결과를 파일로 저장

将结果保存到文件

bash

python3 ~/.claude/skills/web-search/scripts/search.py -q "React 19" -t text -n 20 > results.json

bash

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
```
- 특정 단어 제외

可在查询词中添加以下运算符：

```
site:example.com
```
- 限定特定网站内搜索
```
filetype:pdf
```
- 限定特定文件类型
```
"exact phrase"
```
- 精确匹配短语
```
-exclude
```
- 排除特定词汇

Error Handling

错误处理

Rate Limit: 잠시 후 재시도하거나 결과 수를 줄임
Timeout: 네트워크 확인 후 재시도
패키지 미설치: 스크립트가 자동 설치 시도. 실패 시
```
pip install -U ddgs
```
수동 실행

请求频率限制：稍后重试或减少结果数量
超时：检查网络后重试
未安装依赖包：脚本会尝试自动安装，若失败请手动执行
```
pip install -U ddgs
```