Sunwood-AI-OSS-Hub Browser API
Cinderella Browser API は Playwright によるブラウザ自動化 API。
API Base URL
http://browser-api:8000
Note: Docker ネットワーク内からはサービス名 browser-api でアクセス。ポートはコンテナ内の 8000。
Endpoints
GET /health - ブラウザ状態確認
curl http://browser-api:8000/health
POST /open - URL を開く
curl -X POST http://browser-api:8000/open \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com", "wait_until": "domcontentloaded"}'
GET /snapshot - ページ上の要素一覧取得
curl http://browser-api:8000/snapshot
POST /click - 要素クリック
curl -X POST http://browser-api:8000/click \
-H "Content-Type: application/json" \
-d '{"selector": "#submit-button"}'
POST /fill - 入力フィールドに入力
curl -X POST http://browser-api:8000/fill \
-H "Content-Type: application/json" \
-d '{"selector": "#search", "value": "検索ワード"}'
GET /text - 要素のテキスト取得
curl "http://browser-api:8000/text?selector=%23content"
POST /screenshot - スクリーンショット撮影
curl -X POST http://browser-api:8000/screenshot \
-H "Content-Type: application/json" \
-d '{"path": "/app/screenshots/screenshot.png"}'
POST /close - ブラウザを閉じる
curl -X POST http://browser-api:8000/close
Typical Workflow
GET /health- ブラウザが起動しているか確認POST /open- ページを開くGET /snapshot- 操作したい要素のセレクタを確認POST /fill+POST /click- 操作を実行POST /screenshot- 結果をスクリーンショットで保存
VNC Access
ブラウザ操作の様子をリアルタイムで確認できる：
- VNC:
localhost:5900 - noVNC: http://localhost:7900