Browseract

⚠️ このリポジトリは非推奨になりました

このリポジトリはメンテナンスされなくなりました。 新しい場所に移動しました：

➡️ browser-act/browseract-api-examples

最新のコード、バグ修正、ドキュメントについては、新しいリポジトリをご利用ください。

このリポジトリは読み取り専用のアーカイブとして引き続き公開されます。

---

BrowserAct API デモコレクション

AI ウェブスクレイピング＆自動化 - あらゆるサイトに対応、コード不要、制限なし、信頼性の高いデータ

このリポジトリには、AI を活用したウェブスクレイピングおよび自動化プラットフォームである BrowserAct の包括的な 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 demos
├── Workflow-Java/         # Java Workflow API demos
├── Workflow-NodeJs/       # Node.js Workflow API demos
├── Scenarios-Python/     # Python scenario-based examples (recommended for new users)
├── Scenarios-Java/        # Java scenario-based examples (recommended for new users)
├── Scenarios-NodeJs/      # Node.js scenario-based examples (recommended for new users)
├── .gitignore             # Git ignore rules
└── README.md              # This file

🎯 BrowserAct とは？

BrowserAct は、AI を活用したウェブスクレイピングおよび自動化プラットフォームです。次の 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 モジュール
• 特徴：軽量で、非同期処理を優先したアプローチ
• 最適な用途：Web アプリケーションとサーバーレス関数

🔧 設定

サンプルを実行する前に、以下が必要です。

1. API キー：BrowserAct Integrations から API キーを取得します
2. ワークフロー ID（Workflow API 用）：Workflow List からワークフロー ID を取得します

各サンプルファイルの設定を更新してください。

• "app-abcdefghijklmn" を実際の API キーに置き換えます
• 1234567890 を実際のワークフロー ID に置き換えます

🔒 セキュリティのベストプラクティス

重要：サンプルでは、デモ用のプレースホルダー API キーを使用しています。本番環境では、以下を守ってください。

1. ソースコードに API キーをハードコードしないでください
2. 環境変数または安全な設定ファイルを使用してください
3. 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 Docs
• Workflow API：Workflow API Reference

🤝 サポート

• Discord コミュニティ：Discord に参加
• メールサポート：[email protected]
• GitHub の Issue：バグの報告や機能のリクエスト

📄 ライセンス

このデモコードは、MIT Licenseのもと、教育および開発目的で現状のまま提供されています。

🌟 特徴

• 多言語対応：Python、Java、Node.js の実装
• API を網羅：BrowserAct のすべての API エンドポイントを収録
• 本番環境対応：適切なエラー処理を備えたエンタープライズグレードのコード
• 使いやすい：すぐに実行できるシンプルなサンプル
• ドキュメントが充実：各言語の包括的な README ファイル
• 最新の標準に準拠：各言語のベストプラクティスに従っています

---

さっそく始めましょう。 上から言語を選んで、サンプルをお試しください！ 🚀

BrowserAct にアクセスして、AI を活用したウェブスクレイピングプラットフォームについて詳しくご覧ください。