README.md

metadata

title: Browser Automation Tool
emoji: 🌐
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 4.21.0
app_file: app.py
pinned: false

Browser Automation Tool

A comprehensive browser automation platform that combines the power of Gradio for web UI and FastAPI for programmatic access. This tool enables seamless web scraping, browser automation, and integration with AI agents.

Features

• 🌐 Web Browser Automation: Control Chrome/Chromium browsers programmatically
• 📸 Screenshot Capture: Take screenshots of any webpage
• 🔍 Web Scraping: Extract data from HTML content
• 🤖 AI Agent Integration: Compatible with Model Context Protocol (MCP)
• ⚡ Real-time Streaming: Server-Sent Events (SSE) for live updates
• 🚀 RESTful API: FastAPI backend for programmatic access
• 📱 Web Interface: User-friendly Gradio UI

Quick Start

Using the Web Interface

1. Visit the Space URL above
2. Enter a URL to navigate
3. Use built-in tools for automation

Using the API

import requests

# Get available sessions
response = requests.get('https://your-space-url/api/sessions')
sessions = response.json()

# Create a new browser session
session_data = {
    'headless': True,
    'window_size': {'width': 1920, 'height': 1080}
}
response = requests.post('https://your-space-url/api/sessions', json=session_data)
session_id = response.json()['session_id']

# Navigate to a website
requests.post(f'https://your-space-url/api/sessions/{{session_id}}/navigate', 
              json={{'url': 'https://example.com'}})

# Take a screenshot
response = requests.get(f'https://your-space-url/api/sessions/{{session_id}}/screenshot')
with open('screenshot.png', 'wb') as f:
    f.write(response.content)

API Endpoints

Session Management

• GET /api/sessions - List all active sessions
• POST /api/sessions - Create new browser session
• DELETE /api/sessions/{{session_id}} - Close session

Browser Control

• POST /api/sessions/{{session_id}}/navigate - Navigate to URL
• GET /api/sessions/{{session_id}}/screenshot - Take screenshot
• POST /api/sessions/{{session_id}}/click - Click element
• POST /api/sessions/{{session_id}}/type - Type text
• GET /api/sessions/{{session_id}}/get_page_source - Get HTML

Author

MiniMax Agent - Advanced AI automation tools