mcpField
P
pravidhi-ddgs-internet-search

pravidhi-ddgs-internet-search

github.com/pravidhi-net生産性067 回インストール34 週間前に更新
リポジトリ

pravidhi-ddgs-internet-search について

pravidhi-ddgs-internet-searchは、DuckDuckGo Searchライブラリでウェブ検索を行うエージェントスキルです。タイムアウト時に使えるセーフモードを備え、ソフト失敗を処理用のJSONで返します。

主な機能

  1. 01DuckDuckGo Searchによる検索
  2. 02検索結果数の指定
  3. 03遅延を加えるセーフモード
  4. 04ソフト失敗時のJSON返却

活用シーン

  1. 01話題に関するウェブ情報の検索
  2. 02タイムアウトした検索の再試行
  3. 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 ではありません。

  1. レート制限/IP ブロック:

    • 症状: 429 Too Many Requests または Ratelimit エラー。
    • 原因: クラウド/データセンターの IP(AWS、GCP)は、DuckDuckGo によってフラグが付けられることがよくあります。
    • 対処方法: 60 秒待ちます。--safe フラグを試します。解決しない場合は、住宅用プロキシを使用するか、API ベースのスキルに切り替えます。
  2. ソフトフェイル:

    • スクリプトは「ソフトフェイル」するよう設計されています。ゼロ以外の終了コードでクラッシュする代わりに、status: error を含む JSON オブジェクトを返します。エージェントは JSON 出力を解析し、エラーを適切に処理してください。

参考資料

コメント