Lv1 ・ 45 分
Step 1 認証(ビジネス向け)
Claude Desktop か Dify で Bright Data を接続し、最初の 1 回を安全に通す。
このページでは、コードを書かずに Bright Data の最初の接続を完了させます。ゴールは、Claude Desktop か Dify のどちらかで Bright Data を呼び出し、最新の Web 情報を 1 回取得できることです。
この手順で得られること
- AI が学習済み知識ではなく、今の Web を見て答える状態を作れる
- API キーを安全に扱う基本が身につく
- 「設定ミスなのか、取得対象の問題なのか」を切り分けられる
小さな検証なら、費用は数百円から数千円の範囲で収まることが多いです。最初は 1 回の取得と 5 件前後の確認で十分です。
ゴールと所要時間
- ゴール: Claude Desktop または Dify で Bright Data を 1 回呼び出し、検索結果かページ取得の応答を確認する
- 所要時間: 約 45 分
- 難易度: Lv1
前提
- Bright Data アカウントを作成済み
- Claude Desktop か Dify のどちらかを使える
- 管理者から API キーを発行してもらえる、または自分で発行できる
手順 1: API キーを発行する
Bright Data の管理画面で、日常利用向けの API キーを 1 本作ります。
- Dashboard の API キー画面を開きます
- 新規作成を押します
- 権限は
USERを選びます - 有効期限は 90 日を目安に設定します
- 表示されたキーを安全な場所に控えます
ここで大事なのは、API キーを パスワード相当として扱うことです。チャット本文や共有スライドに貼らず、ツールの環境変数やシークレット欄に入れます。
手順 2: 利用窓口を 1 つ決める
最初は用途を絞ったほうが迷いません。次のどちらかを選びます。
| やりたいこと | 最初の利用窓口 |
|---|---|
| Google 検索の結果を見たい | SERP 用の利用窓口 |
| 一般的な Web ページを取得したい | Web Unlocker 用の利用窓口 |
管理画面ですでに作成済みなら、その名前を控えます。未作成なら、まずは SERP か Web Unlocker のどちらか 1 つだけ作れば十分です。
手順 3A: Claude Desktop で接続する
Claude Desktop を使う場合は、Claude Desktop で Bright Data を AI に持たせる の手順どおりに設定します。
接続後、次のように聞きます。
Bright Data を使って、Google で「Bright Data 最新ニュース」を検索し、
上位 5 件のタイトルと URL を表で返してください。確認ポイントは次の 3 つです。
- Claude が Bright Data のツール利用を提案すること
- 数十秒以内に結果が返ること
- タイトルと URL が実際の検索結果として読めること
手順 3B: Dify で接続する
Dify を使う場合は、Dify で Bright Data ワークフローを組む の手順どおりに HTTP Request ノードを作ります。
最初のテストでは、入力欄に次のような値を入れるとわかりやすいです。
{
"query": "Bright Data 最新ニュース"
}LLM ノードの指示文は、まずは次の程度で十分です。
取得した結果から、上位 5 件のタイトル、URL、1 行要約を Markdown 表で返してください。手順 4: 最初の成功を確認する
成功の定義は、技術的な細かさではなく次の状態です。
- AI が Bright Data を使って外部情報を取ってきた
- 検索結果かページ内容が見えた
- 自分の業務で使えるイメージが持てた
失敗したときの見直しポイント
| 症状 | まず見ること |
|---|---|
| 401 や認証エラー | API キーの入力ミス、期限切れ |
| 結果が空 | 利用窓口名の間違い、対象指定の曖昧さ |
| Claude が Web を見に行かない | 「Bright Data を使って」と明示する |
| Dify の HTTP ノードが失敗 | Header の設定、シークレット欄の登録漏れ |
ここで残すメモ
最初の 1 回が通ったら、次の 4 点だけは残してください。
- 使った利用窓口名
- どのツールでつないだか
- 何を入力して成功したか
- 失敗したとき何を直したか
このメモがあると、次回からのセットアップ時間がかなり短くなります。
次の一歩
最初の接続が終わったら、次は「毎日または毎週動く」形へ進みます。