Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Hyperbrowser

Scalekit connector
Open markdown

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

Tools
60
What they doRead · write · destructive
35 · 16 · 935 read16 write9 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 Hyperbrowser connection

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

    Each user opens the link once and enters their Hyperbrowser 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
  • hyperbrowser_browser_use_task_getGet a Browser Use task's status, steps and final result.Read-only

    Get Browser Use Task

    Get a Browser Use task's status, steps and final result. Returns the task object. Poll until the status is completed or failed.

    Inputs

    task_idstringrequired
    ID of the task. Example: 8f2c1a7e-4b3d-4e8a-9c21-5d6f7a8b9c0d.
  • hyperbrowser_browser_use_task_status_getGet only the status of a Browser Use task.Read-only

    Get Browser Use Task Status

    Get only the status of a Browser Use task. Returns the status. Use hyperbrowser_browser_use_task_get for the result.

    Inputs

    task_idstringrequired
    ID of the task. Example: 8f2c1a7e-4b3d-4e8a-9c21-5d6f7a8b9c0d.
  • hyperbrowser_claude_computer_use_task_getGet a Claude Computer Use task's status, steps and final result.Read-only

    Get Claude Computer Use Task

    Get a Claude Computer Use task's status, steps and final result. Returns the task object. Poll until the status is completed or failed.

    Inputs

    task_idstringrequired
    ID of the task. Example: 8f2c1a7e-4b3d-4e8a-9c21-5d6f7a8b9c0d.
  • hyperbrowser_claude_computer_use_task_status_getGet only the status of a Claude Computer Use task.Read-only

    Get Claude Computer Use Task Status

    Get only the status of a Claude Computer Use task. Returns the status. Use hyperbrowser_claude_computer_use_task_get for the result.

    Inputs

    task_idstringrequired
    ID of the task. Example: 8f2c1a7e-4b3d-4e8a-9c21-5d6f7a8b9c0d.
  • hyperbrowser_crawl_getGet a crawl job's status and crawled pages, a page of results at a time.Read-only

    Get Crawl Job

    Get a crawl job's status and crawled pages, a page of results at a time. Returns the job with page results. Poll until the status is completed or failed.

    Inputs

    crawl_job_idstringrequired
    ID of the crawl job. Example: 8f2c1a7e-4b3d-4e8a-9c21-5d6f7a8b9c0d.
    batch_sizeinteger
    Number of page results per response page. Example: 20.
    pageinteger
    Page number of results, starting at 1. Example: 1.
  • hyperbrowser_crawl_status_getGet only the status of a crawl job.Read-only

    Get Crawl Job Status

    Get only the status of a crawl job. Returns the status. Use hyperbrowser_crawl_get for the pages.

    Inputs

    crawl_job_idstringrequired
    ID of the crawl job. Example: 8f2c1a7e-4b3d-4e8a-9c21-5d6f7a8b9c0d.
  • hyperbrowser_extensions_listList the Chrome extensions uploaded to the account.Read-only

    List Extensions

    List the Chrome extensions uploaded to the account. Returns extension IDs and names. Pass IDs as extension_ids to hyperbrowser_session_create; extensions are uploaded in the dashboard.

    Inputs

    This tool takes no inputs.

  • hyperbrowser_extract_getGet an extract job's status and, once completed, the extracted data.Read-only

    Get Extract Job

    Get an extract job's status and, once completed, the extracted data. Returns the job object. Poll until the status is completed or failed.

    Inputs

    extract_job_idstringrequired
    ID of the extract job. Example: 8f2c1a7e-4b3d-4e8a-9c21-5d6f7a8b9c0d.