ddgr

ddgr ウェブ検索

ddgr を使用して、ターミナルから DuckDuckGo を検索します。

使用する場面

• ユーザーがウェブ検索や情報の検索を依頼した場合
• 学習データに含まれない最新情報やリアルタイム情報が必要な場合
• ユーザーがドキュメント、チュートリアル、リソースを探したい場合
• DuckDuckGo Bang 検索（Wikipedia、StackOverflow、GitHub など）

前提条件

ddgr をインストールしておく必要があります：brew install ddgr または pip install ddgr

基本的な使い方

ddgr --noua --np --json "search query"

必須フラグ：

• --noua：ユーザーエージェントを無効にします（常に使用してください）
• --np (noprompt)：結果を表示した後、対話型プロンプトを表示せずに終了します
• --json：解析用に JSON 形式で出力します（--np を含みます）

オプション

フラグ	説明
-n N	結果数（0～25、デフォルトは 10）
-t SPAN	期間フィルター：d（日）、w（週）、m（月）、y（年）
-w SITE	特定のサイト内を検索します
-r REG	地域を指定して検索します（例：us-en、uk-en、in-en）
-x	ドメインのみではなく、完全な URL を表示します
-j	「I'm Feeling Ducky」：最初の結果をブラウザーで開きます
-i	インスタントアンサーのみを取得します
--unsafe	セーフサーチを無効にします
--rev	結果を逆順で表示します
-p URI	HTTPS プロキシ（https_proxy 環境変数も読み込みます）

DuckDuckGo Bang

Bang は検索を他のサイトに転送します。bash/zsh では ! をエスケープしてください：

ddgr --noua --np \!w "search term"      # Wikipedia
ddgr --noua --np \!so "python error"    # StackOverflow  
ddgr --noua --np \!gh "repo name"       # GitHub
ddgr --noua --np \!yt "video topic"     # YouTube
ddgr --noua --np \!a "product"          # Amazon

Bang の一覧：https://duckduckgo.com/bang

検索キーワード

ddgr --noua --np --json "filetype:pdf annual report"
ddgr --noua --np --json "site:reddit.com python tips"

例

基本的な検索：

ddgr --noua --np --json "python asyncio tutorial"

最近の結果（過去 1 週間）：

ddgr --noua --np --json -t w "latest news topic"

サイトを指定した検索：

ddgr --noua --np --json -w stackoverflow.com "parse JSON"

地域を指定した検索（インド、英語）：

ddgr --noua --np --json -r in-en "IPL cricket"

インスタントアンサー：

ddgr --noua --np -i "weather new york"

結果を 5 件に制限：

ddgr --noua --np --json -n 5 "quick query"

JSON 出力の構造

各結果には次の項目が含まれます：

• title：ページタイトル
• url：完全な URL
• abstract：説明／スニペット

jq で解析します：

ddgr --noua --np --json "query" | jq '.[].title'
ddgr --noua --np --json "query" | jq -r '.[0].url'  # First result URL