> ## Documentation Index
> Fetch the complete documentation index at: https://adcp-docs-ja.pier1.co.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# get_rights

> get_rights はライセンス可能なタレント、音楽、ストックメディアを発見するための AdCP タスク。自然言語で検索し、価格オプション付きのマッチを取得し、バイヤーブランドの互換性でフィルタリングします。

ブランドエージェントのロスター全体でライセンス可能な権利を検索します。価格オプション付きのマッチを返します。探索は自然言語ファースト — タクソノミーなし、LLM がクエリから意図を解釈します。

## スキーマ

* **リクエスト**: [`get-rights-request.json`](https://adcontextprotocol.org/schemas/latest/brand/get-rights-request.json)
* **レスポンス**: [`get-rights-response.json`](https://adcontextprotocol.org/schemas/latest/brand/get-rights-response.json)

## 応答時間

通常2〜10秒。エージェントがバイヤーの brand.json に対して互換性チェックを行う場合、遅延が増加します。

## クイックスタート

<CodeGroup>
  ```json リクエスト theme={null}
  {
    "query": "Dutch athlete for restaurant brand in Amsterdam, budget 400 EUR/month",
    "uses": ["likeness", "voice"],
    "buyer_brand": { "domain": "bistro-oranje.nl" },
    "include_excluded": true
  }
  ```

  ```json レスポンス theme={null}
  {
    "rights": [
      {
        "rights_id": "janssen_likeness_voice",
        "brand_id": "daan_janssen",
        "name": "Daan Janssen",
        "description": "Dutch Olympic speed skater, 2x gold medalist",
        "right_type": "talent",
        "match_score": 0.92,
        "match_reasons": [
          "Available for food/restaurant brands in NL",
          "Within budget at 350 EUR/month",
          "Athletic brand aligns with Bistro Oranje's quality positioning"
        ],
        "available_uses": ["likeness", "voice", "name", "endorsement"],
        "countries": ["NL", "BE", "DE"],
        "pricing_options": [
          {
            "pricing_option_id": "cpm_endorsement",
            "model": "cpm",
            "price": 3.50,
            "currency": "EUR",
            "uses": ["likeness"],
            "description": "Per-impression royalty for AI-generated creatives using likeness"
          },
          {
            "pricing_option_id": "monthly_exclusive",
            "model": "flat_rate",
            "price": 350,
            "currency": "EUR",
            "period": "monthly",
            "uses": ["likeness", "voice"],
            "impression_cap": 100000,
            "overage_cpm": 4.00,
            "description": "Monthly exclusive license for likeness + voice, up to 100K impressions"
          }
        ],
        "content_restrictions": ["approval_required"],
        "preview_assets": [
          { "url": "https://cdn.lotientertainment.com/janssen/headshot.jpg", "usage": "preview_only" }
        ]
      }
    ],
    "excluded": [
      {
        "brand_id": "pieter_van_dijk",
        "name": "Pieter van Dijk",
        "reason": "Dietary lifestyle conflict with steakhouse brand",
        "suggestions": ["Available for plant-based and health food brands"]
      }
    ]
  }
  ```
</CodeGroup>

## パラメーター

### リクエスト

| フィールド              | 型         | 必須  | 説明                                                       |
| ------------------ | --------- | --- | -------------------------------------------------------- |
| `query`            | string    | Yes | 希望する権利の自然言語での説明。予算、地域、ユースケースを含めます。                       |
| `uses`             | string\[] | Yes | リクエストする権利の使用（`likeness`、`voice`、`name`、`endorsement` など） |
| `buyer_brand`      | brand-ref | No  | バイヤーのブランド。エージェントが互換性フィルタリングのためにバイヤーの brand.json を取得します。  |
| `countries`        | string\[] | No  | 権利が必要な国（ISO 3166-1 alpha-2）                              |
| `brand_id`         | string    | No  | 特定のブランドの権利内を検索                                           |
| `right_type`       | string    | No  | 権利タイプでフィルタリング（`talent`、`music`、`stock_media` など）         |
| `include_excluded` | boolean   | No  | フィルタリングされた結果を理由とともに `excluded` 配列に含めます。デフォルトは false。     |
| `pagination`       | object    | No  | 大きな結果セットのページネーションパラメーター                                  |

### レスポンス

| フィールド                           | 型         | 説明                                               |
| ------------------------------- | --------- | ------------------------------------------------ |
| `rights`                        | object\[] | 価格付きのマッチ、関連性順でランク付け                              |
| `rights[].rights_id`            | string    | このオファリングの識別子 — `acquire_rights` で参照される           |
| `rights[].brand_id`             | string    | ブランド識別子                                          |
| `rights[].name`                 | string    | 表示名                                              |
| `rights[].match_score`          | number    | 関連性スコア（0〜1）                                      |
| `rights[].match_reasons`        | string\[] | この結果がマッチする理由                                     |
| `rights[].available_uses`       | string\[] | 利用可能な権利の使用                                       |
| `rights[].countries`            | string\[] | 利用可能な国                                           |
| `rights[].excluded_countries`   | string\[] | 可用性から除外された国                                      |
| `rights[].exclusivity_status`   | object    | 現在の独占可用性（`available`、`existing_exclusives`）      |
| `rights[].pricing_options`      | object\[] | 価格オプション（以下参照）                                    |
| `rights[].description`          | string    | 権利の対象の説明                                         |
| `rights[].right_type`           | string    | 権利のタイプ（`talent`、`music`、`stock_media` など）        |
| `rights[].content_restrictions` | string\[] | コンテンツ制限または承認要件                                   |
| `rights[].preview_assets`       | object\[] | 評価用のプレビューのみのアセット                                 |
| `excluded`                      | object\[] | 理由付きのフィルタリング済み結果（`include_excluded: true` の場合のみ） |
| `excluded[].suggestions`        | string\[] | 除外が修正可能な場合の実行可能な代替案。除外が最終的な場合は省略。                |

### 権利価格オプション

価格オプションは権利に特有 — 期間、インプレッション上限、超過レート、使用タイプのスコーピングを含みます:

| フィールド               | 型         | 必須  | 説明                                       |
| ------------------- | --------- | --- | ---------------------------------------- |
| `pricing_option_id` | string    | Yes | `acquire_rights` と `report_usage` で参照される |
| `model`             | string    | Yes | 価格モデル（`cpm`、`flat_rate` など）              |
| `price`             | number    | Yes | 価格金額                                     |
| `currency`          | string    | Yes | ISO 4217 通貨コード                           |
| `uses`              | string\[] | Yes | このオプションでカバーされる権利の使用                      |
| `period`            | string    | No  | 請求期間（`monthly`、`quarterly` など）           |
| `impression_cap`    | integer   | No  | 期間あたりの最大インプレッション数                        |
| `overage_cpm`       | number    | No  | 上限を超えたインプレッションの CPM                      |

## 複合権利

複数の使用をリクエスト（例: `["likeness", "voice"]`）すると、エージェントはそれらを単一の価格オプションにバンドルします。1回の呼び出し、1つの価格。

## バイヤーブランドフィルタリング

`buyer_brand` が提供されると、エージェントはバイヤーの brand.json を取得して互換性フィルタリングに使用します。例えば、ベジタリアンのアスリートはステーキハウスのキャンペーンから除外されます。フィルタリングされた結果と理由を見るには `include_excluded: true` を設定します。

## 音楽ライセンスと DDEX

<Note>このセクションは音楽権利エージェントを構築する実装者向け。ブランドプロトコルを使用するバイヤーであれば、標準の `get_rights` と `acquire_rights` フローは音楽でも同じように機能する — DDEX を知る必要はない。</Note>

権利プロトコルはタレント権利と並行して音楽ライセンスをサポートします。音楽シンクプラットフォームは `right_type: "music"` で `get_rights` を実装し、シンク/バックグラウンド使用の価格オプションを返します。

AdCP の権利モデルは [DDEX](https://ddex.net/) の Party Information Exchange (PIE) パターンを参考にしている — 各 `get_rights` レスポンスは以前の状態に対するデルタではなく、現在の可用性のステートレスなスナップショットです。DDEX を熟知している実装者向けのマッピング:

| AdCP コンセプト             | DDEX の同等物             | 備考                                          |
| ---------------------- | --------------------- | ------------------------------------------- |
| `rights_id`            | ISRC / ISWC           | AdCP はエージェントスコープの ID を使用; 標準識別子は `ext` に含める |
| `available_uses`       | 使用タイプ（シンク、バックグラウンドなど） | AdCP は `right-use` enum 値を使用                |
| `pricing_options`      | ライセンスオファー             | 同じコンセプト、異なる構造                               |
| `content_restrictions` | 地域/使用制限               | AdCP は DDEX より粒度が低い                         |
| `acquire_rights`       | ライセンス付与               | AI 音楽制作の生成資格情報を返す                           |

音楽権利エージェントは、既存の音楽ライセンスシステムとの相互運用性のために、権利レスポンスの `ext` フィールドに標準識別子（ISRC、ISWC）を含めるべきです。

## 次のステップ

権利オファリングを選択した後:

1. 選択したブランドの完全なアイデンティティデータを取得するために [`get_brand_identity`](/docs/brand-protocol/tasks/get_brand_identity) を呼び出す
2. `rights_id` と `pricing_option_id` を使って [`acquire_rights`](/docs/brand-protocol/tasks/acquire_rights) を呼び出す