Dify

Use TinyFish Web Agent as a tool in Dify AI workflows and agents

Overview

The TinyFish Web Agent plugin for Dify lets you add AI-powered web automation to any Dify workflow or agent. Navigate websites, extract structured data, fill forms, and complete multi-step browser tasks — all using natural language.

Setup

1. Install the plugin

   On the Dify platform, go to the Plugin Marketplace and install the TinyFish Web Agent tool.

2. Get your API key

   Visit the TinyFish Dashboard and generate an API key.

3. Authorize the plugin

   In Dify, go to Plugins > TinyFish Web Agent > To Authorize and enter your API key.

Available Tools

Tool	Description
Run Synchronously	Execute browser automation and wait for the result in a single response.
Run Asynchronously	Start browser automation and return a run_id immediately. Use with Get Run to poll for results.
Run with SSE Streaming	Execute browser automation with real-time progress updates via Server-Sent Events.
List Runs	List previous automation runs, with optional status filtering and pagination.
Get Run	Get detailed information about a specific automation run by its ID.

Using in Workflows

1. Add TinyFish Web Agent’s Run Asynchronously tool to your pipeline.
2. Configure input variables (URL and goal) in the tool’s UI.
3. Run the pipeline to extract data from any web page.

Using with Agents

1. Add all TinyFish Web Agent tools to your Agent app.
2. Prompt the Agent to perform web automations using natural language. The Agent will choose the appropriate tool automatically.

Example prompts:

• "Extract the blog post titles and authors from https://example.com/blog"
• "Go to https://example.com/pricing and extract all plan names and prices"
• "List my recent automation runs that have completed"

API Tool Config (Manual Setup)

If you need to configure TinyFish as a custom API tool in Dify instead of using the plugin, use this endpoint and auth pattern:

{
  "url": "https://agent.tinyfish.ai/v1/automation/run",
  "method": "POST",
  "headers": {
    "X-API-Key": "<your_tinyfish_api_key>"
  },
  "body": {
    "url": "{url}",
    "goal": "{goal}"
  }
}

In Dify’s custom tool configuration, set the authentication type to API Key with the header name X-API-Key.

Resources

• Dify Plugin Marketplace
• TinyFish Web Agent API Docs
• GitHub: tinyfish-web-agent-integrations