Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Browse AI

Scalekit connector
Open markdown

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

Tools
23
What they doRead · write · destructive
12 · 9 · 212 read9 write2 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 Browse AI connection

    In AgentKit > Connections, create a Browse AI 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 = 'browseai'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Browse AI:', 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: 'browseai_robot_drafts_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Browse AI 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
  • browseai_bulk_run_getGet one bulk run with a page of the tasks it ran.Read-only

    Get Bulk Run

    Get one bulk run with a page of the tasks it ran. Returns the bulk run's id, title, status and counts, plus its tasks with status and captured data. Use this to follow a run started by browseai_bulk_run_create. Page through tasks with page.

    Inputs

    bulk_run_idstringrequired
    Unique bulk run ID returned by browseai_bulk_run_create or browseai_bulk_runs_list. Example: 3c7d9e1f-2a4b-4c5d-8e6f-7a8b9c0d1e2f.
    robot_idstringrequired
    Unique robot ID. Get it from browseai_robots_list or from the robot's URL on the Browse AI dashboard. Example: f2d0a9a4-6b4e-4c3f-9d1a-2b7c8e5f1a3d.
    pageinteger
    Page of the bulk run's tasks, starting at 1. Example: 1.
  • browseai_bulk_runs_listList the bulk runs of one robot, with pagination.Read-only

    List Bulk Runs

    List the bulk runs of one robot, with pagination. Returns bulk runs with their id, title, status, task counts and timestamps. Use this to find a bulk run id. Use browseai_bulk_run_get for its tasks.

    Inputs

    robot_idstringrequired
    Unique robot ID. Get it from browseai_robots_list or from the robot's URL on the Browse AI dashboard. Example: f2d0a9a4-6b4e-4c3f-9d1a-2b7c8e5f1a3d.
    pageinteger
    Page number, starting at 1. Example: 1.
  • browseai_monitor_getGet one monitor on a robot.Read-only

    Get Monitor

    Get one monitor on a robot. Returns the monitor's id, name, status, inputParameters, schedule and notification settings. Use this to inspect a monitor before updating it. Use browseai_monitors_list to find ids.

    Inputs

    monitor_idstringrequired
    Unique monitor ID. Get it from browseai_monitors_list. Example: a8c3e1f2-4d5b-4a6c-8e7f-9b0a1c2d3e4f.
    robot_idstringrequired
    Unique robot ID. Get it from browseai_robots_list or from the robot's URL on the Browse AI dashboard. Example: f2d0a9a4-6b4e-4c3f-9d1a-2b7c8e5f1a3d.
  • browseai_monitors_listList the monitors on one robot.Read-only

    List Monitors

    List the monitors on one robot. A monitor runs the robot on a schedule and reports changes. Returns each monitor's id, name, status, inputParameters, schedule and notification settings. Use this to find a monitor id. Use browseai_monitor_get for one monitor.

    Inputs

    robot_idstringrequired
    Unique robot ID. Get it from browseai_robots_list or from the robot's URL on the Browse AI dashboard. Example: f2d0a9a4-6b4e-4c3f-9d1a-2b7c8e5f1a3d.
  • browseai_robot_draft_getGet one robot draft with its status, schema and the data its finished preview extracted.Read-only

    Get Robot Draft

    Get one robot draft with its status, schema and the data its finished preview extracted. Returns the draft's status, schema, latestPreview (extracted data or why the preview failed) and timestamps. Poll this after browseai_robot_draft_create or browseai_robot_draft_update until the preview finishes.

    Inputs

    draft_idstringrequired
    Unique robot draft ID returned by browseai_robot_draft_create or browseai_robot_drafts_list. Example: 5b9e2c1d-7a3f-4e8b-a1c6-0d2f3e4a5b6c.
  • browseai_robot_drafts_listList the robot drafts in your workspace, newest first, including saved drafts.Read-only

    List Robot Drafts

    List the robot drafts in your workspace, newest first, including saved drafts. Returns drafts with their id, name, status, originUrl and schema, without latestPreview. Use this to find a draft id. Use browseai_robot_draft_get for a draft's preview data.

    Inputs

    pageinteger
    Page number, starting at 1. Example: 1.
    page_sizeinteger
    Drafts per page. Browse AI defaults to 10. Example: 10.
  • browseai_robot_getGet one Browse AI robot by id.Read-only

    Get Robot

    Get one Browse AI robot by id. Returns the robot's id, name, createdAt and inputParameters with their names, types and defaults. Use this to see which input_parameters a robot accepts before running it. Use browseai_robots_list to find ids.

    Inputs

    robot_idstringrequired
    Unique robot ID. Get it from browseai_robots_list or from the robot's URL on the Browse AI dashboard. Example: f2d0a9a4-6b4e-4c3f-9d1a-2b7c8e5f1a3d.
  • browseai_robots_listList the robots in your Browse AI account.Read-only

    List Robots

    List the robots in your Browse AI account. Returns each robot's id, name, createdAt and inputParameters (the inputs it accepts). Use this to find a robot id. Use browseai_robot_get for one robot's details.

    Inputs

    This tool takes no inputs.