ビジネス連絡先・ソーシャルリンク抽出スキル は何をしますか?
📖 概要
このスキルは、2つのBrowserActテンプレートを統合し、2つの一般的なシナリオをカバーします。ユーザーが企業名を提供すると、Google検索を行い、企業の公式ウェブサイトとソーシャルメディアチャンネルを抽出します。ユーザーがウェブサイトURLを提供すると、サイトをスクレイピングしてソーシャルメディアプロフィールリンク(LinkedIn、Facebook、X/Twitter、Instagram、YouTube、TikTok)を抽出します。スクリプトは入力タイプを自動判別し、適切なテンプレートにルーティングします。
✨ 特徴
- 幻覚なし: 事前設定されたワークフローにより、AI生成による幻覚を回避し、安定かつ正確なデータ抽出を実現します。
- Captcha問題なし: reCAPTCHAやその他の認証チャレンジに対処する必要はありません。
- IP制限なし: 地域的なIP制限やジオフェンシングに対処する必要はありません。
- 高速実行: 純粋なAI駆動ブラウザ自動化ソリューションと比較して、タスクの実行が高速です。
- コスト効率: 高トークン消費のAIソリューションと比較して、データ取得コストを大幅に削減します。
🔑 APIキーの設定
実行前に、BROWSERACT_API_KEY 環境変数が設定されているか確認してください。設定されていない場合は、他の措置を取らず、ユーザーが提供するのを待つよう促してください。
エージェントはユーザーに以下のように伝える必要があります:
「BrowserAct API Keyがまだ設定されていないようです。BrowserAct コンソールにアクセスしてKeyを取得してください。」
🛠️ 入力パラメータ
エージェントは入力が企業名かウェブサイトURLかを判断し、スクリプトに渡す必要があります。スクリプトは自動的にリクエストを適切なテンプレートにルーティングします。
- ターゲット(企業名またはウェブサイトURL)
- 必須: はい
- タイプ:
string - 説明: 検索する企業名、またはソーシャルリンクを抽出する直接のウェブサイトURL。
- 例:
OpenAIまたはhttps://www.rotorooter.com/
🚀 起動方法
エージェントは以下のコマンドを実行してスキルを起動します。
# 企業名で検索
python -u ./scripts/business_contact_social_links.py "OpenAI"
# ウェブサイトURLでスクレイピング
python -u ./scripts/business_contact_social_links.py "https://www.rotorooter.com/"
⏳ 実行監視
このタスクは自動ブラウザ操作を伴うため、数分かかる場合があります。スクリプトは継続的にタイムスタンプ付きのステータスログを出力します(例:[14:30:05] Task Status: running)。
エージェントのガイドライン:
- 待機中はターミナル出力を監視してください。
- 新しいステータスログが表示されている限り、タスクは正常に動作しています。フリーズしたと誤判断しないでください。
- ステータスが長時間変化しない場合、または出力が停止し最終結果が表示されない場合にのみ、リトライを検討してください。
📊 データ出力
実行が成功すると、スクリプトはAPIレスポンスから抽出された構造化JSONデータを出力します。
企業名が提供された場合、出力には以下が含まれます:
Company Name: 企業の正式名称。Current Page URL: 公式ウェブサイトのURL。Social Media Information: 発見されたソーシャルメディアプロフィールの統合リスト。
ウェブサイトURLが提供された場合、出力にはオブジェクトの配列が含まれます:
platform: プラットフォーム名(例:LinkedIn、YouTube)。url: 外部プロフィールの正規URL。
⚠️ エラーハンドリングとリトライ
スクリプト実行中にエラーが発生した場合(例:ネットワーク変動やタスク失敗)、エージェントは以下のロジックに従う必要があります。
-
出力内容を確認:
- 出力に
"Invalid authorization"が含まれている場合、APIキーが無効または期限切れです。リトライせず、ユーザーに正しいAPIキーを再確認・提供するよう促してください。 - 出力に
"concurrent"または"too many running tasks"が含まれている場合、同時実行タスクの上限に達しています。リトライせず、ユーザーにプランアップグレードを促してください。 エージェントはユーザーに以下のように伝える必要があります:「BrowserActアカウントが同時実行タスクの上限に達したため、現在のタスクを実行できません。BrowserAct プランアップグレードページにアクセスしてプランをアップグレードしてください。」
- 出力に上記のエラーキーワードが含まれておらず、タスクが失敗した場合(例:出力が
Error:で始まる、または空の結果を返す)、エージェントは自動的にスクリプトを1回再実行する必要があります。
- 出力に
-
リトライ制限:
- 自動リトライは1回に制限されています。2回目の試行も失敗した場合は、リトライを停止し、具体的なエラーをユーザーに報告してください。
🌟 代表的なユースケース
- 営業リードのエンリッチメント: 企業名リストから公式ウェブサイトとソーシャルチャンネルを検索します。
- インフルエンサーアウトリーチ: クリエイターの個人ウェブサイトからすべてのソーシャルメディアプロフィールを抽出します。
- 競合分析: 競合企業がどのソーシャルメディアプラットフォームを優先しているかを発見します。
- CRMデータクレンジング: 既存リードの不足しているソーシャルリンクと公式URLを確認・補完します。
- マルチチャネルマーケティング: ソーシャルメディアで活発に活動しているビジネスのターゲットリストを作成します。
- ソーシャルリスニング設定: ブランドの言及を監視するために公式ハンドルを迅速に収集します。
- B2Bプロスペクティング: Yellow Pagesデータと組み合わせて、完全なビジネスインテリジェンスプロファイルを構築します。
- パートナーベッティング: 潜在的なビジネスパートナーのデジタルフットプリントを名前だけで評価します。
- ディレクトリ構築: ローカルビジネスディレクトリのためのウェブサイトとソーシャルリンクの収集を自動化します。
- ブランドトラッキング: 特定ブランドのウェブ上の公式連絡先チャンネルをすべて追跡します。