⚠️ このリポジトリは非推奨です
このリポジトリはメンテナンスされていません。 新しい場所に移行しました：
➡️ browser-act/browseract-api-examples
最新のコード、バグ修正、ドキュメントについては新しいリポジトリをご利用ください。
このリポジトリは読み取り専用のアーカイブとして残されます。
BrowserAct API デモコレクション
AI Webスクレイパー & 自動化 - あらゆるサイト、コード不要、制限なし、信頼できるデータ
このリポジトリには、BrowserAct（AI搭載のWebスクレイピング・自動化プラットフォーム）の包括的なAPIデモコードが含まれています。デモは、複数のプログラミング言語を使用してBrowserActのAI-Workflow機能をアプリケーションに統合する方法を示しています。
🚀 クイックスタート
🎯 新規ユーザー向け（推奨）
完全なワークフローを示すシナリオベースの例から始めてください：
- Python: Scenarios-Python - 複数のAPIを組み合わせた完全な例
scenario_1_run_and_wait.py- カスタムワークフローを実行し完了を待つscenario_2_run_template_and_wait.py- テンプレートタスクを実行し完了を待つ（初心者に最適）
- Java: Scenarios-Java - 複数のAPIを組み合わせた完全な例
Scenario1RunAndWait.java- カスタムワークフローを実行し完了を待つScenario2RunTemplateAndWait.java- テンプレートタスクを実行し完了を待つ
- Node.js: Scenarios-NodeJs - 複数のAPIを組み合わせた完全な例
scenario1_runAndWait.js- カスタムワークフローを実行し完了を待つscenario2_runTemplateAndWait.js- テンプレートタスクを実行し完了を待つ
📚 APIリファレンス向け
好みの言語を選び、個別のAPI例を探索してください：
| 言語 | Workflow API | シナリオ例 | クイックスタート |
|---|---|---|---|
| Python | Workflow-Python | Scenarios-Python | python Scenarios-Python/scenario_1_run_and_wait.py |
| Java | Workflow-Java | Scenarios-Java | cd Scenarios-Java && mvn exec:java -Dexec.mainClass="com.browseract.scenarios.Scenario1RunAndWait" |
| Node.js | Workflow-NodeJs | Scenarios-NodeJs | node Scenarios-NodeJs/scenario1_runAndWait.js |
📁 プロジェクト構成
browseract-api-demos/
├── Workflow-Python/ # Python Workflow API デモ
├── Workflow-Java/ # Java Workflow API デモ
├── Workflow-NodeJs/ # Node.js Workflow API デモ
├── Scenarios-Python/ # Python シナリオベース例（新規ユーザー推奨）
├── Scenarios-Java/ # Java シナリオベース例（新規ユーザー推奨）
├── Scenarios-NodeJs/ # Node.js シナリオベース例（新規ユーザー推奨）
├── .gitignore # Git 無視ルール
└── README.md # このファイル
🎯 BrowserActとは？
BrowserActは、AI搭載のWebスクレイピング・自動化プラットフォームであり、2つのコア機能を提供します：
🔄 AI-Workflow
- 事前定義テンプレート: 一般的なスクレイピングタスク用のビルド済みワークフロー
- カスタムワークフロー: 独自の自動化シーケンスを作成
- バッチ処理: 複数のURLとデータソースを効率的に処理
📚 API機能
Workflow API エンドポイント
| エンドポイント | メソッド | 説明 |
|---|---|---|
/v2/workflow/run-task | POST | 新しいワークフロータスクを開始 |
/v2/workflow/stop-task | PUT | タスクを完全に停止 |
/v2/workflow/get-task | GET | タスクの詳細情報を取得 |
/v2/workflow/get-task-status | GET | タスクのステータスのみ取得 |
/v2/workflow/list-tasks | GET | すべてのタスクを一覧表示 |
/v2/workflow/list-workflows | GET | すべてのワークフローを一覧表示 |
/v2/workflow/get-workflow | GET | ワークフローの詳細を取得 |
🛠 言語サポート
Python
- バージョン: Python 3.8+
- 依存関係: HTTPリクエスト用
requests - 特徴: シンプルで読みやすいコード、包括的なエラーハンドリング
- 最適な用途: 迅速なプロトタイピングとデータサイエンスワークフロー
Java
- バージョン: Java 8+
- ビルドツール: Maven
- 依存関係: JSON処理用 Jackson、HTTPリクエスト用 HttpURLConnection
- 特徴: 適切なパッケージ構造を持つエンタープライズグレードのコード
- 最適な用途: エンタープライズアプリケーションとマイクロサービス
Node.js
- バージョン: Node.js 14+
- 依存関係: 組み込み
httpsモジュール - 特徴: 軽量、async/awaitファースト
- 最適な用途: Webアプリケーションとサーバーレス関数
🔧 設定
例を実行する前に、以下が必要です：
- APIキー: BrowserAct Integrations からAPIキーを取得
- ワークフローID（Workflow API用）: ワークフローリスト からワークフローIDを取得
各例のファイルで設定を更新してください：
"app-abcdefghijklmn"を実際のAPIキーに置き換え1234567890を実際のワークフローIDに置き換え
🔒 セキュリティのベストプラクティス
重要: これらの例ではデモ目的でプレースホルダーのAPIキーを使用しています。本番環境では：
- ソースコードにAPIキーをハードコードしない
- 環境変数または安全な設定ファイルを使用する
- APIキーを機密扱いとし、定期的にローテーションする
環境変数の例
# Python
import os
authorization = os.getenv("BROWSERACT_API_KEY")
// Java
String authorization = System.getenv("BROWSERACT_API_KEY");
// Node.js
const authorization = process.env.BROWSERACT_API_KEY;
📖 ドキュメント
- APIドキュメント: BrowserAct API ドキュメント
- Workflow API: Workflow API リファレンス
🤝 サポート
- Discord コミュニティ: Discordに参加
- メールサポート: [email protected]
- GitHub Issues: バグ報告または機能リクエスト
📄 ライセンス
このデモコードは、教育および開発目的のために現状のままで提供され、MITライセンス の下で利用できます。
🌟 特徴
- 多言語サポート: Python、Java、Node.jsの実装
- 完全なAPIカバレッジ: すべてのBrowserAct APIエンドポイントを含む
- 本番準備完了: 適切なエラーハンドリングを備えたエンタープライズグレードのコード
- 使いやすい: すぐに実行できるシンプルな例
- 充実したドキュメント: 各言語の包括的なREADMEファイル
- モダンな標準: 各言語のベストプラクティスに準拠
さっそく始めましょうか？ 上の言語を選んで例を試してみてください！ 🚀
詳細は BrowserAct をご覧ください。