Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to BrowserAct

Scalekit connector
Open markdown

The BrowserAct connector lets your AI agent act in each user's BrowserAct account. Each user connects their own BrowserAct access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 12 tools.

Tools
12
What they doRead · write · destructive
8 · 3 · 18 read3 write1 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the BrowserAct connection

    In AgentKit > Connections, create a BrowserAct connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'browseract'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize BrowserAct:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'browseract_bots_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their BrowserAct credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • browseract_bot_getGet one BrowserAct Bot by ID, including its published input and output schemas.Read-only

    Get Bot

    Get one BrowserAct Bot by ID, including its published input and output schemas. Returns bot_id, bot_type, name, description, created_at, published_at, input_schema and output_schema (both null when unpublished). Use this before browseract_bot_run to build an input that matches input_schema. Use browseract_bots_list to find IDs.

    Inputs

    bot_idstringrequired
    Public Bot ID. Get it from browseract_bots_list. Example: bot_8f2c1a7e4d.
  • browseract_bots_listList the Bots in your BrowserAct account that have a runnable published version, with optional type and name filters.Read-only

    List Bots

    List the Bots in your BrowserAct account that have a runnable published version, with optional type and name filters. Returns items with bot_id, bot_type, name, description and published_at, plus page, limit, total_count and total_pages. Use this to find a bot_id. Use browseract_bot_get to see one Bot's input_schema before running it.

    Inputs

    bot_typestring
    Only return Bots of this type. Example: workflow.one of workflowagent
    keywordstring
    Case-insensitive search on the Bot name, up to 200 characters. Example: amazon.
    limitinteger
    Bots per page, 1 to 100. BrowserAct defaults to 20. Example: 20.
    pageinteger
    Page number to retrieve, starting at 1. BrowserAct defaults to 1. Example: 1.
  • browseract_regions_listList the proxy regions your BrowserAct API key can use for template runs.Read-only

    List Proxy Regions

    List the proxy regions your BrowserAct API key can use for template runs. Returns each region's code and name. Use this to pick proxy_region for browseract_template_run.

    Inputs

    This tool takes no inputs.

  • browseract_task_getGet the full details of one BrowserAct task, including its output.Read-only

    Get Task

    Get the full details of one BrowserAct task, including its output. Returns status, the accepted input, output, failure details, files, live browser information and step summaries when available. Use this to read results once a task has finished. Use browseract_task_status_get for lightweight polling.

    Inputs

    task_idstringrequired
    Task ID returned when the run was created, or from browseract_tasks_list. Example: 1990041234567890123.
  • browseract_task_status_getGet only the current status and last update time of one BrowserAct task.Read-only

    Get Task Status

    Get only the current status and last update time of one BrowserAct task. Returns the task status (created, running, pausing, paused, finished, canceled or failed) and its update time. Use this to poll a run started by browseract_bot_run or browseract_template_run. Use browseract_task_get for the output.

    Inputs

    task_idstringrequired
    Task ID returned when the run was created, or from browseract_tasks_list. Example: 1990041234567890123.
  • browseract_tasks_listList Bot runs (tasks) in your BrowserAct account, filtered by status, Bot or creation time, with pagination.Read-only

    List Tasks

    List Bot runs (tasks) in your BrowserAct account, filtered by status, Bot or creation time, with pagination. Returns items with task_id, status, bot_id, bot_name and timestamps, plus page, limit, total_count and total_pages. Use this to browse past runs. Use browseract_task_get for one task's output.

    Inputs

    bot_idstring
    Only return tasks created from this Bot ID. Example: bot_8f2c1a7e4d.
    bot_namestring
    Only return tasks whose Bot name contains this text. Example: amazon.
    created_at_fromstring
    Only tasks created at or after this time, ISO 8601. Example: 2026-01-01T00:00:00Z.
    created_at_tostring
    Only tasks created at or before this time, ISO 8601. Example: 2026-12-31T23:59:59Z.
    limitinteger
    Tasks per page, 1 to 100. BrowserAct defaults to 20. Example: 20.
    pageinteger
    Page number to retrieve, starting at 1. BrowserAct defaults to 1. Example: 1.
    statusstring
    Only return tasks with this status. Example: finished.one of createdrunningfinishedcanceledpausingpausedfailed
  • browseract_template_getGet one official BrowserAct Bot template by ID.Read-only

    Get Official Template

    Get one official BrowserAct Bot template by ID. Returns the template's ID, name, description and the input_schema a run must follow. Use this before browseract_template_run. Use browseract_templates_list to find IDs.

    Inputs

    template_idstringrequired
    Public official Bot template ID. Get it from browseract_templates_list. Example: tpl_3a9d2e61b0.
  • browseract_templates_listList the official Bot templates curated by BrowserAct, with an optional name search.Read-only

    List Official Templates

    List the official Bot templates curated by BrowserAct, with an optional name search. Returns items with each template's template_id, name and description, plus page, limit, total_count and total_pages. Use this to find a ready-made scraper. Use browseract_template_get for its input_schema.

    Inputs

    keywordstring
    Case-insensitive search on the template name, up to 200 characters. Example: google maps.
    limitinteger
    Templates per page, 1 to 500. BrowserAct defaults to 10. Example: 10.
    pageinteger
    Page number to retrieve, starting at 1. BrowserAct defaults to 1. Example: 1.