# BrowserAct

```json
{
  "name": "BrowserAct",
  "slug": "browseract",
  "url": "https://composio.dev/toolkits/browseract",
  "markdown_url": "https://composio.dev/toolkits/browseract.md",
  "logo_url": "https://logos.composio.dev/api/browseract",
  "categories": [
    "workflow automation"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-08-20T15:35:24.106Z"
}
```

![BrowserAct logo](https://logos.composio.dev/api/browseract)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with BrowserAct MCP or direct API to discover workflows, run browser tasks, use templates, and select proxy regions through natural language.

## Summary

BrowserAct is a hosted browser-automation service for running web workflows.
Use it to execute repeatable browser tasks with templates, proxies, and APIs.

## Categories

- workflow automation

## Toolkit Details

- Tools: 11

## Images

- Logo: https://logos.composio.dev/api/browseract

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for BrowserAct.
  - Setup:
    - Configure Api Key credentials for BrowserAct.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Run pricing scraper in US region
- List available BrowserAct workflow templates
- Execute checkout test browser workflow

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `BROWSERACT_CANCEL_TASK` | Cancel Task | Immediately and permanently cancel a running BrowserAct task. The canceled run cannot be resumed or recovered. A task already in a terminal state is also treated as successfully canceled. |
| `BROWSERACT_GET_TASK` | Get Task | Return either a task's current status or its full progress, outputs, files, live-view details, and failure information. |
| `BROWSERACT_GET_WORKFLOW` | Get Workflow | Return a custom workflow's metadata and expected input parameter definitions before a run. |
| `BROWSERACT_GET_WORKFLOW_TEMPLATE` | Get Workflow Template | Return an official template's metadata and expected input parameter definitions before a run. |
| `BROWSERACT_LIST_PROXY_REGIONS` | List Proxy Regions | Return the supported proxy region names and codes for official template runs. |
| `BROWSERACT_LIST_TASKS` | List Tasks | Return one cursor-controlled page of workflow tasks, optionally filtered by status, workflow, name, or creation time. |
| `BROWSERACT_LIST_WORKFLOWS` | List Workflows | Return one cursor-controlled page of custom workflows in the connected workspace. |
| `BROWSERACT_LIST_WORKFLOW_TEMPLATES` | List Workflow Templates | Search official BrowserAct workflow templates and return one cursor-controlled page of summaries. |
| `BROWSERACT_RESUME_TASK` | Resume Task | Resume a paused task from its current state. Finished, failed, and canceled tasks cannot be resumed. BrowserAct also treats an already-running task as a successful request. |
| `BROWSERACT_RUN_WORKFLOW` | Run Workflow | Start a custom BrowserAct workflow. This consumes credits and executes its configured browser actions, which may irreversibly modify external websites. |
| `BROWSERACT_RUN_WORKFLOW_TEMPLATE` | Run Workflow Template | Start an official BrowserAct workflow template. This consumes credits and executes its browser actions, which may cause irreversible effects on external websites. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute BrowserAct Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute BrowserAct actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'List available BrowserAct workflow templates for web data extraction'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List available BrowserAct workflow templates for web data extraction'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK for Python or TypeScript
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Initialize Client and Create Tool Router Session

Import and initialize the Composio client, then create a Tool Router session for BrowserAct
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent (Anthropic Claude or Mastra)
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to BrowserAct tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('List available BrowserAct workflow templates for web data extraction')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'List available BrowserAct workflow templates for web data extraction'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native BrowserAct Integration

- Supports both BrowserAct MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable browser task execution
- Rich coverage for workflow discovery, task execution, templates, and proxy-region selection

### 2. Managed Auth

- Secure API key handling so you don't hard-code BrowserAct credentials in agent code
- Central place to manage, scope, and revoke BrowserAct access
- Per user and per environment credentials for safer browser automation at scale

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve BrowserAct workflow reliability over time
- Clear tool schemas help agents choose the right workflow, template, or proxy region
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access BrowserAct
- Scoped, least privilege access to BrowserAct workflows and task execution
- Full audit trail of agent-run browser actions to support review and compliance

## Use BrowserAct with any AI Agent Framework

Choose a framework you want to connect BrowserAct with:

None listed.

## Related Toolkits

- [0CodeKit](https://composio.dev/toolkits/0codekit) - 0CodeKit is a utility API platform for AI, document, image, and data workflows. Use it to convert, validate, generate, store, and automate data without custom backend code.
- [Airtop](https://composio.dev/toolkits/airtop) - Airtop is a cloud browser platform for AI-powered web automation. Use it to navigate sites, extract data, and run reusable browser workflows.
- [Apify MCP](https://composio.dev/toolkits/apify_mcp) - Apify MCP is the official MCP server for Apify's web scraping and browser automation platform. Use it to run actors, collect structured web data, and automate crawling workflows.
- [Apilio](https://composio.dev/toolkits/apilio) - Apilio is a home automation platform that lets you connect and control smart devices from different brands. It helps you build flexible automations with complex conditions, schedules, and integrations.
- [Basin](https://composio.dev/toolkits/basin) - Basin is a no-code form backend for quickly setting up reliable contact forms. It lets you collect and manage form submissions without writing any server-side code.
- [Bika.ai](https://composio.dev/toolkits/bika) - Bika.ai is an AI automation database platform for managing spaces, teams, records, automations, and outgoing webhooks. It helps teams organize structured data and automate database-driven workflows in one place.
- [Botster](https://composio.dev/toolkits/botster) - Botster is a web automation service for running configurable data collection bots. Use it to collect structured web data without building and maintaining scrapers yourself.
- [Bouncer](https://composio.dev/toolkits/bouncer) - Bouncer is an email validation platform that verifies the authenticity of email addresses in real-time and batch. It helps boost deliverability and reduce bounce rates for your communications.
- [Celigo](https://composio.dev/toolkits/celigo) - Celigo is an integration platform as a service for connecting apps, data, and business workflows. It helps teams automate cross-system processes without building every integration from scratch.
- [CheckFlow](https://composio.dev/toolkits/checkflow) - CheckFlow is a workflow and checklist platform for repeatable processes, tasks, templates, teams, data sets, and automation. Use it to standardize operations, track process execution, and keep teams aligned.
- [Conveyor](https://composio.dev/toolkits/conveyor) - Conveyor is a platform that automates security reviews with a Trust Center and AI-driven questionnaire automation. It streamlines compliance and vendor security processes for faster, hassle-free reviews.
- [Cronfree Time Scheduler](https://composio.dev/toolkits/cronfree_time_scheduler) - Cronfree Time Scheduler is an API-based scheduler for recurring webhook calls. Use it to create and remove timezone-aware schedules without running cron.
- [Crowdin](https://composio.dev/toolkits/crowdin) - Crowdin is a localization management platform that streamlines translation workflows and collaboration. It helps teams centralize multilingual content, boost productivity, and automate translation processes.
- [Databox](https://composio.dev/toolkits/databox) - Databox is a business analytics platform that connects your data from any tool and device. It helps you track KPIs, build dashboards, and discover actionable insights.
- [Detrack](https://composio.dev/toolkits/detrack) - Detrack is a delivery management platform for real-time tracking and proof of delivery. It helps businesses automate notifications and keep customers updated every step of the way.
- [Digital Humani](https://composio.dev/toolkits/digital_humani) - Digital Humani is a reforestation API for browsing planting projects, submitting tree requests, and tracking planted trees. It helps teams connect climate action directly to products, campaigns, and customer experiences.
- [Dnsfilter](https://composio.dev/toolkits/dnsfilter) - Dnsfilter is a cloud-based DNS security and content filtering solution. It helps organizations block online threats and manage safe internet access with ease.
- [EnforcedFlow](https://composio.dev/toolkits/enforcedflow) - EnforcedFlow is a work routing platform for advanced round-robin groups, agent criteria, availability, and email assignments. It helps teams distribute work fairly and quickly using configurable assignment rules.
- [Faraday](https://composio.dev/toolkits/faraday) - Faraday lets you embed AI in workflows across your stack for smarter automation. It boosts your favorite tools with actionable intelligence and seamless integration.
- [Feathery](https://composio.dev/toolkits/feathery) - Feathery is an AI-powered platform for building dynamic data intake forms with advanced logic. It helps teams automate complex workflows and collect structured data with ease.

## Frequently Asked Questions

### Do I need my own developer credentials to use BrowserAct with Composio?

Yes, BrowserAct requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)