byted-byteplus-infoquest-search

Byted InfoQuest

BytePlus InfoQuest API を使用した、AI 向けに最適化されたウェブ検索、画像検索、コンテンツ抽出です。時間による絞り込み、サイト固有の検索、画像検索機能を備え、簡潔で関連性の高い結果を返します。

ヒント：InfoQuest は現在、中国本土のリージョンでは利用できません。

環境変数

このスキルを使用する前に、次の環境変数が設定されていることを確認してください。

• INFOQUEST_API_KEY：ウェブ検索、画像検索、コンテンツ抽出サービスの API キー

ウェブ検索

python3 scripts/search.py "query"
python3 scripts/search.py "query" -d 7
python3 scripts/search.py "query" -s github.com

画像検索

python3 scripts/search.py "query" -i
python3 scripts/search.py "query" -i -z l
python3 scripts/search.py "query" -i -s unsplash.com -d 30

オプション

• -d, --days <number>：過去 N 日以内を検索します（デフォルト：期間指定なし）
• -s, --site <domain>：特定のサイト内を検索します（例：github.com、unsplash.com）
• -i, --image：画像検索を実行します（デフォルト：ウェブ検索）
• -z, --image-size <size>：画像サイズのフィルター：l（大）、m（中）、i（アイコン）

URL からコンテンツを抽出

python3 scripts/extract.py "https://example.com/article"

使用例

最近のニュースを検索

# Search for AI news from last 3 days
python3 scripts/search.py "artificial intelligence news" -d 3

サイトを指定した調査

# Search for Python projects on GitHub
python3 scripts/search.py "Python machine learning" -s github.com

画像検索の例

# Search for cat images
python3 scripts/search.py "cat" -i

# Search for large landscape images
python3 scripts/search.py "landscape" -i -z l

# Search for icons from specific site
python3 scripts/search.py "logo" -i -z i -s github.com

# Search for recent images
python3 scripts/search.py "sunset" -i -d 7

コンテンツの抽出

# Extract content from a single article
python3 scripts/extract.py "https://example.com/article"

注意事項

API アクセス

• API キー：https://console.byteplus.com/infoquest/infoquests から取得します
• ドキュメント：https://docs.byteplus.com/en/docs/InfoQuest/What_is_Info_Quest
• 概要：InfoQuest は BytePlus が独自に開発した、AI 向けに最適化されたインテリジェントな検索・クロールツールセットです

検索機能

• 時間による絞り込み：過去 N 日以内の検索には -d を使用します（例：-d 7）
• サイトによる絞り込み：サイトを指定した検索には -s を使用します（例：-s github.com）
• 画像検索：画像検索には -i を使用し、必要に応じてサイズを絞り込めます（-z）
• 画像サイズのオプション：l（大）、m（中）、i（アイコン）

画像検索の使い方

画像検索は、画像生成の参照として使用できる画像の URL を返します。各結果には次の情報が含まれます。

• title：画像のタイトルまたは説明
• image_url：画像への直接 URL

使用上のヒント：画像生成で参照画像として image_url の値を使用します。必要に応じて、先にダウンロードしてください。

クイックセットアップ

1. API キーを設定：

   export INFOQUEST_API_KEY=<REPLACE_WITH_YOUR_KEY>
   

2. 必要な Python パッケージをインストール：

   pip install requests
   

3. セットアップをテスト：

   # Test web search
   python3 scripts/search.py "test search"
   
   # Test image search
   python3 scripts/search.py "test" -i
   

エラー処理

API は、次のような場合に "Error:" で始まるエラーメッセージを返します。

• 認証の失敗
• ネットワークのタイムアウト
• 空のレスポンス
• 無効なレスポンス形式
• 無効な画像サイズパラメーター（'l'、'm'、'i' のいずれかを指定する必要があります）

Node.js 版との違い

• Python 3.6+ が必要です
• fetch の代わりに requests ライブラリを使用します
• argparse を使用して引数解析を簡素化しています
• 機能と API エンドポイントは同じです