catalyst-smartbrowz

前提条件

SmartBrowz を使用する前に、プロジェクトごとにコンソールで一度有効化してください。

Console → プロジェクト → SmartBrowz（左サイドバー）→ "Start Exploring" をクリック

この手順を省略すると、Headless、Browser Logic、PDF & Screenshot、Templates、Browser Grid、Dataverse の各コンポーネントにアクセスできません。

Browser Logic 関数を使用する場合： Catalyst CLI のインストールが必要です。CLI を使用して Browser Logic 関数を初期化し、デプロイしてください（コンソールから直接作成することはできませんが、アップロードは可能です）。

---

仕組み

1. マルチコンポーネントサービス — SmartBrowz は、統合プラットフォームで6つの独立したコンポーネントを提供します。

   • Headless：自動化ライブラリを使用して、Catalyst クラウド上のリモート Chrome／Firefox に接続します
   • Browser Logic：ブラウザー自動化ロジックを含むサーバーレス関数（Java／Node.js）です
   • PDF & Screenshot：プログラムでビジュアルドキュメントを生成します
   • Templates：動的コンテンツ向けのテンプレートを設計して保存します
   • Browser Grid（早期アクセス）：オートスケーリングに対応した並列ヘッドレスブラウザーです
   • Dataverse：データスクレイピング API です

2. ワークフローを選択します。

   • Headless モード：コンソールで提供されるエンドポイントとコードスニペットをコピーし、Puppeteer／Playwright／Selenium に接続します
   • Browser Logic：CLI で初期化し、IDE でコーディングしてコンソールにデプロイします。継続的なブラウザー自動化タスクに適しています
   • PDF & Screenshot：コンソールの Playground、SDK（Java／Node.js／Python）、または API を使用してドキュメントを生成します
   • Browser Grid：ノード数とブラウザー数を設定し、CDP／Webdriver エンドポイント経由で接続して、リクエストを並列処理します

3. references/smartbrowz-basics.md を読み込みます — コンポーネントの詳細、自動化ライブラリのセットアップ、Browser Logic の構造、PDF／Screenshot SDK の使用方法、Browser Grid の設定、トラブルシューティングについて説明しています

4. SDK 優先ルール — 実装コードを記述する場合は、常に生の REST API 呼び出しよりも SDK メソッドを優先してください。

   • Node.js：app.smartbrowz()（小文字 — app.SmartBrowz() は関数ではありません）→ smartbrowz.convertToPdf()、smartbrowz.generateFromTemplate()、app.smartbrowz().browserGrid() → grid.getGrid()、grid.stopGrid()
   • Python：app.smart_browz() → smart_browz.convert_to_pdf()、smart_browz.generate_from_template()、app.smart_browz().browser_grid() → grid.get_all_grid()
   • Java：ZCSmartBrowz.getInstance() → smartBrowz.convertToPdf()、smartBrowz.generateFromTemplate()
   • SDK に同等の機能がない場合に限り、REST API を使用してください（例：Browser Grid のライブ統計情報で free_sessions を確認する場合）

5. 重要な概念：

   • リモートブラウザーは Catalyst クラウド上で実行されます — ローカルではありません。エンドポイントはコンソールで自動生成されます。
   • 接続コードに api-key は不要です — Puppeteer／Playwright／Selenium はエンドポイント URL のみを使用して接続します。api-key は Browser Grid REST API の呼び出し（例：ライブ統計情報）にのみ使用します。
   • 現在は Chrome ブラウザーのみ — Browser Grid では Firefox をサポートしています（早期アクセス）
   • Browser Logic 関数 = サーバーレス関数タイプ — コンソール UI ではなく、CLI で作成します
   • Browser Grid = オートスケーリング — 設定に基づいて、必要に応じてノードとブラウザーが起動します
   • 自動化ライブラリのユースケースをテストするための Code Recipes をコンソールで利用できます

6. セキュリティに関する注意 — ブラウザーの自動化やウェブスクレイピングは、すべて自己責任で行ってください。そのような行為が許可されているドメイン、または適切な承認を得たドメインでのみ使用してください。

セキュリティチェックリスト

• API キーの保護：Headless と Browser Grid のエンドポイントは、自動生成された API キーで保護されています。キーが侵害された場合は再生成してください（注：グリッドの統計情報がリセットされます）。
• Browser Logic のログ：すべての関数のアクティビティは、Console → DevOps → Logs に記録されます。デバッグとセキュリティ監査のため、ログを確認してください。
• Browser Grid のキュー制限：Selenium のリクエストは 30 秒間、Puppeteer／Playwright のリクエストは 5 分間キューに入ります。タイムアウト後、リクエストは強制終了されます。
• Browser Grid のアラート：Dashboard でアラート（Browser Creation Rejected、90% Disk Exhausted、80% Memory/CPU Exhausted、Nodes Crashed）を監視してください。
• デフォルトのストレージ：Browser Grid のノードには 10GB のディスク制限があります。障害を防ぐため、ディスク使用量を監視してください。
• レートに関する注意事項：ブラウザー自動化によって、大量のネットワークトラフィックが発生することがあります。対象ウェブサイトのレート制限と利用規約に注意してください。

トリガー

次のような場合にこのスキルを使用します：「SmartBrowz」、「ヘッドレスブラウザー」、「Headless Browser」、「リモートブラウザー」、「Puppeteer」、「Playwright」、「Selenium」、「ブラウザー自動化」、「Browser Logic」、「PDF 生成」、「ウェブページのスクリーンショット」、「HTML から PDF」、「URL から PDF」、「テンプレート PDF」、「PDF／スクリーンショット生成」、「PDF とスクリーンショット」、「SmartBrowz テンプレート」、「Browser Grid」、「並列ブラウザー」、「ウェブスクレイピング」、「Dataverse」、「CDP エンドポイント」、「Webdriver エンドポイント」、「ヘッドレス Chrome」、「ヘッドレス Firefox」、「ブラウザーテスト」、「自動化ライブラリ」。

リファレンス

リファレンス	クエリが次の内容の場合に読み込みます…
references/smartbrowz-basics.md	Headless のセットアップ（Puppeteer／Playwright／Selenium のコードスニペット）、Browser Logic（CLI コマンド、関数の構造、デプロイ）、PDF とスクリーンショット（コンソールの Playground、Java／Node.js／Python での SDK の使用方法、API 呼び出し、入力形式 HTML／URL／Template）、テンプレート（デザイン、ストレージ、動的コンテンツ）、Browser Grid（設定 Basic／Light／Moderate／Heavy、ノード／ブラウザーのセットアップ、CDP／Webdriver エンドポイント、ワークフロー、アラート、状態 Active／Inactive／Idle、ダッシュボード、推奨事項）、Dataverse（データスクレイピング API）、トラブルシューティング