Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
bear2u avatar

Web Search

  • 32 installs
  • 902 repo stars
  • Updated June 22, 2026
  • bear2u/my-skills

web-search is a Claude skill that runs DuckDuckGo text, news, and image searches with region and time filters via a bundled Python script.

About

This skill runs a bundled Python script to search DuckDuckGo for text, news, or images. It supports region codes, SafeSearch levels, and time-range filters, and returns results as JSON. A developer uses it when the built-in web search is unavailable outside the US or when news, image, or region-scoped results are needed.

  • Searches DuckDuckGo for text, news, or images via a bundled script
  • Supports region codes, SafeSearch, and day/week/month/year time filters
  • Returns JSON that can be saved or processed programmatically

Web Search by the numbers

  • 32 all-time installs (skills.sh)
  • Ranked #1,205 of 2,715 Automation & Workflows skills by installs in the Skillselion catalog
  • Data as of Aug 4, 2026 (Skillselion catalog sync)
At a glance

web-search capabilities & compatibility

Capabilities
web search · news search · image search
Use cases
web search · research
Pricing
Free
From the docs

What web-search says it does

python3 ~/.claude/skills/web-search/scripts/search.py -q "검색어" -t text -n 5
SKILL.md
빌트인 WebSearch를 사용할 수 없을 때 (US 외 지역)
SKILL.md
npx skills add https://github.com/bear2u/my-skills --skill web-search

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs32
repo stars902
Last updatedJune 22, 2026
Repositorybear2u/my-skills

What it does

Run DuckDuckGo text, news, or image searches with region and time filters when the built-in web search is limited.

Who is it for?

News, image, or region-scoped web search outside the US when built-in search is limited

Skip if: Simple US-region text search where the built-in WebSearch already works

When should I use this skill?

You need DuckDuckGo news, image, region, or time-filtered search results

What you get

JSON search results for text, news, or images with region, SafeSearch, and time-range control.

  • JSON search results

By the numbers

  • 3 search types (text/news/images)
  • 6 documented CLI parameters

Files

SKILL.mdMarkdownGitHub ↗

DuckDuckGo Web Search

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

When to Use

다음 상황에서 사용:

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

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

  • 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: 결과 정리

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

Parameters

파라미터필수기본값설명
-qYes-검색 키워드
-tNotexttext, news, images
-nNo5최대 결과 수
-rNowt-wt지역 코드
-sNomoderateSafeSearch: on, moderate, off
-pNoNone기간: d(일), w(주), m(월), y(년)

주요 지역 코드

  • 전세계: 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

검색 연산자

query에 포함하여 사용:

  • site:example.com - 특정 사이트 내 검색
  • filetype:pdf - 특정 파일 유형
  • "exact phrase" - 정확한 구문
  • -exclude - 특정 단어 제외

Error Handling

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

Related skills

FAQ

What search types are supported?

Text, news, and image search, selectable with the -t flag.

When should I use it over the built-in search?

When you need news or image results, region or time filters, or search outside the US where built-in WebSearch is limited.

Automation & Workflowsresearchautomation

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.