Hyperbrowser

Tool to add a new browser extension to Hyperbrowser for use in sessions. Use when you need to upload a Chrome extension zip file that can be loaded into browser sessions. The extension zip must contain a valid manifest.json file at the root level.

Creates a new persistent Hyperbrowser profile for storing browser state (cookies, sessions, etc.). Use this to create a reusable profile that can be attached to browser sessions via the profile ID. Profiles allow you to maintain logged-in states across multiple sessions without re-authenticating.

Tool to initiate a new scrape job. Use when you need to extract structured content from a target URL with custom session and scrape settings.

Tool to create a new browser session with custom stealth, proxy, and privacy settings. Use when initializing an automated browsing session with specific configuration.

Tool to delete a profile. Use when you need to remove a profile by its unique identifier after confirming its existence.

Tool to fetch a web page and return content in various formats (HTML, Markdown, JSON, screenshot, etc.). Use when you need to retrieve and process web content with customizable browser settings, output formats, and content filtering options.

DEPRECATED: Use HYPERBROWSER_GET_BROWSER_USE_TASK_STATUS instead. Tool to retrieve the status and results of a browser use task. Use after starting a browser use task to check its progress, retrieve execution steps, and obtain the final result.

Tool to retrieve the current status of a browser-use task. Use when checking if a browser automation task has completed or is still pending.

Tool to retrieve the complete result and status of a Claude Computer Use task. Use when you need full task details including execution steps, final results, and error information.

Poll the execution status of a Claude Computer Use task. Use after calling HYPERBROWSER_START_CLAUDE_COMPUTER_USE_TASK to check if the task has completed, is still running, or has failed. Pass the jobId returned from the start task action.

Tool to retrieve the status and results of a specific crawl job. Use after submitting a crawl job to check its progress or fetch results.

Tool to retrieve the current status of a specific crawl job. Use after initiating a crawl job to poll its status.

Tool to retrieve the status and results of a CUA (Claude User Agent) task. Use after starting a CUA task to check its progress, retrieve execution steps, and obtain the final result.

Poll the execution status of a CUA task. Use to check if a CUA task has completed, is still running, or has failed.

Tool to fetch the status and results of a specific extract job. Use after initiating an extract job to monitor progress and retrieve final data.

Retrieve the status of an extract job. Use after calling Start Extract Job to poll its progress. Poll periodically until status is 'completed' or 'failed', then use Get Extract Job Result to retrieve the extracted data.

Tool to retrieve the current status and results of a Gemini Computer Use task. Use when checking if a Gemini automation task has completed or is still pending.

Tool to retrieve the status and results of a HyperAgent task. Use when checking if a HyperAgent task has completed or to get the final results and execution steps.

Retrieves details of a specific Hyperbrowser profile by its UUID. Returns profile metadata including name, team association, and timestamps. Use the List Profiles action first to obtain valid profile IDs.

Retrieves the status and results of a scrape job. Poll this endpoint after creating a scrape job to check progress and get the scraped content when completed. Returns jobId, status (pending/running/completed/failed), scraped data, and any error message.

Tool to retrieve the current status of a specific scrape job. Use after initiating a scrape job to poll its status; poll at moderate intervals (e.g., every 2–5 seconds) rather than tight loops to avoid exhausting quota. Responses may be large when the job includes screenshots or full HTML.

Retrieve detailed information about a Hyperbrowser session by its ID. Use this tool to get connection endpoints (wsEndpoint, liveUrl), session status, and configuration details for an existing session. The session ID can be obtained from create_session or list_sessions actions. Returns active connection details (wsEndpoint, liveUrl, token) for active sessions, or historical information for closed sessions.

Tool to retrieve the downloads URL for a session. Returns a signed URL to download files saved during a browser session. Note: The session must be created with 'saveDownloads: true' for downloads to be available. Poll this endpoint checking status until 'completed'.

Retrieve the recording URL for a browser session. Returns a pre-signed S3 URL to download the rrweb JSON recording. The recording status indicates availability: - 'pending': Recording is being prepared - 'in_progress': Recording is still being processed - 'completed': Recording is ready, recordingUrl will contain the download link - 'failed': Recording failed, check the error field - 'not_enabled': Session was created without enableWebRecording=true Poll this endpoint until status is 'completed' or 'failed' after stopping a session.

Tool to retrieve the video recording URL for a browser session. Returns a pre-signed URL to download the video recording. The video recording status indicates availability: - 'pending': Video recording is being prepared - 'in_progress': Video recording is still being processed - 'completed': Video recording is ready, recordingUrl will contain the download link - 'failed': Video recording failed, check the error field - 'not_enabled': Session was created without enableVideoWebRecording=true Poll this endpoint until status is 'completed' or 'failed' after stopping a session.

Tool to retrieve the status and results of a web crawl job. Use after submitting a web crawl job to check its progress and fetch paginated results. Supports pagination via page and batchSize parameters for large crawl jobs.

Tool to retrieve just the status of a web crawl job without the full results. Use after initiating a web crawl to poll its current state.

Tool to list all browser extensions. Use when you need to fetch all available extensions for the Hyperbrowser account.

Tool to list profiles. Use when you need to fetch paginated profiles and optionally filter by name.

Tool to list sessions with optional status filter. Use when you need a paginated overview of browser sessions before acting on them.

Tool to perform a web search and retrieve results with titles, URLs, and descriptions. Use when you need to search the web for information on a specific topic or query.

Tool to start an asynchronous browser-use task. Use when you need to automate web interactions given a task instruction.

Tool to start a Claude Computer Use task. Use when you need AI-driven automated browser interactions. Call after you have your task prompt and any session preferences configured.

Tool to start a new crawl job for a specified URL. Use when you need to initiate a web crawl before checking job status.

Tool to start an OpenAI CUA (Computer-Using Agent) task. Use when you need AI-driven automated browser interactions powered by OpenAI. Call after you have your task prompt and any session preferences configured.

Start an AI-powered data extraction job from one or more web pages. Use this tool to scrape structured data from websites by providing URLs and either a natural language prompt describing what to extract, or a JSON schema defining the output structure (or both for best results). Returns a jobId to track extraction progress via HYPERBROWSER_GET_EXTRACT_JOB_STATUS and retrieve results via HYPERBROWSER_GET_EXTRACT_JOB_RESULT.

Tool to start a Gemini Computer Use task for browser automation using Google's Gemini. Use when you need AI-driven automated browser interactions with Gemini models.

Tool to start an asynchronous web crawl job that follows links from a starting URL and returns content from each page. Use when you need to crawl multiple pages from a website.

Tool to stop a running browser-use task. Use when halting an in-progress browser automation task after confirming its task ID.

Tool to stop a running Claude computer use task. Use when a Claude computer use task is in progress and needs to be terminated.

Tool to stop a running CUA task. Use when a CUA task is in progress and needs to be terminated.

Tool to stop a running Gemini computer use task. Use when a Gemini computer use task is in progress and needs to be terminated.

Tool to stop a running session by ID. Use after confirming the session is active.