web-search

ウェブ検索スキル

API キー不要で複数の検索エンジンに対応する、高機能なウェブ検索スキルです。

機能

• 🔍 複数の検索エンジンに対応：Baidu（Playwright）、Bing、DuckDuckGo
• 🌐 API キー不要：ブラウザー自動化とウェブスクレイピングを使用します
• 🔄 スマートフォールバック：検索エンジンでエラーが発生すると、自動的に別のエンジンに切り替えます
• 📊 構造化された結果：タイトル、URL、スニペットを含む整理された検索結果を返します
• 🚀 高いパフォーマンス：Playwright によるブラウザー自動化で非同期処理に対応します

使用方法

基本的な検索

result = main({
    "action": "search",
    "query": "Python tutorial",
    "num_results": 5
})

詳細検索

result = main({
    "action": "deep_search",
    "query": "machine learning latest research",
    "num_results": 5
})

ウェブページのクロール

result = main({
    "action": "crawl",
    "url": "https://example.com"
})

入力パラメーター

パラメーター	型	必須	説明
action	string	はい	操作の種類：「search」、「deep_search」、「crawl」
query	string	条件付き	検索クエリ（search/deep_search の場合は必須）
url	string	条件付き	対象 URL（crawl の場合は必須）
num_results	int	いいえ	結果の件数。デフォルトは 5、最大 20
region	string	いいえ	地域コード。デフォルトは 'cn-zh'

出力形式

検索結果

{
    "success": True,
    "query": "search query",
    "engine": "baidu+playwright",
    "num_results": 5,
    "results": [
        {
            "title": "Result title",
            "href": "https://...",
            "body": "Snippet content"
        }
    ],
    "message": "Search completed"
}

詳細検索結果

{
    "success": True,
    "query": "search query",
    "search_results": [...],
    "detailed_info": {
        "extracted_content": "..."
    },
    "message": "Deep search completed"
}

実行

type: script script_path: scripts/web_search.py entry_point: main dependencies:

• uv>=0.1.0
• requests>=2.28.0
• baidusearch>=1.0.3
• crawl4ai>=0.8.0
• playwright>=1.40.0

検索戦略

1. プライマリー：baidusearch ライブラリ（最速、ブラウザー不要）
2. セカンダリー：Playwright + Baidu（最も信頼性が高く、ボット対策を回避）
3. ターシャリー：DuckDuckGo（プライバシー重視）
4. フォールバック：Bing（海外向け）

注意事項

1. 初回実行：初めて使用するときに、Playwright が Chromium ブラウザーをダウンロードします（約 100MB）
2. レート制限：一時的なブロックを避けるため、検索頻度にご注意ください
3. ネットワーク：インターネット接続が必要です
4. 検索結果：検索エンジンのアルゴリズムや地域によって異なる場合があります

エラー処理

• エラー時は {"success": False, "message": "..."} を返します
• フォールバック先の検索エンジンを使って自動的に再試行します
• オプションの依存関係がない場合も、可能な範囲で動作を継続します