DuckDuckGo Search — ddgs CLI による無料Web検索
APIキー不要でDuckDuckGoを使う方法。cronの情報収集ジョブでも実際に使われている。
検証環境: ddgs==9.11.2
偵測フロー（どの手段を使うか）
command -v ddgs >/dev/null && echo "DDGS_CLI=installed" || echo "DDGS_CLI=missing"ddgsCLIが入っている → terminal +ddgsを使う（推奨）ddgsCLIが無い →execute_codeでimportできると仮定しない- 必要ならインストールする
- それ以外は built-in web/browser ツールにフォールバック
重要な実行時注意:
- terminal と
execute_codeは別のランタイム - shellでインストールしても
execute_codeからimportできるとは限らない
インストール
pip install ddgs
ddgs --helpCLI検索（推奨）
# テキスト検索
ddgs text -q "python async programming" -m 5
# ニュース検索
ddgs news -q "artificial intelligence" -m 5
# 画像検索
ddgs images -q "landscape photography" -m 10
# 動画検索
ddgs videos -q "python tutorial" -m 5
# 地域フィルター
ddgs text -q "best restaurants" -m 5 -r us-en
# 期間指定（d=日, w=週, m=月, y=年）
ddgs text -q "latest AI news" -m 5 -t w
# JSON出力（パース用）
ddgs text -q "fastapi tutorial" -m 5 -o jsonCLIフラグ一覧
| フラグ | 説明 | 例 |
|---|---|---|
-q |
クエリ（必須） | -q "search terms" |
-m |
最大結果数 | -m 5 |
-r |
地域 | -r us-en |
-t |
期間制限 | -t w（1週間） |
-s |
セーフサーチ | -s off |
-o |
出力形式 | -o json |
Python API（確認済みランタイムのみ）
from ddgs import DDGS は、そのランタイムにddgsがインストールされている確認をしてから使う。
max_results は必ずキーワード引数で渡すこと。 Positionalだと全メソッドでエラー。
テキスト検索 → title, href, body
from ddgs import DDGS
with DDGS() as ddgs:
for r in ddgs.text("python async programming", max_results=5):
print(r["title"], r["href"], r.get("body", "")[:200])ニュース検索 → date, title, source, url, body
with DDGS() as ddgs:
for r in ddgs.news("AI regulation 2026", max_results=5):
print(r["date"], r["title"], r.get("source", ""))画像検索 → title, image, thumbnail, url
動画検索 → title, content, duration, provider
クイックリファレンス
| メソッド | 用途 | 主なフィールド |
|---|---|---|
text() |
一般検索、企業、ドキュメント | title, href, body |
news() |
最新情報、速報 | date, title, source, body, url |
images() |
ビジュアル、図表 | title, image, thumbnail, url |
videos() |
チュートリアル、デモ | title, content, duration, provider |
ワークフロー: 検索→抽出
DDGSはタイトル・URL・スニippetを返すだけ。本文が必要なら web_extract でURLを開く。
ddgs text -q "fastapi deployment guide" -m 3 -o json
# → 最適なURLを web_extract で開く制限事項
- レート制限: 大量リクエストでthrottleされる場合あり。数秒のdelayを入れる
- 本文抽出なし: DDGSはスニippetのみ。本文は
web_extract等で別途取得 - 可用性: クラウドIPからブロックされる場合あり
- フィールド可動性: 返り値フィールドは
.get()で安全に取得 - ランタイムの分離: terminalで動いても
execute_codeで動くとは限らない
トラブルシューティング
| 問題 | 原因 | 対処 |
|---|---|---|
ddgs: command not found |
CLIが未インストール | pip install ddgs または built-inツール |
ModuleNotFoundError: No module named 'ddgs' |
Pythonランタイムに未インストール | CLIを使うかランタイムを準備 |
| 検索結果が空 | レート制限 or クエリが悪い | 数秒待つ or クエリ変更 |
ピットフォール
max_resultsはキーワード専用:ddgs.text("query", 5)→ エラー- CLIの存在を仮定しない:
command -v ddgsで確認 execute_codeでimportできると仮定しない- パッケージ名:
ddgs（旧duckduckgo-search） -qと-mを混同しない
See Also
- Web Search & Extract 検索バックエンド選定ガイド — DDGSを含む検索バックエンド全一覧
- Cron トラブルシューティング完全ガイド — cronジョブ全体の診断
- Hermes Agent運用の教訓 — profiles・config・skill設計
Sources
- Hermes Agent公式ドキュメント — DuckDuckGo Search