web-search

DuckDuckGo ウェブ検索

DuckDuckGo 検索エンジンを利用した、テキスト、ニュース、画像の検索スキルです。

使用する場面

次のような場合に使用します。

• 組み込みの WebSearch を利用できない場合（US 以外の地域）
• ニュース専用の検索が必要な場合
• 画像 URL を検索する必要がある場合
• 検索結果を JSON で保存したり、プログラムで処理したりする必要がある場合
• 期間（日／週／月／年）を細かく指定する必要がある場合
• 特定の地域（韓国、日本など）に基づく検索結果が必要な場合

組み込みの WebSearch を優先する場合：

• US 地域でのシンプルなテキスト検索
• 迅速な事実確認

主なワークフロー

ステップ 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 を手動で実行します