--- title: "プロンプトからKiroとBright Dataでウェブスクレイパーを構築する" slug: web-scrapers-with-kiro-power date: 2026-06-29T07:57:18+00:00 modified: 2026-06-29T07:57:18+00:00 permalink: https://brightdata.jp/blog/ai/web-scrapers-with-kiro-power type: blog --- [ ブログ ](https://brightdata.jp/blog "ブログ") / [AI](https://brightdata.jp/blog/ai) [AI](https://brightdata.jp/blog/ai) # プロンプトからKiroとBright Dataでウェブスクレイパーを構築する プロンプトからBright DataのKiro Powerでウェブスクレイパーを作成します。 9 分読 [ ![Satyam Tripathi](https://media.brightdata.jp/2024/09/Satyam-Tripathi-50x50.png) ](https://brightdata.com/blog/authors/satyam-tripathi) [Satyam Tripathi Technical Writer ](https://brightdata.com/blog/authors/satyam-tripathi) ![Kiro Power with Bright Data](https://media.brightdata.jp/2026/06/kiro-bright-data-web-mcp.png) サイトがマークアップを変更したり、アクセスをブロックし始めると、ウェブスクレイパーは動作しなくなります。[`brightdata-scrape` Kiro Power](https://github.com/brightdata/kiro-powers/tree/main/brightdata-scrape)は、平易な言語のプロンプトからスクレイパーを作成し、アンブロッキングとパースを処理するBright DataのBright Data MCPに対して実行します。このガイドでは、1つの再現可能なPowerパターンを4つのユースケースに適用し、そのうち2つはライブAPIの実行まで完結します。これには、ChatGPTがあなたのブランドに言及しているかを確認するユースケースも含まれます。 ### TL;DR 最終的には、4つのユースケースに適用できる1つのPowerパターンを習得できます。各ユースケースは1つの平易な言語プロンプトで動作し、そのうち2つはライブAPIの実行まで完結します： - **小売価格トラッカー**：AmazonとWalmartで1つの商品を追跡します。 - **ブランド可視性モニター**：AIアシスタントがあなたのブランドに言及しているかを確認します。 - **LinkedInリードジェンパイプライン**：見込み客リストの転職情報を監視します。 - **Crunchbaseインテルダッシュボード**：企業ごとに数十のライブフィールドを取得します。 ![Kiroエージェント：search_engineとscrape_as_markdownを実行し、Sony WH-1000XM5のAmazonライブ価格$248.00と在庫状態を返します。0.9クレジット。](https://media.brightdata.jp/2026/06/kiro-bright-data-1.png)*Kiroエージェントは2つのライブツール呼び出しを行います（search\_engine、次にscrape\_as\_markdown）。そして実際のAmazon価格$248を返します。* ### Kiro Powerとは？ KiroはAWSが構築したAI IDEです。Powerはマニフェスト、MCPサーバー設定、ステアリングファイル、コードテンプレートを含むフォルダ形式のKiro独自の拡張フォーマットです。Kiroはプロンプトによって起動されたときのみPowerをコンテキストに読み込みます。[kiro.dev/powersの公式カタログ](https://kiro.dev/powers)を参照してください。Bright DataはGitHubで`brightdata-scrape`を別途公開しているため、直接インポートできます。 PowerはClaude Skillsと1つの重要な点で異なります：各PowerにはMCP（Model Context Protocol）サーバー設定がすでに含まれています。そのためエージェントは指示だけでなく、呼び出せる新しいツールを取得します。`brightdata-scrape`の場合、そのサーバーはBright DataのBright Data MCPです。 このエンドポイントはWeb Unlocker、SERP API、Browser API、およびBright Dataの事前構築済みデータセットカタログを提供します。Bright DataのMCPを使用すると、エージェントは1回のツール呼び出しでそれらを使用できます。これらのツール（`search_engine`、`scrape_as_markdown`、50の`web_data_*` Proツール、`scraping_browser_*`、`discover`）は、かつて3つの別々の統合（プロキシ、SERP API、ブラウザファーム）が必要だったものを、1セットの認証情報と1つのリトライパターンに置き換えます。 ### brightdata-scrape Kiro Powerのインストール プロジェクトのセットアップと接続確認には5つのステップがあります： 1. **Bright Data APIトークンを取得します。[ユーザーとAPIキー](/cp/setting/users) → APIキー**で、**ユーザー**権限を持つキーを追加し、有効期限を設定して値をコピーします。無料ティアにクレジットカードは不要です。 2. **Kiroをインストールし、プロジェクトを作成して開きます。**[Kiro](https://kiro.dev/downloads)をダウンロードしてインストールします。Powerが機能するにはプロジェクトが必要で、このガイドではNext.jsを使用します。プロジェクトを作成してKiroで`price-tracker`フォルダを開きます： npx create-next-app@latest price-tracker \\ –typescript, app, tailwind, src-dir, use-npm cd price-tracker 今は他に何もインストールする必要はありません。Kiroは後でフェーズ3で生成されたスクレイパーが必要とするパッケージを追加します。 1. **Powerをインストールします。**Kiroのパネル（左のアクティビティバーのアイコン）を開きます。**カスタムPowerを追加**をクリックし、**GitHubからPowerをインポート**を選択して、このURLを貼り付けます： https://github.com/brightdata/kiro-powers/tree/main/brightdata-scrape ![Kiroカスタムパワー追加モーダル：brightdata-scrapeのGitHub URLが入力フィールドに貼り付けられ、'Enterキーで確認'のヒントが表示されています。](https://media.brightdata.jp/2026/06/kiro-bright-data-2.png)1. **Kiroにトークンを渡します。**Powerをインストールすると、プロジェクトの`.kiro/settings/mcp.json`にURL `https://mcp.brightdata.com/mcp?token=${BRIGHTDATA_API_KEY}`を持つ`brightdata`サーバーが追加されます。**そのファイルを開き、`${BRIGHTDATA_API_KEY}`をステップ1でコピーしたリテラルトークンに置き換えて保存します。**次に`.kiro/settings/mcp.json`を`.gitignore`に追加して、トークンがコミットされないようにします。 > **なぜリテラルトークンで、`${…}`プレースホルダーではないのか？**Kiroは現在`mcp.json`内の`${VAR}`を展開しません（[既知の未解決の問題](https://github.com/kirodotdev/Kiro/issues/5060)）。そのためプレースホルダーでは接続の代わりに`Connection Failed` / `HTTP 404`が返されます。 1. **接続を確認します。**MCPサーバーパネルを再度開きます。数秒後、`brightdata`がそのツールの中に`search_engine`と`scrape_as_markdown`を含む**接続済み**状態として表示されます。これが必要なシグナルです。 ![Kiro IDE MCPサーバーパネル：brightdata-scrape Kiro Powerのインストール後、brightdataが接続済み（5ツール）と表示されています。](https://media.brightdata.jp/2026/06/kiro-bright-data-3.png)次にプロジェクトルートに`.env.local`を作成し、同じトークンを入力します。トークンを2回貼り付けるのは意図的です：`.kiro/settings/mcp.json`のコピー（ステップ4）はビルド中に*Kiro*をBright Dataに接続し、このコピーは実行時に*生成されたアプリ*によって読み取られます。 ```none BRIGHTDATA_API_KEY=... # 上記で生成したトークン BRIGHTDATA_UNLOCKER_ZONE=... # 小売ビルドではプレースホルダーで問題なし；Web Unlockerユースケースの前に設定 ``` 新規アカウントの場合、またはWeb Unlockerユースケースを実行する前に、まずゾーン名を設定します。以下の*4つのユースケースを本番環境にスケールする*の**Web Unlockerゾーンの設定**を参照してください。 4つのユースケースすべてで、プロンプトのみが変わります。4フェーズのワークフローは同じです。 ### Kiroの4フェーズワークフロー（4つすべてに共通のパターン） Powerはすべてのプロンプトに対して同じ4つのフェーズを実行します。各フェーズは続行前にあなたの承認を待ちます： 1. **検出と計画。**Powerはワークスペースのマニフェスト（`package.json`、`pyproject.toml`、`Cargo.toml`、`go.mod`など）とその中の依存関係を確認します。次に統合方法を選択します：ウェブフレームワークが見つかった場合はAPIルートを生成し、エージェントSDKが見つかった場合はエージェントツールを生成し、プロジェクトがライブラリの場合はモジュールを生成します。何をスクレイピングするか、アイテム数はいくつかを尋ねます。 1. **スクレイピングプレイブック。**PowerはBright Dataのツールラダーを確認し、各ターゲットサイトに対して、あなたのティアで許可される最適なパスを選択します：**Web Data Proツール**（30以上のプラットフォームにわたる50の`web_data_*`ツール、型付きフィールド、`&pro=1`が必要）→**[データセットトリガー](/products/datasets)**（同じデータ、ポーリング、`&pro=1`不要）→**[Web Unlocker](/products/web-unlocker)**（ロングテールサイト向けのプロキシ+パース）→**[Browser API](/products/scraping-browser)**（ログイン/クリックフロー）→**[SERP API](/products/serp-api)**（検索結果）。 ![Kiroフェーズ2：AmazonとWalmartに事前構築済みデータセットが選択され、'フェーズ3に進む準備はできましたか？'の確認ゲートが表示されています。0.38クレジット、1分24秒。](https://media.brightdata.jp/2026/06/kiro-bright-data-4.png)1. **統合。**Powerがファイルを生成します。以下の小売実行では4つのファイルが生成されました：スクレイパーモジュール、APIルート、ダッシュボードページ、そして`README.md`の新しい`## ウェブスクレイピング`セクションです。（`.env.local`にすでにAPIトークンがあったため、フェーズ3はそれをスキップしました。これはファイル安全ルールです：既存のファイルは上書きしません。） ![Kiroチャット：brightdata-scrape PowerのフェーズPhase 3完了を示す画面。4ファイルが書き込まれ、TypeScriptエラーゼロ、1.38クレジット、1分56秒使用。](https://media.brightdata.jp/2026/06/kiro-bright-data-5.png)1. **MCPと検証。**PowerはBright DataのMCPサーバーを`.kiro/settings/mcp.json`にマージし、ターゲットURLに対してスモークテストを実行します。このフェーズでは2つの本番セーフガードが実行されます：上書き前の差分確認と、FAIL → ITERATEリカバリーです。ユースケース1のフェーズ4でリカバリーの全容を示します。 ### ライブで実行したものと表示内容 **ここに記載されているものはすべてライブAPIに対して検証済みであり、モックアップではありません。**正確な価格、ツール、タイミングは特定のキャプチャされた実行から取得されています。スクレイパーはライブデータを読み取るため、あなた自身の結果はキャプチャされたものではなく、現在の価格、ページ、モデルの回答を反映します。 - **ユースケース1と4はライブAPIに対して完全に実行されました：**小売（Proスペンドゼロ）とCrunchbase（Proティア）。以下のすべての小売スクリーンショットはその実行から取得されており、ユースケース4の完全なコードはそのセクションに記載されています。 - **ユースケース2と3は表示のみで再構築されていません：**プロンプト、フェーズ2が選択するツール、各ツールに対してライブで検証したフィールド形状が示されています。ユースケース4の`callMcpTool`クライアントを再利用するため、ほぼ同一のコードを再貼り付けする必要はありません。 - **ユースケース2、3、4はProモード（`&pro=1`）で実行されます。**これは以下の本番へのスケールでカバーされています。 ### ユースケース1：マルチリテーラー価格トラッキング Kiroへのプロンプトはこちらです： > **Kiroへのプロンプト：***「AmazonとWalmartのSony WH-1000XM5の価格をスクレイピングする価格比較エージェントを追加してください。」* **フェーズ2の選択**：キャプチャされたProゼロの実行では、Powerはデータセットトリガーパス（同じデータ、ポーリング）を選択しました。`&pro=1`の場合は、代わりにProツール`web_data_amazon_product`と`web_data_walmart_product`を選択します。 **より多くの小売業者への拡張**：同じパターンで、より広い小売業者リストでKiroを再プロンプトすることにより、`web_data_ebay_product`、`web_data_homedepot_products`、`web_data_bestbuy_products`を追加できます。一部の小売業者（Best Buy、Target）では通常、ゾーンでプレミアムドメインを有効にする必要があります。キャプチャされた実行ではAmazonとWalmartは不要でした。 #### Kiroが生成したアーキテクチャ ダッシュボードはマウント時にAPIを取得します。APIはBright Dataのデータセットトリガーを並列で呼び出し、構造化されたレコードを返します。 ```none ブラウザが/を開く │ ▼ (マウント時に自動取得) GET /api/scrape-prices │ ▼ src/scrapers/price-tracker.ts fetchAllPrices() │ ▼ (Promise.allSettled, 並列) ┌────────────────────────────────────┐ │ Bright Data Datasets API │ │ gd_l7q7dkf244hwjntr0 → Amazon │ │ gd_l95fol7l1ru6rlo116 → Walmart │ └────────────────────────────────────┘ ``` *1つの読み取りパス：ダッシュボード → APIルート → スクレイパーモジュール → 2つのBright Dataデータセットトリガー。`&pro=1`の場合、スクレイパーモジュールは直接`web_data_`* MCP呼び出しになり、クライアント側のポーリングループがMCPサーバーに移動します。\* #### スクレイパーモジュール `src/scrapers/price-tracker.ts`にはデータセットID、`triggerAndPoll`ヘルパー、そしてBright Dataのレスポンスを一貫した`PriceResult`形状にフラット化する`normalise`ステップが含まれています。以下はファイルのコアで、完全なファイルは約85行です： ```none // src/scrapers/price-tracker.ts (抜粋) const BASE = "https://api.brightdata.com/datasets/v3"; const DATASETS = { Amazon: "gd_l7q7dkf244hwjntr0", Walmart: "gd_l95fol7l1ru6rlo116" } as const; async function triggerAndPoll(datasetId: string, url: string) { // 1. ターゲットURLでPOSTトリガー const trigger = await fetch(`${BASE}/trigger?dataset_id=${datasetId}&include_errors=true`, { method: "POST", headers: { Authorization: `Bearer ${process.env.BRIGHTDATA_API_KEY}`, "Content-Type": "application/json" }, body: JSON.stringify([{ url }]), }); const { snapshot_id } = await trigger.json(); if (!snapshot_id) throw new Error("no snapshot_id returned from trigger"); // 2. スナップショットエンドポイントをポーリング (進行中 = HTTP 202; ~120秒上限) for (let i = 0; i < 24; i++) { await new Promise((r) => setTimeout(r, 5000)); const res = await fetch(`${BASE}/snapshot/${snapshot_id}?format=json`, { headers: { Authorization: `Bearer ${process.env.BRIGHTDATA_API_KEY}` } }); if (res.status === 202) continue; return await res.json(); } throw new Error("snapshot timed out after 120s"); } // 両方の小売業者を並列でトリガー；Promise.allSettledは小売業者ごとにエラーを分離し、 // 1つの不良スナップショットが他方を失敗させないようにします。完全なファイルは各settled結果を // PriceResult（rejectされたものはerrorフィールドを持つ）にマップします。 export async function fetchAllPrices() { return Promise.allSettled( Object.entries(DATASETS).map(([retailer, id]) => triggerAndPoll(id, PRODUCT_URLS[retailer]).then((r) => normalise(r[0], retailer, PRODUCT_URLS[retailer]))), ); } ``` #### KiroのチャットはライブMCPクライアントであり、メモリルックアップではない ビルド中、Kiroのチャットパネルはコードが呼び出すのと同じ`brightdata`サーバーと通信します。Sonyの価格を尋ねられたとき、チャットはモデルのメモリから回答しませんでした。ライブの`search_engine`と`scrape_as_markdown`呼び出しを行い、テーブルを返しました（リファービッシュ品$195.55から新品$248、XM6比較$398）： ![Kiroチャット、完全な実行：エージェントがsearch_engineとscrape_as_markdownを自律的に選択し、Sony WH-1000XM5のAmazonライブ価格を返します。1分24秒、0.9クレジット。](https://media.brightdata.jp/2026/06/kiro-bright-data-6.png)*チャットはビルド中に探索するための手段です。以下のダッシュボードはエンドユーザーが見るものです。* #### ダッシュボード Kiroが生成したホームルート（`/`）は、APIが返すJSONを2つのカラーカード（Amazonオレンジ、Walmartブルー）と、2つのうち安い方を選ぶ緑の「最安値」バナーとしてレンダリングします： ![2026年5月28日14:27のホームルート(/)：Sony WH-1000XM5がAmazonとWalmartの両方で$248と表示され、Amazonに緑の「最安値」バナーが付いたカード表示。](https://media.brightdata.jp/2026/06/kiro-bright-data-7.png)*ホームルート（`/`）ビュー。Sony WH-1000XM5がAmazonとWalmartの両方で$248と表示され、製品タイトル、在庫状態、各ソースから直接読み取られた小売業者ごとのタイムスタンプが表示されています。Walmartの生の`in_stock`とAmazonの`In Stock`はそのまま渡されるため、各ソースが返す内容をそのまま確認できます。アラートを構築する際は、独自のスキーマに正規化してください。* 生のページを自分で検査すると、Amazonの明白な価格セレクター（`span.a-price-whole`）は通常空を返し、実際のものは`.a-price .a-offscreen`です。WalmartはレンダリングされたHTMLに価格をまったく含めず、`