DocsDigest
一覧へLanguage: EN
OpenAICloudflare2026/04/15 13:00

Register domains wherever you build: Cloudflare Registrar API now in beta

要点だけを先に読めるように短く再構成したセクションです。

元記事
OpenAIClaude

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

openaijamodel: gpt-5-mini-2025-08-07

Cloudflare Registrar API（ベータ）でドメインをプログラム登録

apiregistrardomainsautomationagentsmcpbeta

Key Points

  • 検索・照会・登録の3ステップ
  • 価格はレジストリ原価（マークアップなし）
  • エージェント連携と自動化対応

Summary

CloudflareがRegistrar APIのベータを公開しました。ドメイン検索（Search）、レジストリ照会（Check）、登録（Register）の3つの主要エンドポイントで、エディタやCI、エージェントからプログラム的にドメインを取得できます。APIはCloudflareの既存APIスペック（MCP）に統合されており、エージェントはsearch()/execute()パターンでそのまま利用可能です。

Key Points

  • 推奨フロー: Search → Check → Register（Checkはレジストリに直接問い合わせるため最終的な可用性と価格の真偽値として必ず呼ぶ）。
  • レジストラ挙動:
    • Search: 候補を高速に返す（キャッシュベース、非確定）。
    • Check: レジストリ照会で権威的な価格・可用性を返す（必須確認）。
    • Register: 最小のリクエストで登録。通常は数秒で同期完了、長い場合は202 AcceptedとワークフローURLを返す（ポーリング対応）。
  • 支払い・連絡先・プライバシー:
    • デフォルト支払い方法・登録者連絡先を自動使用可能（必要ならリクエストで上書き）。
    • WHOISプライバシーはデフォルトで有効、追加料金なし。
  • プレミアムドメイン: Checkでレジストリ指定価格を返し、Registerは明示的な料金承認を要求。
  • エージェント設計注意点: ドメイン登録は返金不可のため、エージェントはユーザーに名前と価格の明示的確認を必須にすること。
  • 価格モデル: Cloudflareはレジストリ原価で提供（マークアップなし）。
  • 今後: 転送・更新・連絡先変更などライフサイクル管理APIの拡張を予定。

Quick integration notes for engineers

  • シンプルな3ステップAPIで自動化しやすく、AIエージェントやCIに組み込み可能。
  • 登録直前は必ずCheckを叩いて価格と可用性を取得し、ユーザー同意を取るワークフローを実装する。
  • レスポンス形状は同期完了時と非同期時で同一なので、クライアント実装はポーリング対応のみ追加すれば良い。
  • MCP互換環境では追加統合不要で既存のAPI探索/実行パターンで利用可能。

Docs

  • まずはRegistrar APIガイドとAPIリファレンスを参照してください。

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

openaijamodel: gpt-5-mini-2025-08-07

どこで構築してもドメインを登録：Cloudflare Registrar API（ベータ）

どこで構築してもドメインを登録：Cloudflare Registrar API（ベータ）

公開日: 2026-04-15

著者: Ankit Shah、Carlos Armada

所要時間: 4分

本日、Cloudflare Registrarの次章として、Registrar APIのベータをローンチします。Registrar APIを使うと、ドメインの検索、利用可否チェック、プログラムによる登録が可能になります。アイデアが実際になり始めた瞬間にドメインを買う操作が、エージェント的なワークフローからユーザーを引き離す必要はもうありません。

多くのビルダーからはRegistrar APIの要望が明確に寄せられていました。エディタ、ターミナル、エージェント駆動ツールなどにエージェント的ワークフローが移行するにつれ、ドメイン登録は埋めるべき明白なギャップになっていました。

背景

7年前にCloudflare Registrarを立ち上げたとき、考えはシンプルでした。ドメインはコストで提供されるべきであり、マークアップや不透明な手法は排除する、ということです。以来、Cloudflare Registrarは世界で最も急成長しているレジストラの一つになり、より多くの人々がCloudflareを次のプロジェクトの構築場所として選んでいます。

エージェントと自動化のために設計

Registrar APIは、エディタ、デプロイパイプライン、バックエンドサービス、エージェント駆動ワークフローなど、ソフトウェアが既に構築されているあらゆる場所でうまく動作するように設計されています。ワークフローは意図的にシンプルで機械に優しいものです。

  • Search は候補名を返します。
  • Check はリアルタイムの可否と価格を返します。
  • Register は最小限のリクエストを受け取り、即時完了するか、完了までポーリング可能なワークフロー形状のレスポンスを返します。

これにより、従来のAPIクライアントだけでなくユーザーの代わりに動作するAIエージェントからも使いやすくなっています。実際には、エージェントが名前を提案し、実際に登録可能なものを確認し、承認のために価格を提示し、ツールから出ることなく購入を完了できます。

Registrar API の概要

この最初のリリースでRegistrar APIは主に次の3つを提供します。

  • ドメインの検索（Search）
  • 利用可否と価格のチェック（Check）
  • ドメインの登録（Register）

まずは選定された人気TLD向けにサポートしています。詳細はRegistrar API docsを参照してください。サポートされている場合、プレミアムドメインも登録可能ですが、明示的な料金承認が必要です。

Registrar APIはCloudflareのフルAPIの一部であり、エージェントは既にCloudflare MCPを通じてアクセスできます。別の統合やカスタムツール定義は不要です。Cursor、Claude Code、または任意のMCP互換環境で動作するエージェントは、Cloudflare API全体をカバーする同じ search() と execute() パターンを使ってRegistrarエンドポイントを発見・呼び出せます。

APIが仕様の一部になった瞬間から、エージェントのために準備が整っていました。

実際の利用イメージ

  • AIコードエディタで新しいプロジェクトを作っているとします。スキャフォールディングの途中で、エージェントに「このプロジェクト用の良い .dev ドメインを見つけて登録して」と依頼します。
  • エージェントはプロジェクトに基づいて候補名を検索します。あなたが選んだもののリアルタイム可否と価格を確認します。
  • 承認すると、アカウントのデフォルト連絡先情報と支払い方法を自動的に使ってドメインを登録します。

レスポンスを読む頃には、ドメインは登録され、プライバシー保護も有効になっています。3つのAPIコール、数秒です。

コード例

ステップ1: ドメイン名を検索

search エンドポイントを使ってクエリを送信します。拡張子の有無は問いません。

async () => {
    return cloudflare.request({
        method: "GET",
        path: `/accounts/${accountId}/registrar/domain-search`,
        query: { q: "acme corp", limit: 3 },
    });
}

検索結果例（非権威的なキャッシュベースの結果）:

{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "domains": [
      {
        "name": "acmecorp.com",
        "registrable": true,
        "tier": "standard",
        "pricing": { "currency": "USD", "registration_cost": "8.57", "renewal_cost": "8.57" }
      },
      {
        "name": "acmecorp.dev",
        "registrable": true,
        "tier": "standard",
        "pricing": { "currency": "USD", "registration_cost": "10.11", "renewal_cost": "10.11" }
      },
      {
        "name": "acmecorp.app",
        "registrable": true,
        "tier": "standard",
        "pricing": { "currency": "USD", "registration_cost": "11.00", "renewal_cost": "11.00" }
      }
    ]
  }
}

ステップ2: 利用可否と価格をチェック

Searchの結果は高速ですが非権威的（キャッシュベース）です。利用可否は人気のある名前では秒単位で変わる可能性があります。Checkはレジストリに直接問い合わせます。登録の直前に呼び出し、価格レスポンスを事実のソースとして使ってください。

async () => {
    return cloudflare.request({
        method: "POST",
        path: `/accounts/${accountId}/registrar/domain-check`,
        body: { domains: ["acmecorp.dev"] },
    });
}

Checkのレスポンス例（権威的な価格）:

{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "domains": [
      {
        "name": "acmecorp.dev",
        "registrable": true,
        "tier": "standard",
        "pricing": { "currency": "USD", "registration_cost": "10.11", "renewal_cost": "10.11" }
      }
    ]
  }
}

ステップ3: ドメインを登録

必須フィールドはドメイン名のみです。WHOISプライバシー保護はデフォルトで無償有効です。アカウントにデフォルトの登録者連絡先が設定されていればAPIが自動的にそれを使います。なければリクエスト内で連絡先を指定できます。デフォルトの支払い方法が自動で使われます。

async () => {
    return cloudflare.request({
        method: "POST",
        path: `/accounts/${accountId}/registrar/registrations`,
        body: { domain_name: "acmecorp.dev" },
    });
}

登録成功レスポンス例（通常は数秒で同期的に完了）:

{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "domain_name": "acmecorp.dev",
    "state": "succeeded",
    "completed": true,
    "created_at": "2025-10-27T10:00:00Z",
    "updated_at": "2025-10-27T10:00:03Z",
    "context": {
      "registration": {
        "domain_name": "acmecorp.dev",
        "status": "active",
        "created_at": "2025-10-27T10:00:00Z",
        "expires_at": "2026-10-27T10:00:00Z",
        "auto_renew": true,
        "privacy_enabled": true,
        "locked": true
      }
    },
    "links": {
      "self": "/accounts/abc/registrar/registrations/acmecorp.dev/registration-status",
      "resource": "/accounts/abc/registrar/registrations/acmecorp.dev"
    }
  }
}

登録が完了するまでに時間がかかる場合、APIは202 AcceptedとワークフローのURLを返し、そのURLをポーリングする形になります。どちらの場合でもレスポンスの形状は同一です。

プレミアムドメインについては、Checkのレスポンスでレジストリ指定の正確な価格が返り、Registerリクエストではその価格を明示的に承認する形になります。

エージェントと返金不可の購入に関する注意

エージェントがあなたの代わりにドメインを登録する場合、アカウントのデフォルト支払い方法に課金されます。ドメイン登録は完了すると返金不可です。エージェントのフローは、登録エンドポイントを呼び出す前にドメイン名と価格をユーザーに確認するべきです。Checkステップは、その確認を明示的かつ一意に行うために存在します。

APIは正しい実装に必要なツールを提供しますが、ユーザーの承認なしに購入を行わないようにする責任はエージェント側の論理にあります。デフォルトでAPIドキュメントには、register API呼び出し時にユーザーの許可を求めるエージェント向けの明確な指示が含まれています。

なぜCloudflareはこれを異なる形で提供できるのか

多くの開発者プラットフォームがドメインワークフローを追加する中で、Cloudflareが異なるのはCloudflare自身がレジストラを運営している点です。つまり、プロジェクトが構築・デプロイされる同じプラットフォーム上でドメインを検索・登録・管理でき、余分なマークアップが乗りません。

At-cost（原価）での価格設定がCloudflare Registrarモデルの核心です。レジストリが請求する額をそのまま請求します。これはダッシュボード経由、API直接呼び出し、あるいはエージェント経由いずれでも同じです。

今後の予定

このベータはドメインライフサイクルの最初の重要な瞬間、つまり検索・チェック・登録に焦点を当てています。購入後もプログラムでドメインを管理できるよう、APIを拡張する作業を進めています。対象には転送、更新、連絡先の更新などのライフサイクル要素が含まれます。

このAPIはより広い registrar-as-a-service 提供に向けた第一歩です。現在その開発が進行中で、今年後半のローンチを目指しています。APIが拡張されれば、ウェブサイトビルダー、ホスティングプロバイダ、AI製品、その他のマルチテナントアプリケーションがドメイン登録を自社のユーザー体験に組み込めるようになります。

今すぐ構築を始める

Registrar APIはビルダーの要望から生まれました。ベータ版が利用可能になった今、Cloudflare Community、X、Discordであなたが作るものをぜひ見せてください。

開始方法:

  • Review the Registrar API guide
  • Check out the API reference

ワークフローが壊れる、機能が足りない、大規模なプラットフォームユースケースに向けて構築している、などあればお知らせください。私たちは更新、転送、更新（renewals）、およびその他の機能のサポートに向けて迅速に機能拡張を進めています。皆さんが何を作るか楽しみにしています！

特別な謝辞: Lucy Dryaeva と Fred Pinto の貴重な貢献に感謝します。

Cloudflareの接続クラウドは、企業ネットワーク全体を保護し、インターネット規模のアプリケーションを効率的に構築するのを支援し、あらゆるウェブサイトやインターネットアプリケーションを加速し、DDoS攻撃から守り、ハッカーを遠ざけ、Zero Trustへの道を支援します。任意のデバイスから 1.1.1.1 を訪れて、インターネットを速くより安全にする無料アプリを始めてください。私たちのミッションについて詳しくは start here をご覧ください。新しいキャリアをお探しなら、open positions をチェックしてください。

タグ: server-island-start, Registrar, Developers, AI, API, Developer Platform, Agents, Agents Week