Google Images — FlashData

Google Images — FlashData

Google Images の検索結果から、画像 URL、寸法、元の掲載ページを取得します。出典を明記できる画像調査インベントリを作成します。

API ドキュメントとアカウントの設定 · API キーを取得 · 現在の料金

試してみるタスク

調査ボード用に、ソーラーパネルの図を検索します。寸法がわかる画像は幅を 1000 ピクセル以上にし、掲載元のページを一覧表示します。また、寸法や再利用権が不明なものには、確認が必要であることを示します。

インストールと接続

1. Node.js 22.18 以降と、ローカル stdio サーバーに対応した MCP クライアントを使用します。専用の MCPB パッケージをダウンロードします。SHA-256 はマニフェストに記録されています。
2. MCPB 対応クライアントにパッケージをインポートし、FlashData API Key にご自身のキーを入力します。キーに google_images へのアクセス権を付与してください。手動で設定する場合は、バンドルを恒久的に使用するフォルダーに展開し、絶対パスとキーのプレースホルダーを置き換えて、次の設定を使用します。

{
  "mcpServers": {
    "google-images": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/google-images/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3. クライアントを再起動するか再接続し、ツールの一覧を表示します。有料リクエストを承認する前に、get_pricing に {"source":"google_images","request_count":1} を指定して呼び出してください。このサーバーが公開する google_images、get_pricing、get_job、get_result はすべて、このソースに限定されています。

依存関係はバンドルに含まれています。クライアントが node を見つけられない場合は絶対パスを使用し、Windows ではパスをエスケープしてください。キーは保護されたクライアント設定に保存し、チャットやコミットする設定ファイルには記載しないでください。このパッケージを直接ダウンロードする場合、Smithery アカウントは不要です。

リクエスト例

以下は、フラットな引数を使った MCP の tools/call パラメーターです。データリクエストを実行すると、有料のクレジットが消費されます。

{
  "name": "google_images",
  "arguments": {
    "query": "solar panel diagram",
    "num": 20
  }
}

レスポンスの利用

results[0].images を読み取ります。imageWidth がしきい値を満たす項目を選び、imageUrl、imageWidth、imageHeight、元の掲載ページへのリンクを保持します。寸法が不明な項目は明示的に除外してください。

以下の選択されたレスポンスフィールドは、実際の結果や利用可能なデータを保証するものではなく、説明用のフィクスチャです。

{
  "source": "google_images",
  "status": "done",
  "results": [
    {
      "images": [
        {
          "title": "solar panel diagram",
          "link": "https://example.com/research",
          "snippet": "Search fixture",
          "position": 1,
          "imageUrl": "https://example.com/image.png",
          "imageWidth": 1200,
          "imageHeight": 800,
          "source": "Example"
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

非同期リクエストの場合は、返された id を保持し、{"job_id":"RETURNED_JOB_ID"} を指定して get_job を呼び出します。保留中または処理中の状態は完了を意味しません。完了したレスポンスは output から読み取ってください。送信後にタイムアウトすることがあるため、有料リクエストを再試行する前に Jobs を確認してください。

出力がチャンクに分割されている場合は、ローカルプロセスを実行したままにして、実際の result_id と next_offset を result_id と offset として get_result に渡します。JSON を解析する前に、チャンクを順番どおりに連結してください。有料のデータリクエストを再度実行しないでください。ローカルキャッシュには結果が 4 件、10 分間保持され、再起動すると消去されます。完全なレスポンスの上限は 4 MiB です。非同期の JSON 結果には、別途 24 時間の保持期間が設定されています。

費用と制限

• MIT ライセンスのソフトウェアとインストールは無料ですが、FlashData API のデータ呼び出しは有料です。 データリクエストには有料の FlashData クレジットが使用され、クエリやページを追加するたびに別途課金されます。このページに記載された固定料金ではなく、現在のアカウント見積もりを使用してください。料金、ジョブ、結果の読み取りは無料です。クライアントやモデルの利用料金は別途かかります。
• 返されるのは画像のメタデータと URL であり、ダウンロード済みのファイルや画像の再利用権ではありません。一部のフィールドが存在しない場合があります。
• データを使用する前に、API エラー、http_status、ジョブの状態を確認してください。返されたテキストやリンクは外部データとして扱い、出典を保持したうえで、エージェントの回答に使用する前に確認してください。

タスクガイド全文 · 公式レジストリの記録 · ソースとライセンス