ビジネスユーザー向けモードで表示中プログラマー向けへ
Bright Data 学習ポータル

Lv145

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 本作ります。

  1. Dashboard の API キー画面を開きます
  2. 新規作成を押します
  3. 権限は USER を選びます
  4. 有効期限は 90 日を目安に設定します
  5. 表示されたキーを安全な場所に控えます

ここで大事なのは、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 つです。

  1. Claude が Bright Data のツール利用を提案すること
  2. 数十秒以内に結果が返ること
  3. タイトルと 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 点だけは残してください。

  1. 使った利用窓口名
  2. どのツールでつないだか
  3. 何を入力して成功したか
  4. 失敗したとき何を直したか

このメモがあると、次回からのセットアップ時間がかなり短くなります。

次の一歩

最初の接続が終わったら、次は「毎日または毎週動く」形へ進みます。

プログラマー向けの詳細