deedy5/ddgs

これは何？

主な機能

• 01Bing、Brave、Google、DuckDuckGoなど、複数のバックエンドからテキスト検索結果を集約します。
• 02種類ごとのフィルターを備えた、画像・動画・ニュース・書籍の検索メソッドを提供します。
• 03URLからページのコンテンツを取得し、Markdown、プレーンテキスト、リッチテキスト、HTML、raw bytesとして抽出します。
• 04CLI、FastAPI APIサーバー、ツール連携クライアント向けのMCPサーバーを備えています。
• 05HTTP、HTTPS、SOCKS5プロキシと、タイムアウトの設定に対応しています。

ユースケース

• 有料の検索APIを使わずに、PythonアプリケーションやLLMエージェントへWeb検索機能を追加する。
• 検索やページ抽出を、MCP対応AIアシスタント向けのツールとして公開する。
• Docker対応のAPIサーバーを使い、社内サービス向けの検索エンドポイントをセルフホストする。
• スクリプトからコマンドライン経由で検索結果やページテキストを収集する。

クイックスタート

1. 1

   pipで基本パッケージをインストールします

   pip install -U ddgs
2. 2

   Pythonからテキスト検索を実行します

   python3 -c "from ddgs import DDGS; print(DDGS().text('python programming', max_results=5))"

使う前に知っておきたいこと

• !検索結果はサードパーティの検索バックエンドから取得されるため、利用可能性や結果の品質は各サービスに依存します。

トピック

よくある質問

ddgs とは？

複数のWeb検索バックエンドにクエリを送信し、テキスト・画像・動画・ニュース・書籍の結果を統一形式で返すPythonメタ検索ライブラリ。 DDGSは、複数のWeb検索サービスに1つのクエリを送信し、結果を共通形式で返すPythonメタ検索ライブラリです。text()メソッドは、Bing、Brave、DuckDuckGo、Google、Mojeek、Startpage、Yandex、Yahoo、Wikipediaなどのバックエンドを利用でき、デフォルトではautoが設定されています。

ddgs は無料で使えますか？ライセンスは？

ddgs は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

ddgs は今もメンテナンスされていますか？

半年以内に更新あり。ddgs の最終コミットは 2026年8月26日 です。

ddgs は何に使えますか？

有料の検索APIを使わずに、PythonアプリケーションやLLMエージェントへWeb検索機能を追加する。 検索やページ抽出を、MCP対応AIアシスタント向けのツールとして公開する。 Docker対応のAPIサーバーを使い、社内サービス向けの検索エンドポイントをセルフホストする。 スクリプトからコマンドライン経由で検索結果やページテキストを収集する。

ddgs のインストール方法は？

pipで基本パッケージをインストールします: pip install -U ddgs Pythonからテキスト検索を実行します: python3 -c "from ddgs import DDGS; print(DDGS().text('python programming', max_results=5))"

ddgs はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/deedy5/ddgs