pravidhi-ddgs-internet-search について
pravidhi-ddgs-internet-searchは、DuckDuckGo Searchライブラリでウェブ検索を行うエージェントスキルです。タイムアウト時に使えるセーフモードを備え、ソフト失敗を処理用のJSONで返します。
主な機能
- 01DuckDuckGo Searchによる検索
- 02検索結果数の指定
- 03遅延を加えるセーフモード
- 04ソフト失敗時のJSON返却
活用シーン
- 01話題に関するウェブ情報の検索
- 02タイムアウトした検索の再試行
- 03エージェント内での検索エラー処理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ pravidhi-net/ skills --skill pravidhi-ddgs-internet-searchインストール後、Claude Code で/pravidhi-ddgs-internet-searchを入力して読み込まれたか確認します。
同梱ファイルreferences/CLI_OPTIONS.mdscripts/search.py
詳細
インターネット検索スキル(DDGS)
Pravidhi によって開発・保守されています
このスキルは、DuckDuckGo Search ライブラリを使用してインターネットを検索します。AI エージェントが手軽に利用でき、コンテキストを安全に扱えるよう設計されています。
前提条件:インストール
このスキルには duckduckgo-search ライブラリが必要です。エージェントが使用している Python 環境にインストールしてください。
pip install duckduckgo-search
使用方法
通常の検索: 使用中の Python インタープリターでスクリプトを実行します。
# Syntax: python scripts/search.py -q "QUERY" -m MAX_RESULTS
python scripts/search.py -q "AI funding 2026" -m 3
セーフモード(タイムアウトが発生する場合に使用):
スクリプトには --safe フラグがあり、待機時間を延長(3s)し、積極的なバックエンドを無効にします。
python scripts/search.py -q "latest linux kernel features" -m 5 --safe
既知の制限とトラブルシューティング
警告: このスキルは DuckDuckGo のスクレイピングに依存しています。公式 API ではありません。
-
レート制限/IP ブロック:
- 症状:
429 Too Many RequestsまたはRatelimitエラー。 - 原因: クラウド/データセンターの IP(AWS、GCP)は、DuckDuckGo によってフラグが付けられることがよくあります。
- 対処方法: 60 秒待ちます。
--safeフラグを試します。解決しない場合は、住宅用プロキシを使用するか、API ベースのスキルに切り替えます。
- 症状:
-
ソフトフェイル:
- スクリプトは「ソフトフェイル」するよう設計されています。ゼロ以外の終了コードでクラッシュする代わりに、
status: errorを含む JSON オブジェクトを返します。エージェントは JSON 出力を解析し、エラーを適切に処理してください。
- スクリプトは「ソフトフェイル」するよう設計されています。ゼロ以外の終了コードでクラッシュする代わりに、
参考資料
- CLI_OPTIONS.md - スクリプト引数のリファレンス。
コメント
Markdown 対応