> 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 のデータセットをよりよく理解します。

## 概要

データセット検索では、ファイル名による検索、構造化フィルター（タグ、分割、クラス、寸法、アノテーション数）、ブール論理、自然言語によるセマンティック検索を使って、プロジェクト内の特定の画像を見つけることができます。データの監査、誤ったラベルや不足しているアノテーションの検出、レビューやエクスポート用の対象を絞ったサブセットの作成に活用できます。同じクエリをウェブアプリと検索 REST API の両方で使用できます。

## ウェブアプリ

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:`)

<figure><img src="https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-252e7735b8f04fdeb7b567c8a73c783ba42c7ba0%2Fimage%20(355).png?alt=media" alt=""><figcaption></figcaption></figure>

### ファイル名で検索

ファイル名は、 `filename:` フィルターまたはファイル名入力欄を使って検索できます。入力欄を使うと、クエリが自動的に作成されます。

<figure><img src="https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-007ef7663b94243be3a88de95df3a6fe6345bf5f%2Fimage%20(354).png?alt=media" alt="" width="192"><figcaption></figcaption></figure>

### データセットの分割で検索

データセットの分割（train、valid、test）で画像を検索します

<figure><img src="https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-42804a6e68a1551a7f23c0fe1746da8231fb5b02%2Fimage%20(356).png?alt=media" alt="" width="257"><figcaption></figcaption></figure>

画像を別の分割に再割り当てするには、画像を選択し（検索結果から「一致する項目をすべて選択」を選ぶこともできます）、一括操作メニューの「データセットの分割を変更」をクリックします。大量の選択はバックグラウンドで処理されます。

### アップロード日で検索

Roboflow に初めてアップロードされた日付で画像を絞り込むには、 `date:` フィルターを使います。アップロード日は変更できず、画像の編集、再アノテーション、分割間の移動を行っても変わりません。

正確な日付を指定するには、 `date:YYYY-MM-DD` を使います。期間を検索するには、比較演算子を組み合わせます：

`date>=2026-01-01 date<2026-02-01`

時刻で検索するには、UTC のタイムスタンプを引用符で囲んで指定します（例： `date>="2026-10-01T09:30:00Z"`）。検索バーの `date` フィルターには、ユーザーのタイムゾーンで指定できる「開始」と「終了」の日付選択欄もあります。

### 検索フィルター

使用できるフィルターは次のとおりです：

* `like-image:<IMAGE_ID>`：画像の内容に基づくセマンティック検索
* `tag` ：ユーザーが指定したタグで絞り込みます。
* `filename` ：指定したファイル名に一致するファイル名を検索します。部分一致で検索するには、クエリの先頭と末尾に \* を付けます。
* `split` ：split（train、test、valid）で絞り込みます。
* `job:<JOB_ID>` ：指定したジョブ 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` ：画像がアップロードされた変更不可能な日付で絞り込みます。比較演算子と UTC タイムスタンプに対応しています（例： `date>=2026-01-01 date<"2026-02-01T12:00:00Z"`).

#### ブール論理

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

検索エンドポイントは 2 つあります。1 つは単一のプロジェクトを検索し、もう 1 つは、 [ウェブアプリのデータセット検索](#web-app).

### プロジェクト内の画像を検索

プロジェクトの画像をタグ、クラス、バッチ、アノテーションジョブ、またはデータセットへの所属で絞り込みます。 `prompt` を追加するとテキストの説明で結果を並べ替え、 `like_image` を追加すると別の画像との類似度で並べ替えられます。 `offset` と `limit`.

{% openapi src="/files/f283bb3b2e6021303880a8da725f3f8a48dbbc39" path="/{workspace}/{project}/search" method="post" %}
[dataset-search.yaml](https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-3bf42847152663cfead69cbf3ebf988912a834a4%2Fdataset-search.yaml?alt=media)
{% endopenapi %}

### を使って、ワークスペース全体から画像を検索

RoboQLを送信する `query` と、次の [検索フィルター](#search-filters)を使用できます。クエリ内の自由テキストはセマンティック検索を実行します。ここでは、さらに2つのフィルターが使えます。 `project:foo` はプロジェクト `foo`内の画像を返し、 `dataset:foo` はプロジェクト `foo`のデータセット内の画像を返します。同じフィルターを繰り返すと、両方の条件が必須になります（例： `project:foo project:bar`）。空のクエリは、ワークスペース内のすべての画像を返します。

次のページを取得するには、同じクエリを指定して、レスポンスに含まれる `continuationToken` を送信します。

{% openapi src="/files/f283bb3b2e6021303880a8da725f3f8a48dbbc39" path="/{workspace}/search/v1" method="post" %}
[dataset-search.yaml](https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-3bf42847152663cfead69cbf3ebf988912a834a4%2Fdataset-search.yaml?alt=media)
{% endopenapi %}

## 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, optional) - 自然言語による検索プロンプト（CLIP埋め込みを使用したセマンティック検索）。
* `like_image` (str, optional) - テキストの代わりに視覚的類似性で検索する画像ID。
* `tag` (str, optional) - このタグが付いた画像のみ。
* `class_name` (str, optional) - このクラスのアノテーションがある画像のみ。
* `in_dataset` (bool, optional) - プロジェクトのデータセット内の画像に結果を限定するかどうか。バッチ／アノテーションジョブのステージング領域は除外されます。
* `batch` (bool, optional) と `batch_id` (str, optional) - 特定のアップロードバッチに限定します。
* `annotation_job` (bool, kw-only) と `annotation_job_id` （str、キーワード専用）- 特定のアノテーションジョブに限定します。
* `offset` （int、デフォルト `0`）- ページネーションのオフセット。
* `limit` （int、デフォルト `100`）- ページサイズ。
* `fields` （list\[str]、任意）- レスポンスサイズを削減するため、各結果で指定したフィールドのみを要求します。

`search_all()` はジェネレーターです。反復するたびに、最大 `limit` 件の結果を含むページを返し、オフセットを自動的に進めます。1回だけ単一ページを取得するには、同じ引数を使って `project.search(...)` を使用します。

### ワークスペース全体の検索

ワークスペース内のすべてのプロジェクトを検索するには、 `Workspace.search()` / `Workspace.search_all()`を使用します。プロジェクト単位のメソッドとは異なり、これらのメソッドでは単一の RoboQL `query` 文字列（例： `"class:forklift"`, `"tag:review"`、またはセマンティックCLIP検索用のフリーテキスト）に加え、任意で `page_size` と `fields`を指定します。各ページとして返されるのは結果行のリストで、各行にはソースプロジェクトが `projects` フィールドに含まれます。

```python
records = []
for page in rf.workspace().search_all(query="class:forklift"):
    records.extend(page)
```

### 検索結果をダウンロード可能なデータセットとしてエクスポートする

`Workspace.search_export()` は検索を実行し、結果をダウンロード可能なデータセット（COCO / YOLO / VOC など）としてまとめます。このメソッドはPlatform APIの [検索エクスポートエンドポイント](https://docs.roboflow.com/reference/platform/rest-api/platform-api-openapi#search) を呼び出します。

```python
path = rf.workspace().search_export(
    query="forklift",
    format="coco",
    location="./forklift-search",
)
print(path)
```

## CLI

ワークスペース全体の画像を検索するには、 [RoboQL](https://docs.roboflow.com/datasets/ja/guan-li/manage-datasets/dataset-search.md) を使用します。また、検索条件に一致する結果をダウンロード可能なデータセットとしてエクスポートすることもできます。

### 検索

```bash
roboflow search "<query>"
```

#### オプション

| フラグ        | 説明                      |
| ---------- | ----------------------- |
| `--limit`  | 返す結果の最大数（デフォルト: 50）     |
| `--cursor` | ページネーション用の続行トークン        |
| `--fields` | 含めるフィールドをカンマ区切りで指定したリスト |

#### 使用例

特定のタグが付いた画像を検索します：

```bash
roboflow search "tag:reviewed"
```

特定のクラスを含む画像を検索します：

```bash
roboflow search "class:person" --limit 100
```

### 検索結果をエクスポート

追加 `--export` を指定すると、一致する画像をデータセットとしてダウンロードできます：

```bash
roboflow search "<query>" --export -f <format> -l <location>
```

#### エクスポートオプション

| フラグ                        | 説明                      |
| -------------------------- | ----------------------- |
| `--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) 以下のツールで画像を検索できます。

<table data-search="false"><thead><tr><th width="290">ツール</th><th>説明</th></tr></thead><tbody><tr><td><code>images_search</code></td><td>プロジェクト内の画像を検索します。</td></tr><tr><td><code>images_workspace_search</code></td><td>RoboQLを使用してワークスペース全体から画像を検索します。</td></tr></tbody></table>
