> ## Documentation Index
> Fetch the complete documentation index at: https://docs.browseract.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrate BrowserAct with Dify

> Install the BrowserAct plugin from a local package and run Bots or official templates in Dify workflows.

Run BrowserAct Bots and official templates from a Dify workflow, then pass their structured results to downstream nodes.

> **Marketplace review in progress:** The BrowserAct plugin is currently under review for the Dify Marketplace. Download the plugin package and install it using **Local Package File** for now.

## Before You Start

* Access to a Dify workspace where you can install plugins.
* A BrowserAct REST API key. An MCP Server key cannot be used for this integration.
* A published BrowserAct Bot, or an official template you want to run.
* The input values required by your Bot or template.

Create or manage your REST API key by following [API Keys](https://docs.browseract.com/integrations/api-keys.md?co-from=link-Docs).

## Step 1: Download and Install the Plugin

**1.** [Download the BrowserAct plugin package (.difypkg)](https://browseract-prod.browseract.com/prod/tools/browseract-1.0.0-view-properties-20261029.difypkg).

**2.** Open Dify and select **Integrations**.

**3.** Select **Install** > **Local Package File**.

![Select Install > Local Package File.](https://mintcdn.com/browseract/7xiaCWoiWdAsRRei/images/dify-install-local-package.png?fit=max\&auto=format\&n=7xiaCWoiWdAsRRei\&q=85\&s=9bc15ef7abb1558e94806712a3a8e679)

**4.** Select the downloaded `.difypkg` file.

**5.** Select **Install** in the confirmation dialog.

![Select Install in the confirmation dialog.](https://mintcdn.com/browseract/7xiaCWoiWdAsRRei/images/dify-confirm-install.png?fit=max\&auto=format\&n=7xiaCWoiWdAsRRei\&q=85\&s=da57e24b96f857b7bbe4edfe0458ded9)

**6.** Wait for installation to finish.

## Step 2: Create a Dify Workflow

**1.** Open **Studio**.

**2.** Select **Create from Blank**. If you already have apps, use **Create** > **Create from Blank**.

![Select Create from Blank. If you already have apps, use Create > Create from Blank.](https://mintcdn.com/browseract/7xiaCWoiWdAsRRei/images/dify-create-workflow.png?fit=max\&auto=format\&n=7xiaCWoiWdAsRRei\&q=85\&s=174b4deef1804b4d8f453ff709e0b456)

**3.** Select **Workflow** as the app type.

**4.** Enter an app name and an optional description.

**5.** Select **Create**.

![Select Create.](https://mintcdn.com/browseract/7xiaCWoiWdAsRRei/images/dify-select-workflow-type.png?fit=max\&auto=format\&n=7xiaCWoiWdAsRRei\&q=85\&s=f820e9cd0eb75364ded65ca494fde5a7)

## Step 3: Add and Authorize BrowserAct

**1.** Add a node and open **Tools**.

**2.** Find **BrowserAct**.

**3.** Choose **Run My Bot** for your published Bot, or **Run Official Template** for an official template.

![Choose Run My Bot for your published Bot, or Run Official Template for an official template.](https://mintcdn.com/browseract/7xiaCWoiWdAsRRei/images/dify-add-browseract-tool.png?fit=max\&auto=format\&n=7xiaCWoiWdAsRRei\&q=85\&s=e33ec3b63d4db2e7651e3bf5cea424ec)

**4.** Select **API Key Authorization Configuration**.

**5.** Enter your BrowserAct REST API key. Need a key? Follow [Get a BrowserAct API Key](https://docs.browseract.com/integrations/api-keys.md?co-from=link-Docs).

**6.** Select **Save**.

![Select Save.](https://mintcdn.com/browseract/7xiaCWoiWdAsRRei/images/dify-api-key-authorization.png?fit=max\&auto=format\&n=7xiaCWoiWdAsRRei\&q=85\&s=82915a5e1c5e489c2d90ee7c1552cc64)

## Step 4: Configure Inputs

**1.** Set **Operation** to **View Parameters**.

![Set Operation to View Parameters.](https://mintcdn.com/browseract/7xiaCWoiWdAsRRei/images/dify-select-operation.png?fit=max\&auto=format\&n=7xiaCWoiWdAsRRei\&q=85\&s=37b1e735174eb048f0752b729015a0df)

**2.** Select the Bot or template you want to use.

**3.** Select the play button on the node to inspect its inputs.

![Select the play button on the node to inspect its inputs.](https://mintcdn.com/browseract/7xiaCWoiWdAsRRei/images/dify-view-parameters.png?fit=max\&auto=format\&n=7xiaCWoiWdAsRRei\&q=85\&s=eb14384182224663e17849aeb57c2ed7)

**4.** Open **LAST RUN**.

**5.** Copy the complete **OUTPUT**.

![Copy the complete OUTPUT.](https://mintcdn.com/browseract/7xiaCWoiWdAsRRei/images/dify-last-run-output.png?fit=max\&auto=format\&n=7xiaCWoiWdAsRRei\&q=85\&s=dde546f581ab05a39a3a5c9f643e60da)

**6.** Return to **SETTINGS** and paste the output into **Custom Parameters JSON**.

![Return to SETTINGS and paste the output into Custom Parameters JSON.](https://mintcdn.com/browseract/7xiaCWoiWdAsRRei/images/dify-custom-parameters-json.png?fit=max\&auto=format\&n=7xiaCWoiWdAsRRei\&q=85\&s=442288b43e39058e5886d5172c167dc7)

**7.** Edit the inputs in `json[0]`. Supply all required values, including those without defaults.

**8.** Change **Operation** back to **Run Bot**.

Both tools default to **Run Bot**. **View Parameters** only inspects inputs; an empty `data` array is not a completed extraction result. You may also enter a parameter object directly. `{}` uses available defaults but does not fill missing required values.

## Step 5: Run and Use the Results

**1.** Start a test run of the complete Dify workflow.

**2.** Wait for the BrowserAct Task result.

**3.** Open **Logs** in your Dify app to review workflow records when available.

![Open Logs in your Dify app to review workflow records when available.](https://mintcdn.com/browseract/7xiaCWoiWdAsRRei/images/dify-workflow-logs.png?fit=max\&auto=format\&n=7xiaCWoiWdAsRRei\&q=85\&s=d53cf961bf4e0dbf83b366e76064f71b)

**4.** Map `task_id`, `status`, `output`, or `output_files` to downstream nodes as needed.

**Wait Timeout (seconds)** defaults to 600. A wait timeout does not cancel the BrowserAct Task. Check its status before retrying. Actual output fields and file formats depend on the response.

## FAQ

### Why can't I find BrowserAct in the Dify Marketplace?

The plugin is still under review. Use the package download and **Local Package File** installation steps above.

### Can I run both my Bots and official templates?

Yes. Select **Run My Bot** for a published Bot in your account, or **Run Official Template** for an official template.

### Why does authorization fail with my MCP key?

This plugin uses BrowserAct REST API authentication. Create a REST API key using [API Keys](https://docs.browseract.com/integrations/api-keys.md?co-from=link-Docs); MCP Server keys are managed separately.

### What if Dify stops displaying output while the Task is running?

Check Dify's run history and the Task status in BrowserAct before retrying. A disconnected live view or a wait timeout does not necessarily mean the BrowserAct Task stopped.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.