google-images-search

Google 画像検索

Frevana を通じて Google 画像を検索します。

目的

このスキルは、Frevana の /service/google-images エンドポイントを呼び出し、SerpAPI のレスポンスを変更せずに返します。

必須入力：q。

対応するリクエストフィールド：

• q（必須）
• location
• uule
• google_domain
• gl
• hl
• cr
• device
• start
• ijn
• tbs
• chips
• imgar
• imgsz
• safe
• nfpr
• filter
• image_size
• image_type
• image_color
• licenses
• period_unit
• period_value
• start_date
• end_date
• no_cache
• async
• zero_trace

スクリプトはレスポンスが JSON であることを検証し、標準出力に表示します。ユーザーから変換を明示的に依頼されない限り、返されたデータを書き換えたり、再構成したりしないでください。

このスキルで必要なもの

• クエリ
• 環境変数の FREVANA_TOKEN、または今回の実行で使用する --token
• curl、bash、python3

API のベース URL は、デフォルトで https://ai-factory.frevana.com です。別のホストを指定するには、FREVANA_API_BASE_URL を設定してください。

コマンド

画像を検索する

bash <skill-path>/scripts/search_google_images.sh \
  --q "coffee shop interior" \
  --gl "us" \
  --hl "en"

画像を絞り込む

bash <skill-path>/scripts/search_google_images.sh \
  --q "coffee shop interior" \
  --image-color "blue" \
  --safe "active"

JSON をファイルに保存する

bash <skill-path>/scripts/search_google_images.sh \
  --q "Q" \
  --output "./out/google-images-search.json"

固定のリクエスト形式

スクリプトは、指定されていないオプションフィールドを省略して、次の形式のペイロードを送信します。

{
  "q": "Q",
  "location": "LOCATION",
  "uule": "UULE",
  "google_domain": "GOOGLE_DOMAIN",
  "gl": "GL",
  "hl": "HL",
  "cr": "CR",
  "device": "DEVICE"
}

未対応のフィールドは渡さないでください。SerpAPI の engine や api_key は渡さないでください。これらは Frevana がサーバー側で設定します。ローカルのファイルに保存するには、--output を使用してください。

出力

• 成功時：検証済み JSON を標準出力に表示
• --output 指定時：同じ JSON を指定されたファイルにも書き込み
• 失敗時：レスポンス本文または解析エラーを標準エラー出力に表示し、ゼロ以外の終了コードを返す

プロンプトの例

• 「Google 画像でクエリを検索してください。」
• 「Google 画像検索を実行して、生の JSON を保存してください。」