> ## 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.

# SDK を選ぶ

> あなたの言語の AdCP SDK を選ぶ。カバレッジマトリクス、インストールコマンド、各 SDK が L0–L3 で出荷するもの — そのため L4 ビジネスロジックに集中できる。

AdCP SDK は L0–L3（ワイヤー、署名、認証、プロトコルセマンティクス）を吸収するため、あなたは L4 ビジネスロジックを書きます。既にいる言語の SDK を選んでください — 3 つの SDK すべてが同じワイヤー適合性のラインをターゲットにします。

この背後にある層モデル — 各層が何を含み、各層の SDK が何を提供すべきか — については [SDK スタックリファレンス](/docs/building/cross-cutting/sdk-stack) を参照。

## カバレッジマトリクス

各層で「出荷済み」が何を意味するかは [L0–L3 チェックリスト](/docs/building/cross-cutting/sdk-stack#what-an-sdk-at-each-layer-should-provide) です。

*最終更新: 2026-05-03。*

| SDK                  | Production GA | Beta / dev |  L0 |  L1 |  L2 |  L3 |
| -------------------- | ------------- | ---------- | :-: | :-: | :-: | :-: |
| **`@adcp/sdk`** (TS) | `6.9.0`       | —          |  ✅  |  ✅  |  ✅  |  ✅  |
| **`adcp`** (Python)  | `3.x`         | `4.x`      |  ✅  |  ⚠️ |  ⚠️ |  ⚠️ |
| **`adcp-go`**        | —             | `v1.x`     |  ⚠️ |  ❌  |  ❌  |  ❌  |

凡例: ✅ 出荷済み · ⚠️ 部分的 / 進行中 · ❌ まだ未カバー。**Production GA** は今日ピン留めすべきラインです。**Beta / dev** は次のメジャーで進行中のものです。

**`@adcp/sdk` 6.x は完全な L0–L3 を出荷します**（AdCP 3.0）— 採用者は L4 のみを書きます。5.x ラインはセキュリティのみのサポートで新しいビルドに推奨されません。6.x に切り替えてください。**`adcp`（Python）3.x は本番ライン** で、完全な L0 型カバレッジ付き。4.x 書き直し（PyPI でベータ）が L1–L3 のギャップを閉じます — アウトバウンド RFC 9421 署名、ブランド解決ヘルパー、webhook 発出。4.0 GA カットについては [adcp-client-python リリース](https://github.com/adcontextprotocol/adcp-client-python/releases) を追跡してください。**`adcp-go`** は活発に開発中で、型 + トランスポートが最初に着地します。リリースごとに何がスコープ内かは [adcp-go README](https://github.com/adcontextprotocol/adcp-go) を参照。

3.0 以前の呼び出し元は、アップグレード前に [3.0 移行ガイド](/docs/reference/migration/index) を進めるべきです。公開されたすべてのプロトコルバージョンの一目でのステータスについては [バージョンと互換性](/docs/reference/versions) を参照。サポートウィンドウの調達グレードのコンテキストについては、[v2 サンセットタイムライン](/docs/reference/v2-sunset) と [バージョニングとガバナンス](/docs/reference/versioning) を参照。

**Python と TypeScript は、ファーストクラスのサポート言語として完全な L0–L4 カバレッジを運びます。** **Go** は同じ方向に動いています。**他の言語** は公式ロードマップにありません。コミュニティ保守のポートは歓迎されます — [Builders Working Group](/docs/community/working-group) と [Slack コミュニティ](https://join.slack.com/t/agenticads/shared_invite/zt-3c5sxvdjk-x0rVmLB3OFHVUp~WutVWZg) を参照。

## JavaScript / TypeScript

[![npm version](https://img.shields.io/npm/v/@adcp/sdk)](https://www.npmjs.com/package/@adcp/sdk)

```bash theme={null}
npm install @adcp/sdk
```

```javascript theme={null}
import { createSingleAgentClient } from '@adcp/sdk';

const client = createSingleAgentClient({
  id: 'sales',
  name: 'Sales agent',
  agent_uri: 'https://sales.example.com/mcp',
  protocol: 'mcp',
});

const products = await client.getProducts({
  brief: 'Video campaign for pet owners',
});
```

**リソース:**

* [NPM Package](https://www.npmjs.com/package/@adcp/sdk)
* [GitHub Repository](https://github.com/adcontextprotocol/adcp-client)

**パッケージエクスポート:**

* `@adcp/sdk` — メインエントリ: 呼び出し元（`createSingleAgentClient`、`ADCPMultiAgentClient`）と共有型
* `@adcp/sdk/server` — エージェント側サーバープリミティブ（`createAdcpServerFromPlatform`、`createAdcpServer`、決定プラットフォームインターフェース）
* `@adcp/sdk/server/legacy/v5` — レガシー v5 ハンドラーバッグエントリ、移行中盤のコードベース向けにまだサポート
* `@adcp/sdk/signing` — RFC 9421 署名プリミティブ
* `@adcp/sdk/signing/server` — webhook + リクエスト検証者（`createWebhookVerifier`、`verifyRequestSignature`、`createExpressVerifier`）
* `@adcp/sdk/signing/client` — アウトバウンド署名（`signRequest`、`signWebhook`、`createSigningFetch`）
* `@adcp/sdk/testing` — バイヤー側ストーリーボードランナー（`runStoryboard`、`comply`、`testAgent`）とセラー側コントローラースキャフォールド（`createComplyController` — [Get Test-Ready](/docs/building/verification/get-test-ready) を参照）
* `@adcp/sdk/conformance` — 適合性ハーネスのためのアサーション + ストーリーボードヘルパー
* `@adcp/sdk/schemas` — バンドルされた AdCP JSON Schema
* `@adcp/sdk/types` — TypeScript 型定義
* `@adcp/sdk/types/v2-5` — クロスバージョン呼び出し元のための v2.5 型共存インポート

## Python

[![PyPI version](https://img.shields.io/pypi/v/adcp)](https://pypi.org/project/adcp/)

```bash theme={null}
pip install adcp
```

```python theme={null}
from adcp import ADCPClient, AgentConfig, Protocol, GetProductsRequest

client = ADCPClient(AgentConfig(
    id='sales',
    agent_uri='https://sales.example.com/mcp',
    protocol=Protocol.MCP,
))

result = await client.get_products(
    GetProductsRequest(brief='Video campaign for pet owners'),
)
```

**リソース:**

* [PyPI Package](https://pypi.org/project/adcp/)
* [GitHub Repository](https://github.com/adcontextprotocol/adcp-client-python)

## Go

```bash theme={null}
go get github.com/adcontextprotocol/adcp-go/adcp
```

Go SDK は、型付きツール登録、レスポンスビルダー、コンプライアンステストコントローラーを提供します。型は正準 AdCP スキーマから生成されます。

| Component  | Import                                                                                                       |
| ---------- | ------------------------------------------------------------------------------------------------------------ |
| ツール登録      | `adcp.AddTool(server, name, desc, handler)`                                                                  |
| HTTP サーバー  | `adcp.Serve(createAgent)`                                                                                    |
| レスポンスビルダー  | `adcp.ProductsResponse(data)`、`adcp.MediaBuyResponse(data)` など                                               |
| テストコントローラー | `adcp.RegisterTestController(server, store)`                                                                 |
| Skills     | [github.com/adcontextprotocol/adcp-go/skills](https://github.com/adcontextprotocol/adcp-go/tree/main/skills) |

完全な API リファレンスについては [Go SDK README](https://github.com/adcontextprotocol/adcp-go) を参照。

**リソース:**

* [GitHub Repository](https://github.com/adcontextprotocol/adcp-go)

## CLI ツール

JavaScript と Python の SDK は、テストと開発のためのコマンドラインツールを含みます。

両 SDK は同じ位置形状を共有します: `adcp <agent> [tool] [payload]`。最初の位置引数はエイリアス、ビルトイン（`test-mcp`、`test-a2a`）、または URL — プロトコルは自動検出されます。再入力を避けるため `--save-auth` でエイリアスを保存します。

### JavaScript CLI

```bash theme={null}
npx @adcp/sdk@latest --help
npx @adcp/sdk@latest --save-auth my-agent https://sales.example.com/mcp
npx @adcp/sdk@latest my-agent get_products '{"brief":"CTV campaign"}'
# or against the built-in public test agent:
npx @adcp/sdk@latest test-mcp get_products '{"brief":"CTV campaign"}'
```

CLI はストーリーボード（`adcp storyboard run`）、適合性グレーディング（`adcp grade`）、レジストリ診断も駆動します。完全なサーフェスについては `--help` を参照。

### Python CLI

```bash theme={null}
uvx adcp --help
uvx adcp --save-auth my-agent https://sales.example.com/mcp
uvx adcp my-agent get_products '{"brief":"CTV campaign"}'
```

## 次は

* **[Build an agent](/docs/building/by-layer/L4/build-an-agent)** — サーバー側 L4 パス。スキルファイル + コーディングエージェント。
* **[Build a caller](/docs/building/by-layer/L4/build-a-caller)** — クライアント側 L4 パス。インストール、呼び出し、レスポンス処理、レポート取り込み。
* **[Schemas](/docs/building/by-layer/L0/schemas)** — スキーマバンドル、型生成、バージョンピン留め。
* **[Migrate from hand-rolled](/docs/building/by-layer/L4/migrate-from-hand-rolled)** — SDK が多くをカバーする前に構築された AdCP エージェントを既に実行している？ 一度に 1 層ずつスワップする。