DuckDuckGo Web Search

When to Use

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

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

Core Workflow

Step 1: 검색 유형 판별

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

Step 2: 스크립트 실행

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

Step 3: 결과 정리

Parameters

-q

-t

-n

-r

-s

-p

주요 지역 코드

• 전세계:

  wt-wt

  | 한국:

  kr-kr

  | 미국:

  us-en

  | 일본:

  jp-jp

  | 영국:

  uk-en

Examples

텍스트 검색

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

검색 연산자

• site:example.com

  - 특정 사이트 내 검색

• filetype:pdf

  - 특정 파일 유형

• "exact phrase"

  - 정확한 구문

• -exclude

  - 특정 단어 제외

Error Handling

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

  pip install -U ddgs

  수동 실행