Scrapeless と Compare Runs を使用して n8n AI ブランドモニターを構築する
Scraping and Proxy Management Expert
要約
- n8n の AI ブランドモニターは、回答内でのブランド言及と、返却されたソースドメインへのヒットを別々に追跡できる。 回答文中にブランド名が登場しても、そのブランドの Web サイトが選択されたソース一覧に含まれない場合がある。
- インポート可能なワークフローは、同条件の実行同士を比較する。 レポートを n8n Data Tables に保存し、元の回答・ソース URL・変更点を JSON と CSV でエクスポートする。
- 収集失敗は未知の観測として扱う。 空の回答や取得できなかったソース一覧を、ブランドが「消えた」証拠として扱ってはならない。
- スマートフォンケースの例は保持されたベースラインの 1 つにすぎない。 出力の読み方を示すものであり、改善やプラットフォーム全体の可視性スコアを示すものではない。
パイプラインの概要
この n8n の AI ブランドモニタリング・ワークフローは、固定の質問セットを Scrapeless 経由で ChatGPT と Perplexity に送信し、レスポンスを正規化したうえで、以前の一致する実行結果と比較します。
処理の流れは、手動または日次トリガー → モニター設定 → 前回実行の検索 → 質問ごとの入力生成 → 2 つの収集ブランチ → 正規化された観測値 → レポートおよび履歴の保存 → JSON と CSV のダウンロード、となります。
マーケティングチームは、この流れを使って、どの購入者の質問に自社ブランドが含まれているか、公式ドメインが返却ソースに登場するか、どの観測が変化したかを確認できます。測定値の横には常に完全な回答が残るため、推奨なのか偶発的な言及なのかをレビュアーが判別できます。
回答の収集は Scrapeless AI Scraper が行い、n8n がオーケストレーションと履歴の保存を担います。より広い文脈については、n8n AI Scraper インテグレーション概要 が、自動化での回答収集の使い方を説明しています。本記事は、提供されているモニターの完全なレポートフローに焦点を当てます。
前提条件とダウンロード
コミュニティパッケージと Data Tables を許可するセルフホスト版 n8n インスタンスと、ChatGPT および Perplexity の収集にアクセス権と十分なクレジットを持つ Scrapeless API キーが必要です。
検証済みプロジェクトでは n8n 2.35.7 と n8n-nodes-scrapeless@0.5.4 を使用しました。n8n Cloud やその他のホスト版は検証対象外です。以下のオンラインケースは、本記事用に新規収集したものではなく、プロジェクトに保存されている実行結果に基づいています。ここで説明するメインワークフローを自分で実行するには、上記の認証情報とサービスへのアクセスが必要です。
ソースとワークフローファイルを取得するには、公開リポジトリ AI brand monitor repository を使用してください。以下のダウンロードリンクは、レビュー済みコミットを指しています。
- Main collection workflow: ライブ回答を収集し、履歴を保存します。
- Offline practice workflow: 固定の合成レスポンスを使用し、Scrapeless API の呼び出しは行いません。
GitHub 上でファイルを開き、Download raw file を選択します。2 つのワークフローは分けて保持し、合成観測値が本番のモニタリング履歴に混入しないようにしてください。
ステップ 1: ノードをインストールし、空のワークフローをインポートする
このワークフローは、両方の収集ブランチで Scrapeless Official コミュニティノードを使用します。
n8n のオーナーまたは管理者として Settings → Community nodes → Install を開き、n8n-nodes-scrapeless@0.5.4 を入力します。必要なロールやパッケージバージョンの指定方法については、コミュニティノードのインストール手順を参照してください。
新しい空のワークフローを作成します。ワークフローの三点リーダーメニューを開き、Import → From file(またはその表記を使うバージョンでは Import from File)を選択します。メインの JSON ファイルを選択して保存します。コードノードが参照しているノード名が変わる可能性があるため、既存のワークフローにインポートせず、空のキャンバスを使うことが重要です。
インポート後、Configure Monitor、2 つの Scrapeless ノード、Merge Observations、Build Report、およびダウンロード用ノードを探します。Scrapeless n8n インテグレーション では、ノードの他のオペレーションが紹介されていますが、このデモでは AI Scraper リソースのみを使用します。
ステップ 2: 両方の回答エンジンを接続する
両方の Scrapeless ノードで、意図した n8n クレデンシャルと同一のプロンプト入力を使用する必要があります。
Scrapeless ChatGPT を開き、Scrapeless API 認証情報を作成または選択し、そのキーを API Key に入力します。Scrapeless Perplexity でも同じ認証情報を選択します。n8n がインポート時に自動入力している場合でも、両方の選択を必ず確認してください。認証情報はモニターの Code ノードやエクスポートしたサンプルには含めないでください。
| Setting | Scrapeless ChatGPT | Scrapeless Perplexity |
|---|---|---|
| Resource | AI Scraper | AI Scraper |
| Operation | ChatGPT | Perplexity |
| Prompt | {{ $json.prompt }} |
{{ $json.prompt }} |
| Country | {{ $json.country }} |
{{ $json.country }} |
| Web Search | On | On |
| Shopping | Off | No switch in this node |
メインのワークフローは、質問ごとに 2 つのリモート収集タスクを送信します。小さめのプロンプトパネルから始め、定期スケジュールを有効化する前に現在の Scrapeless の料金を確認してください。
Step 3: スマートフォンブランドのシナリオを構成する
モニターの構成では、ブランド、その文字通りの別名、一致させるドメイン、および正確な質問セットを定義します。
Configure Monitor を開きます。const config = に代入されているオブジェクトだけを置き換え、代入そのものとその下の処理コードは保持します。この構成は、保持されるスマートフォンケースの入力です。
json
{
"brand": "Samsung",
"aliases": ["Samsung", "Samsung Galaxy"],
"domains": ["samsung.com"],
"country": "US",
"prompts": [
{
"id": "smartphone-brands-shortlist",
"text": "I'm buying a smartphone in the US for under $1,000. Which three phone brands should I compare for camera quality, battery life, and long-term software support? Explain the tradeoffs and link to official manufacturer pages."
},
{
"id": "travel-phone-shortlist",
"text": "For travel photography and all-day battery life, which three smartphone brands should a US buyer shortlist? Give one current phone model from each and link to official specifications. Avoid rumors and unreleased products."
},
{
"id": "samsung-support-evaluation",
"text": "For a Samsung Galaxy smartphone sold in the US, where can I verify its software update policy, warranty, and repair options? Explain what to check and cite official Samsung pages."
}
]
}
最初の 2 つの質問は、監視対象ブランドを与えずにカテゴリ発見をテストします。サポートの質問は Samsung を明示的に指定しています。結果を解釈するときはこれらのグループを分けてください。サポートの回答は、そのブランドについて議論するようプロンプトされています。
ドメインルールは samsung.com とそのサブドメインに一致します。どの市場向けのページかを検証したり、リダイレクトを追跡したり、他ドメインの所有者を推測したりはしません。デモを調整するときは、ブランド、別名、ドメイン、質問を一緒に変更してください。安定したプロンプト ID を選び、比較のために文言は完全に同一に保ちます。
Start Scraping with Scrapeless
Scrapeless で Web スクレイピングと自動化ワークフローを強化しましょう。
いますぐ登録して $5 分の無料クレジット を獲得 — クレジットカードは不要 です。Scrapeless ダッシュボードから今すぐ無料クレジットを請求してください。
Step 4: レポートを実行して読む
完全なレポートには、空の回答やエラーを含め、予定されたすべての質問とエンジンの組み合わせの記録が含まれます。
注: メインワークフローを実行すると有料サービスへのリクエストが発生し、設定済みの Scrapeless 認証情報が必要です。本記事の履歴ケースはプロジェクト証跡として保持されており、オフラインワークフローは合成データを生成します。
保存して Execute workflow を選択します。Build Report で report_complete を確認し、そのうえで各観測の status を確認します。この構成では、完全なレポートには 6 件の観測が含まれます。all_answers_valid はすべての回答が空でないことを意味しますが、ソースの有無は別途チェックが必要です。
| Field | Meaning |
|---|---|
status |
ok、empty、または error のいずれか。コレクションの失敗はブランド不在を意味しません |
brand_mentioned |
ブランドまたは別名が可視の回答テキストに一致した |
matched_aliases |
一致した名前であり、言及回数や順位ではありません |
source_field |
ChatGPT に対しては content_references、Perplexity に対しては web_results |
source_status |
available、unavailable、または invalid |
brand_source_found |
完全でパース可能なソースリスト内に、設定済みホスト名が出現した |
source_urls |
返却された URL の重複排除済み集合。ワークフローはこれらのページを取得しません |
matched_source_urls |
設定したホスト名に一致したサブセット |
ブランド言及率は、有効な回答を分母として使用します。ソースヒット率は、完全でパース可能なソースリストを持つ有効回答を分母として使用します。ソースフィールドが欠落している場合は不明のままです。明示的な空配列は測定可能であり、返却ソースヒットなしを意味します。不正な配列は、いくつかの URL を復元できたとしても依然として無効です。
この区別により、収集の問題が可視性の欠如に見えることを防ぎます。また、2 つの率で分母が異なり得る理由も説明します。JSON の率は 0 から 1 の間の分数であり、分母が 0 のときは null を生成します。
ai-brand-report.json の Download JSON Report → Binary → Download を開きます。ai-brand-observations.csv の Download CSV Observations → Binary → Download を開きます。回答テキストを正確に扱う必要がある場合は JSON を保持してください。CSV は TRUE と FALSE を使用し、不明なスカラー値は空白のままとし、配列は JSON 文字列としてエンコードします。数式のようなテキストは、CSV では先頭にアポストロフィが付きます。
Step 5: 実行結果を比較し、スケジュールを設定する
モニターは、同じモニタリング構成に対する最新の保存済み過去実行結果と現在のレポートを比較します。
最初の実行では、n8n プロジェクト内に ai_brand_monitor_history が作成されます。その comparison.previous_run_id は null であり、変更は no_baseline です。後続の実行では、同じ比較グループに留まるために、ブランド、エイリアス、ドメイン、国、プロンプト ID、およびプロンプト文を変更せずに維持してください。
エンジンノードの設定も一貫している必要があります。Web Search などのエンジン設定を手動で変更しても、ワークフローのグルーピングキーは変わらないため、それらの変更は自分で記録し、必要に応じて別のベースラインを確立してください。
| Change | Interpretation |
|---|---|
gained |
既知の値が false から true に変化した |
lost |
既知の値が true から false に変化した |
unchanged |
両方の既知の値が一致している。存在か欠如かを区別するには値を確認する |
unknown |
少なくとも一方の値を特定できなかった |
no_baseline |
一致する以前の観測が存在しない |
brand_mention_change と brand_source_change は個別に確認してください。comparison.changes は値が増えた、または失われた観測を列挙します。完全な observations 配列には、変更されていないレコードや不明なレコードも保持されます。changed_observations は、少なくとも 1 つの値が増加または減少した質問とエンジンのペア数をカウントします。
練習として、オフラインワークフローを 2 回実行してください。これはライブ履歴とは別の ai_brand_monitor_demo_history を使用します。これらは人工的な比較であり、AI の可視性が変化している証拠ではありません。
手動実行が成功したら、Daily Schedule で時と分を設定し、Settings でワークフローのタイムゾーンを確認し、ワークフローを公開します。スケジュールトリガーの公開とタイムゾーンのルールでは、スケジュール実行がいつ開始されるかを説明しています。完了した実行とダウンロードには Executions を、保存されたレポートには Data Tables を使用します。保持されたプロジェクト検証では、複数日にわたるスケジューリングは対象外でした。
保持されたスマートフォン事例が示すもの
保持されたベースラインには、3 つの質問それぞれについて、両エンジンからの有効な回答と、パース可能なソースリストが含まれています。
2 つのカテゴリ質問の両方で、Samsung は各エンジンの回答に登場しました。選択された 4 つの返却ソースリストのいずれにも、設定済みの Samsung ドメインは含まれていませんでした。公式リンクは依然として回答テキスト内に現れる可能性があります。回答本文のリンクと返却ソースフィールドは別々の測定項目です。
指名ブランドのサポート質問では、ChatGPT は 5 つの一意のソース URL を返し、そのうち 4 つが設定済みドメインに一致していました。Perplexity は 10 個を返し、すべて一致していました。一部の Perplexity ソースは、米国向けの質問にもかかわらず、インドまたは英国に言及していました。したがって、ホスト名の一致だけでは地域的な関連性を立証できませんでした。
この n8n AI ブランドモニタリングケースは、文字通りの言及とドメインヒットを測定します。感情、推薦ポジション、事実の正確さ、トラフィックを自動的に測定するものではありません。また、保存されたベースラインからは 2 回目の実行による改善を示すことはできません。測定結果をマーケティング上の主張に変える前に、各観測の背後にある元の回答を読んでください。
結論
小規模で固定された購入者質問セットから始め、最初のレポートを確認し、その元の回答を保持してください。その後の比較可能な実行では、返却ソースの変化とあわせて、増えた言及と失われた言及を確認します。失敗した観測は不明のままにし、カテゴリ質問と指名ブランド質問は分けておきます。こうした選択により、サンプリングされた AI 回答が証明できることを誇張することなく、定期的なコンテンツレビューに役立つレポートになります。
ブランドモニタリングワークフローを構築する準備はできましたか?
回答モニタリングパイプラインを構築している開発者とつながるには、コミュニティに参加してください: Discord · Telegram。
Scrapeless を始める から、自社ブランドと質問セットにあわせてワークフローを調整してください。
FAQ
Q: この n8n AI ブランドモニターには自律エージェントが必要ですか?
いいえ。インポートされたワークフローは、固定された収集とレポートのシーケンスを実行します。設定した質問が、各エンジンに何を送るかを決定します。
Q: デモは API キーなしで実行できますか?
オフラインワークフローは、合成レスポンスを使用するため Scrapeless キーなしで実行できます。メインワークフローには、両エンジンへのアクセスとクレジットを持つキーが必要です。
Q: ソースリストがないことは、ブランドの引用がないことと同じですか?
いいえ。リストが欠落している、または無効である場合は「不明」です。完全な空リストは、その観測について返却ソースヒットがなかったことを意味します。どちらの結果も、回答本文内のすべてのリンクを説明するものではありません。
Q: ドメインヒットはそのブランドが推奨されたことを証明しますか?
いいえ。ドメインヒットは、選択された返却ソースリストに一致するホスト名が現れたことを意味するだけです。推薦の文脈、ページの関連性、地域的な適合性は、目視での確認が必要です。
Q: なぜ新しい実行にベースラインがなかったのですか?
新しい構成は別の比較グループを作成し、過去に一致する観測がない質問とエンジンの組み合わせにはベースラインがありません。保存済みの構成と previous_run_id を確認してください。
Q: 1つのレポートで AI ブランドの総合的な可視性を測定できますか?
いいえ。1つのレポートが対象とするのは、選択されたプロンプト、エンジン、設定、および収集時点のみです。反復的で比較可能なサンプルは、限定された範囲での観測を支えることはできますが、プラットフォーム全体のランキングを確立したり、コンテンツの編集が変化を引き起こしたことを証明したりはしません。
Scrapelessでは、適用される法律、規制、およびWebサイトのプライバシーポリシーを厳密に遵守しながら、公開されているデータのみにアクセスします。 このブログのコンテンツは、デモンストレーションのみを目的としており、違法または侵害の活動は含まれません。 このブログまたはサードパーティのリンクからの情報の使用に対するすべての責任を保証せず、放棄します。 スクレイピング活動に従事する前に、法律顧問に相談し、ターゲットウェブサイトの利用規約を確認するか、必要な許可を取得してください。



