| name | bright-search |
| description | Bright Data SERP API を使って必要な情報を集め、Markdown に整理する OpenClaw 向けのリサーチスキル。人物、サービス、競合、料金、実績、 導入手順などの下調べに使い、検索結果を根拠付きの調査メモへ落とし込む。 Soul や Skill を作る前の情報収集にも向く。 Use when: 必要な情報を集めて整理したい、Bright Data で調査したい、 OpenClaw 用の材料を集めたい、Soul/Skill の前に下調べしたい。 Triggers: "bright-search", "Bright Data で調べる", "必要な情報を集めて整理", "OpenClaw の調査", "Soul 用に情報収集", "人物の材料を集める"
|
bright-search
Bright Data を使って Web 検索し、必要な情報を
「使える調査メモ」に整理するためのスキル。
目的
- 検索で見つけた情報を、あとで Soul や Skill に流し込める形にする
- 事実、仮説、不明点、参照元を分けて残す
- OpenClaw デモで必要な「この人に相談できるサービス」の材料を集める
セットアップ
以下の環境変数が必要:
export BRIGHTDATA_API_KEY="your-api-key"
export BRIGHTDATA_UNLOCKER_ZONE="your-zone-name"
bright-search/.env に書いておけば、scripts/bright_search.sh 実行時に自動で読み込まれる。
検索スクリプト:
bash scripts/bright_search.sh "query" [cursor]
Bright Data の生リクエストに近い形を読みたいときは、
references/request-spec.md を読む。
そのまま叩ける薄いラッパーは scripts/request_google_serp.sh。
使い方
1. 調査のゴールを先に固定する
最初に以下を 1〜3 行で定義する:
- 何を調べるか
- 最終的に何を作るか
- 何が分かれば前に進めるか
例:
Haruki の知見を元に「この人に相談できる」OpenClaw デモを作る。
Soul と Skill に必要な専門領域、相談スタイル、料金感、実績、話し方を集める。
2. クエリを 3〜8 本に分解する
広すぎる 1 本ではなく、観点ごとに分ける。
推奨カテゴリ:
- 基本プロフィール
- 専門領域
- 実績、登壇、記事
- 相談テーマ、支援内容
- 料金やプラン
- 話し方、思想、よく使う表現
例:
bash scripts/bright_search.sh "Haruki consultant profile"
bash scripts/bright_search.sh "Haruki interview marketing strategy"
bash scripts/bright_search.sh "Haruki pricing consulting"
3. 生データを残す
検索結果はトピックごとに保存する。
mkdir -p research/raw/haruki
bash scripts/bright_search.sh "Haruki consultant profile" > research/raw/haruki/01-profile.json
bash scripts/bright_search.sh "Haruki pricing consulting" > research/raw/haruki/02-pricing.json
生の API 応答を確認したいときは:
bash scripts/request_google_serp.sh "pizza"
4. Markdown に整理する
references/research-template.md を元に、最低限以下を埋める:
- 調査目的
- 検索クエリ一覧
- 事実
- 仮説
- 未確認事項
- 参照 URL
保存先の目安:
research/{topic}.md
例:
research/haruki.md
5. OpenClaw 用に整形する
人物ベースのデモなら、特に以下を明確にする:
- この人は誰か
- 何の専門家か
- どんな相談に強いか
- どういう話し方をするか
- いくらで相談を受ける想定か
- 何を言い切れて、何はまだ仮説か
必要に応じて、この調査メモを soul-generator に渡して Soul 化する。
出力品質の基準
- 重要な主張には参照 URL を付ける
- 事実と推測を混ぜない
- 「分からないこと」は未確認として残す
- そのまま Soul や Skill の素材として再利用できる粒度にする
OpenClaw デモ向けの観点
「この人に相談できるサービス」を作るときは、以下の観点で整理する:
- Identity: 経歴、立ち位置、肩書き
- Expertise: 何に強いか、どこまで深いか
- Consulting Themes: 何を相談できるか
- Tone: どういう口調か、どう説明するか
- Commercials: 料金感、支援メニュー
- Evidence: 実績、記事、登壇、紹介文
- Gaps: まだ取れていない情報
やらないこと
- 参照元なしで断定しない
- 一つの検索結果だけで人物像を決め切らない
- 情報を集めただけで終わらせず、必ず Markdown に再構成する
