Ultra-Detailed Dify Plugin Configuration Guide & Workflow Building Case

Recently, the MinerU plugin jointly developed by MinerU and Dify has been launched on the Dify Marketplace! This tutorial will provide detailed instructions on configuring the MinerU plugin and building workflows.

MinerU Dify Plugin Homepage:
https://marketplace.dify.ai/plugins/langgenius/mineru

Usage Scenarios Overview

1. Using MinerU Official Online API Service
2. Configuring MinerU Local Service

---

Scenario 1: Configuring MinerU Official Online API Service

Configuration Steps

1. Log in to the Dify platform
2. Go to 【Tools】 → 【Plugin Marketplace】, search and add the MinerU plugin
3. Apply for MinerU API:
   • Visit MinerU API Management Page (proxy must be disabled)
   • Obtain approved API token
4. Fill in plugin parameters:

   # MinerU Service Base URL
   https://mineru.net
   # Token
   [Your API token]
   # Service Type
   MinerU Official API

5. Save configuration

---

Scenario 2: Configuring MinerU Local Service

Prerequisites

• Locally deployed MinerU
• Deployed web_api project

Configuration Steps

1. Obtain local IP:
   • Windows: ipconfig → Find "IPv4 Address"
   • macOS:

     # Wireless network:
     ipconfig getifaddr en0
     # Wired network:
     ipconfig getifaddr en1

   • Linux: hostname -I or ip addr
2. Fill in plugin parameters:

   # MinerU Service Base URL
   http://[Your IP]:8888  # Note: use http
   # Token
   (Leave blank)
   # Service Type
   Local Deployment

3. Save configuration

---

Common Issues and Solutions

Error: Request URL is missing protocol

Solution:

1. Modify Dify's .env file:
   • Docker Compose deployment: FILES_URL=http://api:5001
   • Other deployments: FILES_URL=http://[Host Machine IP]:5001
2. Confirm port 5001 is exposed
3. Restart Dify service

💡 Note:

• Update IP configuration when network environment changes
• This step is mandatory for proper file upload processing

---

Practical Case: Building a File Q&A Workflow

1. Environment Preparation

• Complete MinerU plugin installation
• Configure model provider API keys

2. Create Workflow

graph TD
    A[Start Node] --> B[MinerU Plugin Node]
    B --> C[LLM Node]
    C --> D[End Node]

Detailed Steps

1. Create Blank Workflow App

   • Select 【Workflow】 type
   • Set app name/icon

2. Configure 【Start】 Node

   • Add input fields:
     • uploadfile (file upload)
     • question (user query)

3. Add MinerU Plugin Node

   • Bind uploadfile as input

4. Configure LLM Node

   • Context: Reference MinerU's Parse File output
   • System Prompt:
     Parse File contains the parsed content of user-uploaded files
   • User Prompt: Reference question field

5. Set 【End】 Node

   • Output LLM node's text field

6. Test & Publish

   • Click 【Run】 to test functionality
   • Publish app after verification

---

Resource Acquisition

• GitHub Repository: dify-official-plugins/MinerU (Welcome Stars and PRs!)

🚀 Coming Soon: MinerU Plugin Integration with Dify Knowledge Base!