> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/datasets/ja/guan-li/manage-datasets/dataset-search.md). # データセットを検索する テキストベースの検索クエリとフィルターを使って、Roboflow のデータセットをよりよく理解します。 ## 概要 データセット検索を使うと、ファイル名の検索、構造化されたフィルター（タグ、分割、クラス、寸法、アノテーション数）、ブール論理、自然言語の意味検索を使って、プロジェクト全体から特定の画像を見つけることができます。データの監査、ラベルの誤りや不足しているアノテーションの発見、レビューや書き出し用の対象サブセットの作成に活用できます。これらと同じクエリは、Webアプリと検索REST APIの両方で利用できます。 ## Webアプリ Roboflowでは、ファイル名、検索クエリ、フィルターの組み合わせを使って画像ファイルを検索し、特定の画像を見つけたり、データをより深く理解したりできます。 * **特定のタグが付いた分割内の画像:**\ `tag:factory split:train`\ これはタグフィルターと分割フィルターを使用しています * **意味検索とクラスフィルターを使って不足しているラベルを見つける**:\ `person -class:helmet`\ これは意味検索とクラスフィルターに対する否定フィルターを使用しています * **あるクラスのすべての画像に特定のフィルターが必要な場合:**\ `class:helmet AND NOT (tag:v1 OR tag:v2)`\ これはクラスフィルター、ブール論理、およびタグフィルターを使用しています * **注釈数が少ない横長画像を見つける:**\ `min-width:1000 max-annotations:1`\ これは最小幅フィルターと最大アノテーション数フィルターを使用しています 以下は完全な [検索フィルター](#search-filters)の一覧と、下の例です {% hint style="info" %} これらすべての検索フィルターとクエリは組み合わせて使えます {% endhint %} ### 意味検索 画像を説明することで検索できます。これらのクエリは、検索語句に最も近い画像を検索し、オブジェクトにまだラベルが付いていない場合でも画像を見つけるのに役立ちます。 意味検索は、フィルターセレクターを使わずにテキストクエリを入力したときに発生します（例: `filename:`)
### ファイル名で検索 次のものを使ってファイル名を検索できます `filename:` フィルター、またはファイル名のテキストボックス。これによりクエリが自動生成されます。
### データセット分割で検索 データセットの分割（train、valid、test）で画像を検索します
画像を別の分割に再割り当てするには、それらを選択するか、検索結果から「一致するものをすべて選択」を選び、バルク操作メニューの「データセット分割を変更」をクリックします。大量選択はバックグラウンドで処理されます。 ### アップロード日で検索 次のものを使って、Roboflowに最初にアップロードされた日付で画像を絞り込みます `date:` フィルター。アップロード日は不変であり、画像が編集、再アノテーション、または分割間で移動しても変わりません。 使用 `date:YYYY-MM-DD` で正確な1日を指定するか、比較演算子を組み合わせて範囲を検索します: `date>=2026-01-01 date<2026-02-01` ### 検索フィルター 使用できるフィルターは次のとおりです: * `like-image:`: 画像内容に基づく意味検索 * `tag` : ユーザーが付与したタグで絞り込みます。 * `filename` : 指定されたファイル名に一致するファイル名を検索します。部分一致を実行するには、クエリの先頭と末尾に \* を付けます。 * `split` : 分割（train、test、valid）で絞り込みます。 * `job:` : 指定されたジョブIDを持つ画像を表示します。 * `min-width:X` : 幅が少なくとも X ピクセルの画像を表示します。 * `max-width:X` : 幅が最大 X ピクセルの画像を表示します。 * `min-height:X` : 高さが少なくとも X ピクセルの画像を表示します。 * `max-height:X` : 高さが最大 X ピクセルの画像を表示します。 * `min-annotations:X` : 少なくとも X 個のアノテーションを持つ画像を表示します。 * `max-annotations:X` : 最大 X 個のアノテーションを持つ画像を表示します。次を使用してください `max-annotations:0` アノテーションのない画像を見つけるには。 * `class:CLASS`: 指定されたラベルを持つアノテーションが少なくとも1つある画像を表示します。 * `date:YYYY-MM-DD` : 画像がアップロードされた変更不可能な日付で絞り込みます。比較演算子に対応しています（例: `date>=2026-01-01 date<2026-02-01`). #### ブール論理 AND、OR、NOT、およびかっこを使って複数のフィルターを組み合わせ、複雑なクエリを作成できます。 `class:helmet AND NOT (tag:v1 OR tag:v2)` #### 否定フィルター フィルターの前にマイナス記号を付けると、そのフィルターに一致する画像を除外できます。 `class:helmet -class:vest` #### 数値付きクラスフィルター 画像内のラベル付きアイテム数で絞り込みます。 `class:helmet=3 class:vest>=4` ### API Roboflow上のデータセットや画像も、次のものを通じて検索できます [Search API](#http-api). ## HTTP API REST APIを使って、Roboflowでホストされている画像を検索できます。エンドポイントは2つあります。プロジェクト単位の `https://api.roboflow.com/:workspace/:project/search` エンドポイントと、ワークスペース全体の `https://api.roboflow.com/:workspace/search/v1` エンドポイントで、これは [Webアプリのデータセット検索](#web-app). ### プロジェクト内の画像を検索 Roboflowにホストされている画像を検索するには、次のAPIエンドポイントにPOSTリクエストを送信します: ```url https://api.roboflow.com/:workspace/:project/search ``` APIへのリクエスト例は次のとおりです: ```bash curl -X POST "https://api.roboflow.com/my-workspace/my-project-name/search?api_key=$ROBOFLOW_API_KEY" \ -H 'Content-Type: application/json' \ --data \ '{ "like_image": "image_id", "in_dataset": true, "limit": 125 }' ``` このエンドポイントは、POST本文で次の値を受け付けます: ```json { // 指定された場合、意味的類似度で並べ替えた結果を返します "like_image": string, // 指定された場合、意味的類似度で並べ替えた結果を返します "prompt": string, // 既定値は 0 "offset": int, // 既定値は 50（最大: 250） "limit": int, // 指定された場合、指定したタグを持つ画像を絞り込みます "tag": string, // 指定された場合、指定したクラス名を持つ画像を絞り込みます "class_name": string, // true の場合、URLのプロジェクト内にある画像を絞り込みます "in_dataset": boolean, // 指定された場合、いずれかのバッチに含まれる画像のみを返します "batch": boolean, // 指定された場合、与えられたバッチに含まれる画像のみを返します "batch_id": string, // 指定された場合、いずれかのアノテーションジョブに含まれる画像のみを返します "annotation_job": boolean, // 指定された場合、与えられたアノテーションジョブに含まれる画像のみを返します "annotation_job_id": string, // 返すメディア: 「image」、「video」、または両方。既定値は ["image"] "mediaTypes": string[], // 返すフィールドを指定します。既定値は ["id", "created"] // 選択肢は ["id", "name", "annotations", "labels", "split", "tags", "owner", "url", "embedding", "created"] "fields": string[] } ``` 各結果には `mediaType` の `image` または `video`が含まれます。 `url`を要求すると、動画結果ではポスター画像が `url` に入り、短時間のみ有効なダウンロードリンクが `videoUrl`. 検索APIは、次の構造を持つレスポンスを返します。利用可能な値は、指定した追加の `fields` によって異なります: ```json { "offset": 0, "total": 292, "results": [ { "id": "image123", "name": "humpbackwhale.jpg", "owner": "owner123", "url": "https://source.roboflow.com/owner123/image123/original.jpg", "annotations": { "count": 5, "classes": { "whale": 1, "fish": 4 } }, "labels": [], "tags": [ "cam_x13" ] } // ... など ] } ``` ### ワークスペース全体で画像を検索 Workspace Image Search APIを使うと、ワークスペース内の画像を一覧表示したり検索したりできます。 このAPIでは、次のようなクエリ文字列を使ってフィルタリング、並べ替え、意味検索を実行できます [RoboflowのWebアプリケーションの画像検索機能](#web-app). #### エンドポイント APIにリクエストを送るには、 `POST` リクエストを次のエンドポイントに送信します: ``` https://api.roboflow.com/{WORKSPACE}/search/v1?api_key=API_KEY ``` ここで `WORKSPACE` はワークスペースIDで、 `API_KEY` はAPIキーです。 [ワークスペースIDの見つけ方を学ぶ](https://docs.roboflow.com/reference/authentication/authentication/workspace-and-project-ids). [APIキーの見つけ方を学ぶ。](https://docs.roboflow.com/reference/platform/rest-api/authenticate-with-the-rest-api) #### 認証 APIにアクセスするには、リクエストにAPIキーを含める必要があります。APIキーはクエリパラメータとして渡す必要があります。 例: `?api_key={YOUR_API_KEY}` #### リクエスト形式 **ヘッダー** * `Content-Type: application/json` **ボディパラメータ** * `query` **（必須）**: フィルタリング、並べ替え、または意味検索を実行するための空でない文字列。たとえば: `"nighttime project:{my-project-url}"` は、 `my-project-url` プロジェクト内の画像を絞り込み、 `nighttime`に一致する画像に対して意味的な並べ替えを適用します。欠落しているか空の場合は400エラーを返します。 * `pageSize`: ページごとに返す結果数（既定値: 50）。 * `fields`: レスポンスに含めるフィールドの一覧。取りうる値は `"tags"`, `"width"`, `"height"`, `"filename"`, `"aspectRatio"`, `"split"`, `"projects"`, `"annotations"`, `"labels"`, `"owner"`, `"url"`. * `mediaTypes`: 返すメディア: `"image"`, `"video"`、または両方（既定値: `["image"]`）。結果には `mediaType` と `videoUrl` が含まれます。 [プロジェクト検索](#search-images-in-a-project). **リクエスト例** ```bash curl --location 'https://api.roboflow.com/{WORKSPACE}/search/v1?api_key={API_KEY}' \ --header 'Content-Type: application/json' \ --data '{ "query": "project:foo nightime", "pageSize": 10, "fields": ["tags", "width", "height", "filename", "aspectRatio", "split"] }' ``` #### レスポンス形式 レスポンスは次のフィールドを含むJSONオブジェクトです: * `results`: 画像オブジェクトの配列。 * `total`: 見つかった画像の総数。 * `continuationToken`: ページネーション用のトークン。 **画像オブジェクトのフィールド** で要求されたフィールドに応じて、 `fields` パラメータ: * `id`: 画像の一意識別子。 * `projectData`: プロジェクトURLをキーとするオブジェクトで、プロジェクト固有のデータを含みます: * `split`: データセットの分割を示します（例: "test"）。次の場合に返されます `"split"` は `fields`. * `inDataset`: 画像がデータセット内にあるかどうかを示すブール値。次の場合に返されます `"projects"` は `fields`. * `annotations`: このプロジェクトにおける画像のアノテーションデータ。以下を含みます `annotationGroup`, `classes`、および `classCounts`. 次の場合に返されます `"annotations"` は `fields`. * `labels`: このプロジェクトにおける画像のラベルデータ。次の場合に返されます `"labels"` は `fields`. * `tags`: 画像に関連付けられたタグの配列。 * `width`: 画像の幅（ピクセル）。 * `height`: 画像の高さ（ピクセル）。 * `filename`: 画像ファイル名。 * `aspectRatio`: 画像のアスペクト比。 * `owner`: 画像の所有者識別子。 * `url`: 元の画像ファイルへの直接URL。 **ページネーションと `continuationToken`** 返される `continuationToken` は、検索結果に一致するページ間を移動するために使えます。 `continuationToken` が後続のリクエストに含まれると、次の結果セットを取得します。 次のものを使うには `continuationToken`、次のAPI呼び出しのリクエスト本文に含めてください。これにより、元のクエリに基づく次のページの結果が取得されます。 **エラー応答** * `400` - 次の場合に返されます `query` が欠落しているか空である場合、または `project:` フィルターが、ワークスペースに属さないプロジェクトを参照している場合。 * `500` - 内部サーバーエラー。 **プロジェクトおよびデータセットのフィルター** 次のものですべてのフィルターに加えて [アプリ内のデータセット検索](#web-app)、ワークスペース全体検索では次のフィルターもサポートしています `project` と `dataset` 。たとえば、次のようなクエリを使えます `project:foo project:bar` 両方のプロジェクトに含まれるすべての画像を見つけるために `foo` と `bar`。\ \ 次のようなクエリでは `dataset:foo`プロジェクト内の画像を返します `foo` ラベル付けされており、プロジェクト内のデータセットに追加されているものです。 ## Python SDK `Project.search_all()` は、プロジェクト内の画像全体に対する検索結果のページネーション付きイテレータを返します。検索モードは組み合わせ可能です。たとえば、クラスで絞り込んだテキストプロンプト、単一バッチに絞り込んだ既存画像の類似検索などです。 ```python import roboflow rf = roboflow.Roboflow(api_key="YOUR_API_KEY") project = rf.workspace().project("my-detector") records = [] for page in project.search_all( prompt="mug on a desk", class_name="mug", in_dataset=True, limit=100, fields=["id", "created", "name", "labels"], ): records.extend(page) print(len(records)) ``` ### パラメータ * `prompt` (str, オプション) - 自然言語の検索プロンプト（CLIP埋め込みによるセマンティック検索）。 * `like_image` (str, オプション) - テキストではなく視覚的類似性で検索するための画像ID。 * `tag` (str, オプション) - このタグを持つ画像のみ。 * `class_name` (str, オプション) - このクラスのアノテーションを持つ画像のみ。 * `in_dataset` (bool, オプション) - 結果をプロジェクトのデータセット内の画像に限定し、バッチ／アノテーションジョブのステージング領域を除外するかどうか。 * `batch` (bool, オプション) と `batch_id` (str, オプション) - 特定のアップロードバッチに限定します。 * `annotation_job` (bool, キーワード専用) と `annotation_job_id` (str, キーワード専用) - 特定のアノテーションジョブに限定します。 * `offset` (int, デフォルト `0`) - ページネーションのオフセット。 * `limit` (int, デフォルト `100`) - 1ページの件数。 * `fields` (list\[str], オプション) - 応答サイズを削減するため、各結果で一覧にあるフィールドのみを要求します。 `search_all()` ジェネレーターです。各反復で最大 `limit` 件の結果を返し、オフセットは自動的に進みます。単発の1ページ呼び出しには `project.search(...)` を同じ引数で使用します。 ### ワークスペース全体の検索 ワークスペース内のすべてのプロジェクトを検索するには、 `Workspace.search()` / `Workspace.search_all()`。プロジェクト単位のメソッドとは異なり、これらは1つの RoboQL `query` 文字列（たとえば `"class:forklift"`, `"tag:review"`、またはセマンティックCLIP検索用の自由記述テキスト）と、任意の `page_size` と `fields`。返される各ページは結果行のリストで、各行にはソースプロジェクトが `projects` フィールドとして含まれます。 ```python records = [] for page in rf.workspace().search_all(query="class:forklift")】【：】【“】【t_42e022e3":"検索結果をダウンロード可能なデータセットとしてエクスポート","t_c808a37a":"Workspace.search_export()","t_836e3d65":"検索を実行し、結果をダウンロード可能なデータセット（COCO / YOLO / VOC など）にまとめます。詳細は","t_421144e8":"データのエクスポート（REST）","t_a245df17":"基盤となるエンドポイントについては","t_d093a336":"path = rf.workspace().search_export(","t_a12dc0f4":"query=\"forklift\",","t_76f35285":"format=\"coco\",","t_09594d46":"location=\"./forklift-search\",","t_8678b83b":"print(path)","t_db9f12bb":"CLI","t_d3c5accd":"ワークスペース全体で画像を検索するには","t_72745af6":"RoboQL","t_7c87cc3b":"を使い、必要に応じて一致した結果をダウンロード可能なデータセットとしてエクスポートできます。","t_fe537c91":"検索","t_fd7afa42":"roboflow search \"\"","t_2ea35990":"オプション","t_3f891a5a":"フラグ","t_2a501eea":"説明","t_5f76053b":"--limit","t_61d13cd6":"返す最大結果数（デフォルト: 50）","t_ba304ea1":"--cursor","t_eebf3010":"ページネーション用の継続トークン","t_c1266532":"--fields","t_624764f5":"含めるフィールドのカンマ区切りリスト","t_0455870a":"例","t_4497ad7b":"特定のタグを持つ画像を検索:","t_3ada2e7c":"roboflow search \"tag:reviewed\"","t_dc3583f6":"特定のクラスを含む画像を検索:","t_bb693710":"roboflow search \"class:person\" --limit 100","t_db103f86":"検索結果のエクスポート","t_812f35ad":"追加","t_6c0c1f18":"--export","t_365a02f3":"一致する画像をデータセットとしてダウンロードするには:","t_96a1cd23":"roboflow search \"\" --export -f -l ","t_0e12d16a":"エクスポートオプション","t_68b121f0":"エクスポートモードを有効にする","t_5d1613f5":"-f","t_e58d184d":"--format","t_0723fde7":"アノテーション形式（デフォルト: coco）","t_ee8dabbb":"-l","t_2fdf335b":"--location","t_dc03805a":"エクスポートを保存するローカルディレクトリ","t_a7626469":"-d","t_45a353f3":"--dataset","t_73ae6bf1":"特定のプロジェクトに限定する","t_8388dffd":"-g","t_073c7578":"--annotation-group","t_1ff874bd":"特定のアノテーショングループに限定する","t_a7cba1c9":"--name","t_877c3f0a":"エクスポートの任意の名前","t_df7959f7":"--no-extract","t_af868570":"zipファイルを保持し、展開をスキップする","t_43b0615b":"レビュー済みの画像をすべて COCO形式でエクスポート:","t_4143800e":"roboflow search \"tag:reviewed\" --export -f coco -l ./reviewed-export","t_5569e0e7":"特定のプロジェクトの画像を YOLOv8 形式でエクスポート:","t_715c0153":"roboflow search \"class:car\" --export -d my-project -f yolov8 -l ./cars","t_eb547cca":"JSON出力","t_60b672ec":"roboflow search \"tag:reviewed\" --json","t_47da1625":"\"results\": [...],","t_6491c17b":"\"total\": 42,","t_f8624817":"\"cursor\": \"next-page-token\"","t_16a78a26":"次の","t_516195f5":"cursor","t_70551b5c":"値をページネーションに使用します:","t_9788545b":"roboflow search \"tag:reviewed\" --cursor \"next-page-token\" --json","t_c05dbffb":"MCPサーバー","t_91455d83":"AIエージェントを","t_0662e3d0":"に接続すると、次のツールで画像を検索できます:","t_423ac156":"ツール","t_10de3783":"images_search","t_81cb3e42":"プロジェクト内の画像を検索します。","t_d81bbd41":"images_workspace_search","t_7588b0e0":"RoboQLを使ってワークスペース全体の画像を検索します。"} }]} }]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}] }]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}] }]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]} ]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}] }]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}] }]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}] }]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}] }]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]} }]}]}]}]}]}]}]}]}]}]}]}]}] }]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}] }]}]}]}]}]}]}]}]}]}]}]}]}] }]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}] }]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}] }]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}] }]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}] }]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}] }]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}] }]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}], records.extend(page) ``` ### 検索結果をダウンロード可能なデータセットとしてエクスポート `Workspace.search_export()` 検索を実行し、結果をダウンロード可能なデータセット（COCO / YOLO / VOC など）にまとめます。詳細は [データのエクスポート（REST）](/datasets/ja/bjon/dataset-versions/exporting-data.md#http-api) 基盤となるエンドポイントについては ```python path = rf.workspace().search_export( query="forklift", format="coco", location="./forklift-search", ) print(path) ``` ## CLI ワークスペース全体で画像を検索するには [RoboQL](/datasets/ja/guan-li/manage-datasets/dataset-search.md) を使い、必要に応じて一致した結果をダウンロード可能なデータセットとしてエクスポートできます。 ### 検索 ```bash roboflow search "" ``` #### オプション | フラグ | 説明 | | ---------- | ------------------ | | `--limit` | 返す最大結果数（デフォルト: 50） | | `--cursor` | ページネーション用の継続トークン | | `--fields` | 含めるフィールドのカンマ区切りリスト | #### 例 特定のタグを持つ画像を検索: ```bash roboflow search "tag:reviewed" ``` 特定のクラスを含む画像を検索: ```bash roboflow search "class:person" --limit 100 ``` ### 検索結果のエクスポート 追加 `--export` 一致する画像をデータセットとしてダウンロードするには: ```bash roboflow search "" --export -f -l ``` #### エクスポートオプション | フラグ | 説明 | | -------------------------- | ---------------------- | | `--export` | エクスポートモードを有効にする | | `-f`, `--format` | アノテーション形式（デフォルト: coco） | | `-l`, `--location` | エクスポートを保存するローカルディレクトリ | | `-d`, `--dataset` | 特定のプロジェクトに限定する | | `-g`, `--annotation-group` | 特定のアノテーショングループに限定する | | `--name` | エクスポートの任意の名前 | | `--no-extract` | zipファイルを保持し、展開をスキップする | #### 例 レビュー済みの画像をすべて COCO形式でエクスポート: ```bash roboflow search "tag:reviewed" --export -f coco -l ./reviewed-export ``` 特定のプロジェクトの画像を YOLOv8 形式でエクスポート: ```bash roboflow search "class:car" --export -d my-project -f yolov8 -l ./cars ``` ### JSON出力 ```bash roboflow search "tag:reviewed" --json ``` ```json { "results": [...], "total": 42, "cursor": "next-page-token" } ``` 次の `cursor` 値をページネーションに使用します: ```bash roboflow search "tag:reviewed" --cursor "next-page-token" --json ``` ## MCPサーバー AIエージェントを [MCPサーバー](https://docs.roboflow.com/agents/mcp-server) に接続すると、次のツールで画像を検索できます:
ツール説明
images_searchプロジェクト内の画像を検索します。
images_workspace_searchRoboQLを使ってワークスペース全体の画像を検索します。