--- title: "Bright Data OpenAPI仕様書：AIツールへの統合向け" slug: bright-data-openapi-specs date: 2026-02-01T13:02:11+00:00 modified: 2026-02-01T13:02:14+00:00 permalink: https://brightdata.jp/blog/ai/bright-data-openapi-specs type: blog --- [ ブログ ](https://brightdata.jp/blog "ブログ") / [AI](https://brightdata.jp/blog/ai) [AI](https://brightdata.jp/blog/ai) # Bright Data OpenAPI仕様書：AIツールへの統合向け Bright Data OpenAPI仕様が、AIワークフローにおけるSERP APIおよびWeb Unlocker APIの統合をいかに簡素化するかを、ステップバイステップガイドと実例と共に発見してください。 5 分読 [ ![Antonello Zanini](https://media.brightdata.jp/2022/12/Antonello-Zanini-2-50x50.jpg) ](https://brightdata.com/blog/authors/antonello-zanini) [Antonello Zanini Technical Writer ](https://brightdata.com/blog/authors/antonello-zanini) ![OpenAPI specs for Bright Data integration in AI agents](https://media.brightdata.jp/2025/12/OpenAPI-specs-for-Bright-Data-integration-in-AI-agents.png) このブログ記事では以下の内容をご覧いただけます： - OpenAPI仕様とは何か。 - AIフレームワークやプラットフォームにおけるツール定義で広く採用される理由 - Bright DataがAIエージェントやワークフローへの統合を簡素化するためにOpenAPIをどのようにサポートしているか。 - Bright Data Web Unlocker APIのOpenAPI仕様。 - Bright Data SERP APIのOpenAPI仕様 - これらの仕様が実際のAIプラットフォーム内でどのように機能するか さあ、詳しく見ていきましょう！ ## OpenAPI仕様とは？ [OpenAPI仕様（OAS）](https://spec.openapis.org/oas/latest.html)は、RESTful APIを記述するための言語非依存のオープンスタンダードです。APIの操作、パラメータ、レスポンス、セキュリティスキーム、その他の特性を定義するための構造化された機械可読形式（通常はYAMLまたはJSON）を提供します。 [仕様の GitHub リポジトリ](https://github.com/OAI/OpenAPI-Specification)をご覧ください！ **注**：OpenAPI仕様は[当初「Swagger仕様」と呼ばれていました。](https://swagger.io/blog/api-strategy/difference-between-swagger-and-openapi/)したがって、「Bright Data Swagger仕様」をお探しの方は、ここが正しい場所です！ ## 多くのAIソリューションがツール定義にOpenAPI仕様を採用する理由 多くのAIフレームワークがツール定義にOpenAPIサポートを採用しています。主な理由は、OpenAPI仕様が外部APIの機能を正確に記述する標準化された機械可読契約を提供するためです。 この標準化により、主に3つの利点が生まれます： 1. **相互運用性と摩擦の最小化**：OpenAPIは広くサポートされている標準です。仕様を提供すれば、プラットフォームはAPIを自動インポートし、入力フォーム、呼び出し、応答処理を生成し、ツールに統合できます。 2. **学習曲線の低減**：非技術ユーザーでも、ドキュメントや他のソースからOpenAPI仕様をコピーするだけでAPIを使用したツールを構築できます。手動での配線やコーディングが不要なため、ローコード/ノーコードAIプラットフォームでOpenAPIサポートが広く普及している理由です。 3. **メンテナンス性の向上**：明示的なAPI契約により更新が容易です。APIが進化しても、ツール定義内の仕様を更新するだけで済み、メンテナンスが大幅に簡素化され大規模な書き換えの必要性が低減します。 要するに、OpenAPIによるツール定義は、CRM、データプロバイダー、内部API、その他の外部サービスを安全に接続・文書化・維持できるエンタープライズ対応エコシステムへの扉を開きます。AIエージェント、パイプライン、ワークフローにおいて、最小限の手動オーバーヘッドで運用可能です。 ## Bright DataのOpenAPI仕様のご紹介 Bright Dataは[、ウェブデータ抽出、自動化されたウェブ操作、ウェブクローリングなど、幅広い製品とサービスを提供](/products)しています。 これらのソリューションはAPI（およびノーコードオプション）経由で利用可能であり、この機能をサポートするAIプラットフォームではOpenAPI仕様を使用して設定できます。 本記事では、Bright Dataの最も重要なツール2つに焦点を当てます： - [**SERP API**](/products/serp-api)：Google、Bing、Yandexなどの検索エンジンから構造化データを自動抽出。プロキシ管理、CAPTCHAの解決、JavaScriptレンダリングといった複雑な処理を処理し、ブロックされることなくクリーンなリアルタイム結果をJSONまたはHTML形式で取得可能。 - [**Web Unlocker API**](/products/web-unlocker)：複雑なボット対策（CAPTCHA、IPブロック、フィンガープリンティングなど）を回避し、あらゆるウェブページからデータを抽出します。プロキシ管理、実ユーザーエミュレーションを仲介し、クリーンなHTML、JSON、Markdown形式のレスポンスを提供します。 各サービスには、YAML形式とJSON形式[の両方でOpenAPI 3.x仕様が用意されており](https://spec.openapis.org/oas/v3.0.0.html)、Swagger Editorでのテスト例も確認できます。 これらの仕様を起点に、[ウェブスクレイピングAPIやその他のAPIエンドポイントを](https://docs.brightdata.com/api-reference/)同様にOpenAPI仕様に変換し、AI統合に活用できます。 **注記**: 一部のBright Data製品は同一のAPIエンドポイントを共有し、リクエストボディのみに基づいて動作を変更します。同一のパスとメソッドに対して完全に独立した2つの仕様を単一のOpenAPIドキュメントで定義できないため、別々のOpenAPI仕様が必要です。そのため、SERP APIとWeb Unlocker API（同一エンドポイントを共有）にはそれぞれ専用のOpenAPI仕様を提供します。 ## Web Unlocker API OpenAPI仕様 Bright DataのWeb Unlocker API向けOpenAPI仕様をご覧ください。 **注記**: 詳細については、以下のドキュメントページで利用可能な引数、オプション、認証方法などを確認してください: - [*Bright DataのアンロックAPI入門*](https://docs.brightdata.com/scraping-automation/web-unlocker/introduction) - [*Web Unlocker API`/request`ドキュメント*](https://docs.brightdata.com/api-reference/rest-api/unlocker/unlock-website) ### YAML仕様 以下は Bright Data Web Unlocker API の OpenAPI YAML 仕様です： ```none openapi: 3.0.4 info: title: Bright Data Web Unlocker API version: 1.0.0 description: | Bright Data Web Unlocker APIは、アンチボット対策の回避、プロキシ管理、CAPTCHAの自動解決を可能にし、ウェブデータ収集を容易にします。 [Web Unlocker API ドキュメント](https://docs.brightdata.com/scraping-automation/web-unlocker/introduction) contact: name: Bright Data url: servers: - url: https://api.brightdata.com tags: - name: Web Unlocker description: Bright Data Web Unlocker API との連携操作。 components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: BRIGHT_DATA_API_KEY paths: /request: post: operationId: sendWebUnlockerRequest summary: Web Unlocker API リクエストを送信 description: | Bright Data Web Unlocker API ゾーンを使用して Web Unlocker API リクエストを送信します。 [Web Unlocker API `/request` ドキュメント](https://docs.brightdata.com/api-reference/rest-api/unlocker/unlock-website) tags: - Web Unlocker security: - BearerAuth: [] requestBody: required: true content: application/json: schema: type: object required: - zone - url - format properties: zone: type: string description: あなたのWeb Unlockerゾーン名。 url: type: string description: アンロックして取得する対象ウェブサイトのURL。 example: https://example.com/products format: type: string description: | レスポンス形式。 許可値: - `raw`: レスポンスをボディに即時返却。 - `json`: 構造化されたJSONオブジェクトとしてレスポンスを返却。 default: raw method: type: string description: 対象URLを取得する際に使用するHTTPメソッド。 example: GET country: type: string description: | プロキシ位置の国コード（ISO 3166-1 alpha-2形式）。 example: us data_format: type: string description: | スクレイピング出力データのフォーマット。 許可値: - `markdown`: ページコンテンツをMarkdownに変換。 - `screenshot`: レンダリング済みページのPNG画像をキャプチャ。 enum: - markdown - screenshot responses: "200": description: 検索結果を含む正常なレスポンス。 "400": description: 無効なリクエスト（必須フィールドの欠落または無効なパラメータ）。 "401": description: 認証不足（無効または欠落したBright Data APIキー）。 ``` **注記**: `securitySchemes`セクションは、[HTTPベアラ認証](https://swagger.io/docs/specification/v3_0/authentication/bearer-authentication/)を使用するセキュリティスキームを指定します。具体的には、クライアントはAPI呼び出し時に`Authorization`ヘッダーに`BRIGHT_DATA_API_KEYを`ベアラトークンとして送信する必要があります。 一方で、ほとんどのAIプラットフォームには既に認証方法が組み込まれており、この指定フィールドを無視する場合があります。ただし、明確化と参照のため、OpenAPI仕様に含めることは有用です。 ### JSON仕様 以下は Web Unlocker API の JSON OpenAPI 仕様です： ```none { "openapi": "3.0.4", "info": { "title": "Bright Data Web Unlocker API", "version": "1.0.0", "description": "Bright Data Web Unlocker APIは、アンチボット対策の回避、プロキシ管理、CAPTCHAの自動解決を可能にし、ウェブデータ収集を容易にします。\n[Web Unlocker API ドキュメント](https://docs.brightdata.com/scraping-automation/web-unlocker/introduction)n", "contact": { "name": "Bright Data", "url": "" } }, "servers": [ { "url": "https://api.brightdata.com" } ], "tags": [ { "name": "Web Unlocker", "description": "Bright Data Web Unlocker APIとの連携操作を提供します。" } ], "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "BRIGHT_DATA_API_KEY" } } }, "paths": { "/request": { "post": { "operationId": "sendWebUnlockerRequest", "summary": "Web Unlocker API リクエストを送信", "description": "Bright Data Web Unlocker API ゾーンを使用して Web Unlocker API リクエストを送信します。 nn[Web Unlocker API `/request` ドキュメント](https://docs.brightdata.com/api-reference/rest-api/unlocker/unlock-website)n", "tags": [ "Web Unlocker" ], "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "ゾーン", "url", "format" ], "properties": { "zone": { "type": "string", "description": "Web Unlockerのゾーン名です。", }, "url": { "type": "string", "description": "アンロックして取得する対象ウェブサイトのURL。", "example": "https://example.com/products" }, "format": { "type": "string", "description": "レスポンス形式。 n許可値: n- `raw`: レスポンスをボディに即時返却。 n- `json`: 構造化されたJSONオブジェクトとしてレスポンスを返します。 n", "default": "raw" }, "method": { "type": "string", "description": "対象URLを取得する際に使用するHTTPメソッド。", "example": "GET" }, "country": { "type": "string", "description": "プロキシ位置の国コード（ISO 3166-1 alpha-2 形式）。n", "example": "us" }, "data_format": { "type": "string", "description": "スクレイピングされた出力データの形式。 n許可値:n- `markdown`: ページコンテンツをMarkdown形式に変換n- `screenshot`: レンダリングされたページのPNG画像をキャプチャn", "enum": [ "markdown", "screenshot" ] } } } } } }, "responses": { "200": { "description": "検索結果を含む正常なレスポンス。" }, "400": { "description": "無効なリクエスト（必須フィールドの欠落または無効なパラメータ）。" }, "401": { "description": "未認証（無効または欠落しているBright Data APIキー）" } } } } } } ``` ### Swagger Editorでのテスト OpenAPI仕様を[Swagger Editor](https://editor.swagger.io/)に貼り付けてテストします: ![Testing the Bright Data Web Unlocker API specification in Swagger](https://media.brightdata.com/2025/12/s_DB09AC4E591F75508CE59336282FF5DCBFBF53BEB40B6C9F4669DBDD00BDF2F8_1765390741769_image.png) ## SERP API OpenAPI仕様 Bright DataのSERP API向けOpenAPI仕様を探索してください。 **注**: 詳細については、以下のドキュメントページで引数、オプション、認証方法などを参照してください: - [*SERP API 概要*](https://docs.brightdata.com/scraping-automation/serp-api/introduction) - [*SERP API`/リクエストドキュメント`*](https://docs.brightdata.com/api-reference/rest-api/serp/scrape-serp) ### YAML仕様 以下は SERP API の OpenAPI YAML 仕様です： ```none openapi: 3.0.4 info: title: Bright Data SERP API version: 1.0.0 description: | Bright Data SERP APIを使用して検索エンジン結果を抽出します。Google、Bing、Yandex、DuckDuckGoなどの主要検索エンジンから構造化データを抽出します。 オーガニック検索結果、有料広告、ローカルリスティング、ショッピング結果、その他のSERP機能を取得します。 [SERP API ドキュメント](https://docs.brightdata.com/scraping-automation/serp-api/introduction) contact: name: Bright Data url: servers: - url: https://api.brightdata.com tags: - name: SERP description: Bright Data SERP API に関連する操作。 components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: BRIGHT_DATA_API_KEY paths: /request: post: operationId: sendSerpRequest summary: SERP APIリクエストを送信 description: | Bright Data SERP API ゾーンを使用して SERP API リクエストを送信します。 [SERP API `/request` ドキュメント](https://docs.brightdata.com/api-reference/rest-api/serp/scrape-serp) tags: - SERP security: - BearerAuth: [] requestBody: required: true content: application/json: schema: type: object required: - zone - url - format properties: zone: type: string description: SERP API ゾーンの名前。 url: type: string description: クエリ対象の検索エンジンURL（例: `https://www.google.com/search?q=`）。 example: https://www.google.com/search?q=pizza&hl=en&gl=us format: type: string description: | レスポンス形式。 許可値: - `raw`: レスポンスをボディに直接返します。 - `json`: 構造化されたJSONオブジェクトとしてレスポンスを返します。 デフォルト: raw 列挙型: - raw - json country: type: string description: | プロキシ位置の国コード（ISO 3166-1 alpha-2 形式）。 example: us data_format: type: string description: | SERP出力データの形式。 許可値: - `json`: オーガニック、有料、ローカル、ショッピング、フィーチャースニペットを含む構造化されたSERP結果の完全パース済みJSONデータ。 - `markdown`: Markdownに変換されたSERPコンテンツ。 enum: - json - markdown responses: "200": description: 検索結果を含む正常なレスポンス。 "400": description: 無効なリクエスト（必須フィールドの欠落または無効なパラメータ）。 "401": description: 認証失敗（無効または欠落したBright Data APIキー）。 ``` ### JSON仕様 これは SERP API の JSON OpenAPI 仕様です: ```none { "openapi": "3.0.4", "info": { "title": "Bright Data SERP API", "version": "1.0.0", "description": "Bright Data SERP APIを使用して検索エンジンの結果を抽出します。 Google、Bing、Yandex、DuckDuckGoなどの主要検索エンジンから構造化データを抽出します。 nオーガニック検索結果、有料広告、ローカルリスティング、ショッピング結果、その他のSERP機能を取得できます。n[SERP APIドキュメント](https://docs.brightdata.com/scraping-automation/serp-api/introduction)n", "contact": { "name": "Bright Data", "url": "" } ], "servers": [ { "url": "https://api.brightdata.com" } ], "tags": [ { "name": "SERP", "description": "Bright Data SERP APIに関連する操作。" } ], "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "BRIGHT_DATA_API_KEY" } } }, "paths": { "/request": { "post": { "operationId": "sendSerpRequest", "summary": "SERP APIリクエストを送信", "description": "Bright Data SERP APIゾーンを使用してSERP APIリクエストを送信します。 nn[SERP API `/request` ドキュメント](https://docs.brightdata.com/api-reference/rest-api/serp/scrape-serp)n", "tags": [ "SERP" ], "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "ゾーン", "url", "format" ], "properties": { "zone": { "type": "string", "description": "SERP API ゾーンの名前。 }, "url": { "type": "string", "description": "クエリを送信する検索エンジンのURL（例: `https://www.google.com/search?q=`）", "example": "https://www.google.com/search?q=pizza&hl=en&gl=us" }, "format": { "type": "string", "description": "レスポンス形式。 n許可値: n- `raw`: レスポンスをボディに直接返す。 n- `json`: 構造化されたJSONオブジェクトとしてレスポンスを返す。 n", "default": "raw", "enum": [ "raw", "json" ] }, "country": { "type": "string", "description": "プロキシ位置の国コード（ISO 3166-1 alpha-2 形式）。n", "example": "us" }, "data_format": { "type": "string", "description": "SERP出力データのフォーマット。 n許可値:n- `json`: オーガニック、有料、ローカル、ショッピング、フィーチャースニペットを含む構造化されたSERP結果の完全パース済みJSONデータ。n- `markdown`: Markdownに変換されたSERPコンテンツ。 n", "enum": [ "json", "markdown" ] } } } } } }, "responses": { "200": { "description": "検索結果を含む正常なレスポンス。" }, "400": { "description": "無効なリクエスト（必須フィールドの欠落または無効なパラメータ）" }, "401": { "description": "未認証（無効または欠落したBright Data APIキー）" } } } } } } ``` ### Swagger Editorでのテスト この仕様をテストするには、オンライン[Swagger Editor](https://editor.swagger.io/)に貼り付けてください： ![Testing the Bright Data SERP API specification in Swagger](https://media.brightdata.com/2025/12/s_DB09AC4E591F75508CE59336282FF5DCBFBF53BEB40B6C9F4669DBDD00BDF2F8_1765385190750_image.png) ## Difyにおけるツール統合のためのBright Data OpenAPI仕様のテスト API経由でBright Dataサービスに接続するための上記のOpenAPI仕様が機能することを確認するため、Difyでテストします。 具体的には、Bright Data SERP API OpenAPI仕様をテストしますが、このガイドセクションは他のWeb Unlocker API SERP仕様にも簡単に適応できます。 [Difyは](https://dify.ai/)オープンソースのローコード開発プラットフォームであり、AI搭載アプリケーションの構築・デプロイ・管理を簡素化します。その数多くの機能の中でも、[OpenAPI仕様を用いたカスタムツールの定義](https://docs.dify.ai/en/use-dify/nodes/tools#creating-custom-tools)が可能です。 この機能はDify固有のものではありません。むしろ、他の多くの[AIエージェント構築プラットフォーム](/blog/ai/best-ai-agent-frameworks)、特にローコード/ノーコードやエンタープライズ対応ソリューションも、OpenAPI仕様を介したツール統合をサポートしています。 以下のガイドで、OpenAPI仕様を介したBright Dataとの追加統合方法をご覧ください： - [*Microsoft Copilot StudioのAIエージェントにBright DataのSERP APIを統合する*](/blog/ai/microsoft-copilot-studio-with-serp-api) - [*IBM watsonxのAIエージェントにBright DataのSERP APIを統合する*](/blog/ai/ibm-watsonx-with-serp-api) それでは、DifyでBright DataのOpenAPI仕様をテストしてみましょう！ ### 前提条件 このチュートリアルセクションを実行するには、以下が必要です： - APIキーとSERP APIゾーンが設定された[Bright Dataアカウント](/) - クラウド版[を使用する場合はDify Cloudアカウント](https://cloud.dify.ai/apps)、[またはローカルマシン上で動作するDifyインスタンス](https://github.com/langgenius/dify)。 公式ガイド[に従ってBright Data APIキーを生成してください](https://docs.brightdata.com/api-reference/authentication#how-do-i-generate-a-new-api-key)。このキーはSERP APIツールの呼び出し認証に必要となるため、安全な場所に保管してください。 次に、Bright Dataのドキュメントに記載されている手順に従い、[アカウント内でSERP APIゾーンを設定してください](https://docs.brightdata.com/scraping-automation/serp-api/quickstart): ![Note the SERP API zone called "serp_api” in your account](https://media.brightdata.com/2025/12/s_DB09AC4E591F75508CE59336282FF5DCBFBF53BEB40B6C9F4669DBDD00BDF2F8_1765386310515_image.png) 以降、SERP APIゾーン名を「`serp_api`」と仮定します。例示されるゾーン名は、ご自身のゾーン名に合わせて変更してください。 ### ステップ #1: 新しいカスタムツールを作成する [Dify Cloudアカウント](https://cloud.dify.ai/)にログインするか、ローカルインスタンスを起動します。新しいカスタムツールを作成するには、まず上部メニューの「ツール」オプションを選択します： ![Selecting the “Tools” option](https://media.brightdata.com/2025/12/s_DB09AC4E591F75508CE59336282FF5DCBFBF53BEB40B6C9F4669DBDD00BDF2F8_1765303578092_image.png) 「ツール」ページで「カスタム」タブに移動します： ![Reaching the “Custom” tab](https://media.brightdata.com/2025/12/s_DB09AC4E591F75508CE59336282FF5DCBFBF53BEB40B6C9F4669DBDD00BDF2F8_1765303602730_image.png) 「カスタム」タブで「カスタムツールを作成」カードをクリックします： ![Pressing the “Create Custom Tool” button](https://media.brightdata.com/2025/12/s_DB09AC4E591F75508CE59336282FF5DCBFBF53BEB40B6C9F4669DBDD00BDF2F8_1765303632328_image.png) 以下の「カスタムツールを作成」モーダルが表示されます： ![The “Create Custom Tool” modal](https://media.brightdata.com/2025/12/s_DB09AC4E591F75508CE59336282FF5DCBFBF53BEB40B6C9F4669DBDD00BDF2F8_1765303224976_image.png) これで準備完了です。ここにBright Data SERP APIのOpenAPI仕様を貼り付けます。 ### ステップ #2: OpenAPI仕様を使用してSERP APIツールを定義する 「カスタムツールを作成」モーダルで、ツールに「SERP API」などの名前を付けます。「スキーマ」フィールドに、Bright Data SERP APIのYAML OpenAPI仕様を貼り付けます。 以下のような画面が表示されます： ![The populated custom tool creation modal](https://media.brightdata.com/2025/12/s_DB09AC4E591F75508CE59336282FF5DCBFBF53BEB40B6C9F4669DBDD00BDF2F8_1765385385170_image.png) OpenAPI仕様で定義された内容に基づき、「利用可能なツール」セクションが自動的に生成される点にご注意ください。 前述の通り、ほとんどのプラットフォームでは組み込みメソッドによる認証定義が必要です。本ケースでは「認証方法」セクションの歯車アイコンをクリックして設定します： ![Clicking the gear icon in the “Authentication Method” section](https://media.brightdata.com/2025/12/s_DB09AC4E591F75508CE59336282FF5DCBFBF53BEB40B6C9F4669DBDD00BDF2F8_1765385442537_image.png) 認証を以下のように設定します： - *認証タイプ*: 「ヘッダー」 - *タイプ*: 「Bearer」 - *キー*: 「Authorization」 - *値*：Bright Data APIキーを貼り付け ![Configuring the authentication method](https://media.brightdata.com/2025/12/s_DB09AC4E591F75508CE59336282FF5DCBFBF53BEB40B6C9F4669DBDD00BDF2F8_1765303744637_image.png) これにより、[`Authorization`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Authorization)ヘッダーを介した認証が設定されます。送信されるヘッダーは次の形式になります: ```none Bearer ``` これは[Bright Data APIがサポートする認証方法](https://docs.brightdata.com/api-reference/authentication#how-do-i-authenticate-with-api-key)そのものです。 素晴らしい！SERP APIツールが正しく定義・設定されました。 ### ステップ #3: ツールのテスト 「利用可能なツール」セクションで、設定済みの`/request`エンドポイントの行を見つけ、「テスト」ボタンをクリックします: ![Pressing the “Test” button](https://media.brightdata.com/2025/12/s_DB09AC4E591F75508CE59336282FF5DCBFBF53BEB40B6C9F4669DBDD00BDF2F8_1765385470915_image.png) これにより「Test sendSerpRequest」モーダルが開き、パラメータと値をカスタマイズして設定したツールが動作することを確認できます。 例えば、まずJSON形式での基本レスポンスをテストしてみましょう。期待される結果は、GoogleからスクレイピングされたSERPページをHTML形式で含む構造化されたJSONレスポンスです（SERP APIのデフォルトデータ形式）。 ![Testing the SERP API tool](https://media.brightdata.com/2025/12/s_DB09AC4E591F75508CE59336282FF5DCBFBF53BEB40B6C9F4669DBDD00BDF2F8_1765385579450_image.png) 「テスト結果」セクションまでスクロールしてAPIレスポンスを確認します。JSONの`body`フィールドに期待通りSERPページのHTMLが含まれていることが確認できます： ![Note the HTML contained in the “body” field](https://media.brightdata.com/2025/12/s_DB09AC4E591F75508CE59336282FF5DCBFBF53BEB40B6C9F4669DBDD00BDF2F8_1765385617894_image.png) 素晴らしい！この結果は期待通りです。 次に、同じページのMarkdown版をレスポンス本文で直接取得してみましょう： ![Note the SERP result in Markdown](https://media.brightdata.com/2025/12/s_DB09AC4E591F75508CE59336282FF5DCBFBF53BEB40B6C9F4669DBDD00BDF2F8_1765385671866_image.png) 今回は、`format: raw` によりプレーンテキストで返され、`data_format: markdown` によりSERPデータがMarkdown形式で含まれている点に注目してください。[これによりLLMへの取り込みが容易になります](https://www.kaggle.com/code/brightdataml/benchmarking-ai-on-different-data-formats)。 ツールが機能していることが確認できたので（基盤となるAPIを正常に呼び出せているため）、これを任意のDifyワークフローやAIエージェントに統合できます。 これで完了！OpenAPI仕様で定義されたBright Dataツールは完璧に動作します。 ## 結論 本記事では、AIプラットフォームやライブラリがツール定義にOpenAPI仕様を採用する理由と、Bright Dataがこのオプションをどのようにサポートしているかを学びました。特に、Bright DataのWeb UnlockerおよびSERP APIソリューションのOpenAPI仕様を確認しました。 これら2つのツールを統合することで、ウェブ検索やRAG（Retrieval-Augmented Generation）、深い調査[など](/ai/web-access)、[様々なタスクのためのAIのための](/ai/web-access)データを取得する複雑なAIエージェントを作成できます。[Bright DataのAI向けAPIサービス一式](/ai/web-access)を活用し、エージェントの真の潜在能力を解き放ちましょう！ 今すぐBright Dataアカウントを無料で作成し、ウェブデータ取得のためのAPI統合を始めましょう！ お問い合わせ無料トライアル![google social icon](/wp-content/themes/brightdata/assets/images/ic_google.svg) 目次 日本企業向けデータソリューション 日本のトップ企業が信頼するスケーラブルなウェブデータプラットフォーム。日本語24時間サポート、GDPR・個人情報保護法準拠、日本企業20社以上の導入実績。 [詳細を見る](https://brightdata.jp/solutions/data-solutions-for-japanese-companies "詳細を見る") [ ](https://news.ycombinator.com/submitlink?t=Bright+Data+OpenAPI%E4%BB%95%E6%A7%98%E6%9B%B8%EF%BC%9AAI%E3%83%84%E3%83%BC%E3%83%AB%E3%81%B8%E3%81%AE%E7%B5%B1%E5%90%88%E5%90%91%E3%81%91&u=https://brightdata.jp/blog/ai/bright-data-openapi-specs) [ ](https://www.linkedin.com/shareArticle?mini=true&title=Bright+Data+OpenAPI%E4%BB%95%E6%A7%98%E6%9B%B8%EF%BC%9AAI%E3%83%84%E3%83%BC%E3%83%AB%E3%81%B8%E3%81%AE%E7%B5%B1%E5%90%88%E5%90%91%E3%81%91&url=https://brightdata.jp/blog/ai/bright-data-openapi-specs) [ ](http://www.reddit.com/submit?title=Bright+Data+OpenAPI%E4%BB%95%E6%A7%98%E6%9B%B8%EF%BC%9AAI%E3%83%84%E3%83%BC%E3%83%AB%E3%81%B8%E3%81%AE%E7%B5%B1%E5%90%88%E5%90%91%E3%81%91&url=https://brightdata.jp/blog/ai/bright-data-openapi-specs) ## あなたは下記にもご興味がおありかもしれません [ ![OpenHuman with Bright Data](https://media.brightdata.jp/2026/09/OpenHuman-with-Bright-Data.png) ](https://brightdata.jp/blog/ai/openhuman-with-bright-data "Bright Data CLIを通じたOpenHumanにおける本番対応ウェブアクセス") [AI ![Antonello Zanini](https://media.brightdata.jp/2022/12/Antonello-Zanini-2-50x50.jpg) Antonello Zanini Technical Writer ### Bright Data CLIを通じたOpenHumanにおける本番対応ウェブアクセス Bright Data CLIをOpenHumanに統合して、AIエージェント向けの本番対応ウェブアクセスとデータ収集を実現します。 09-Sep-2026 3 分読 ](https://brightdata.jp/blog/ai/openhuman-with-bright-data) [ ![Multimodal Web Scraping with MiniMax](https://media.brightdata.jp/2026/09/Multimodal-Web-Scraping-with-MiniMax.png) ](https://brightdata.jp/blog/%e3%82%a6%e3%82%a7%e3%83%96%e3%83%87%e3%83%bc%e3%82%bf/multimodal-web-scraping-with-minimax "MiniMaxによるマルチモーダルウェブスクレイピング") [ウェブデータ ![Antonello Zanini](https://media.brightdata.jp/2022/12/Antonello-Zanini-2-50x50.jpg) Antonello Zanini Technical Writer ### MiniMaxによるマルチモーダルウェブスクレイピング Bright Data Web UnlockerとMiniMax M3ビジョンを組み合わせて、画像やウェブページのスクリーンショットから構造化データを抽出します。 09-Sep-2026 1 分読 ](https://brightdata.jp/blog/%e3%82%a6%e3%82%a7%e3%83%96%e3%83%87%e3%83%bc%e3%82%bf/multimodal-web-scraping-with-minimax) [ ![The 10 Best CLI Tools for Codex in 2026](https://media.brightdata.jp/2026/08/The-10-Best-CLI-Tools-for-Codex-in-2026.png) ](https://brightdata.jp/blog/ai/best-cli-tools-for-codex "2026年版 Codex向けCLIツール10選 – テスト＆ランキング") [AI ![Daniel Shashko](https://media.brightdata.jp/2022/04/Daniel-Shashko-2-50x50.png) Daniel Shashko Web Data & AI Expert ### 2026年版 Codex向けCLIツール10選 – テスト＆ランキング Codexをより速く、より有能にする10のCLIツール。サンドボックス内から実際のウェブアクセスを提供するBright Data CLIから始まります。 06-Sep-2026 4 分読 ](https://brightdata.jp/blog/ai/best-cli-tools-for-codex)