サイトキャプチャ

サイトキャプチャノードは、Web ページをスマートフォンで見たとおりに開き、主なセクション（ヒーロー、機能、料金、レビュー）を 1 枚ずつスチルとして撮影します。ノードは先にページを最後までスクロールするため、スクロールしたときに表示されるセクションも撮影されます。スチルはページ順に、スマートフォンのカードの形で出力され、そのまま動画の画面に使えます。あわせて、ページ全体の 1 枚の画像、セクションの一覧、料金・件数・評価など、ページに書かれた正確な数値も返します。

使いどころ

• 実際の商品ページを動画に映します。たとえば、トーキングヘッドのクリップの上にカードとして重ねます。
• ページのセクションを、スチルごとに 1 回ずつ説明したりアニメーションにしたりします。
• ページをスライドショーやコラージュにします。
• スクリーンショットから書き写す代わりに、ページの正確な料金や数値を台本に取り込みます。

クイックスタート

設定

入力

出力

JSON 出力は次のような形です（一部省略）。

{
  "finalUrl": "https://www.example.com/",
  "title": "Example: the product",
  "fullPage": { "url": "https://…/full.jpg", "width": 412, "height": 6420 },
  "stills": [{ "index": 0, "label": "Ship faster", "category": "hero", "url": "https://…/0.png" }],
  "sections": [{ "order": 0, "label": "Ship faster", "category": "hero", "text": "…", "stillIndex": 0 }],
  "facts": ["$12 per month", "4.8/5", "10,000 teams"],
  "warnings": []
}

セクションの category は、hero、feature、pricing、proof、faq、cta、other のいずれかです。

クレジット

スチルの枚数にかかわらず、1 回のキャプチャにつき 11 クレジットです。

• 失敗したキャプチャは返還されます。 アクセスをブロックしたページ、何も表示されないページ、到達できないページ、時間切れになったキャプチャが対象です。
• 料金がかかる前に断られるページもあります。 自動アクセスを避けるよう求めているサイト（robots.txt）のページや、存在しないアドレスです。

セルフホストのインストールでは、プロバイダーキーで説明している Web スクレイピング用のキー、または Nodaro Cloud への接続が必要です。インストール側でキャプチャをオフにすることもでき、その場合ノードは表示されません。

ヒント

• 正確な数値を使います。 ページの料金や数値は JSON 出力の facts から取り出せば、台本が画像から読み違えることはありません。
• 必要なスチルを選びます。 スチルにはそれぞれ category があるので、ヒーローと料金だけを残すといった使い方ができます。
• スチルはライブラリーに残ります。 保存するまで、メディアピッカーには表示されません。

トラブルシューティング

API から

POST /v1/site-capture に { "url": "…", "maxStills": 8 } を送ると、同じキャプチャをコードから実行できます。応答はすぐに jobId で返るので、完了したジョブのキャプチャを GET /v1/jobs/:id で読み取ります。単一ノードの実行とジョブを参照してください。