mineru-pdf-extractor

name	mineru-pdf-extractor
description	Extract PDF content to Markdown using MinerU API. Supports formulas, tables, OCR. Provides both local file and online URL parsing methods.
author	Community
version	1.0.0
homepage	https://mineru.net/
source	https://github.com/opendatalab/MinerU
env	[{"name":"MINERU_TOKEN","description":"MinerU API token for authentication (primary)","required":true},{"name":"MINERU_API_KEY","description":"Alternative API token if MINERU_TOKEN is not set","required":false},{"name":"MINERU_BASE_URL","description":"API base URL (optional, defaults to https://mineru.net/api/v4)","required":false,"default":"https://mineru.net/api/v4"}]
tools	{"required":[{"name":"curl","description":"HTTP client for API requests and file downloads"},{"name":"unzip","description":"Archive extraction tool for result ZIP files"}],"optional":[{"name":"jq","description":"JSON processor for enhanced parsing and security (recommended)"}]}

MinerU PDF Extractor

Extract PDF documents to structured Markdown using the MinerU API. Supports formula recognition, table extraction, and OCR.

Note: This is a community skill, not an official MinerU product. You need to obtain your own API key from MinerU.

---

📁 Skill Structure

mineru-pdf-extractor/
├── SKILL.md                          # English documentation
├── SKILL_zh.md                       # Chinese documentation
├── docs/                             # Documentation
│   ├── Local_File_Parsing_Guide.md   # Local PDF parsing detailed guide (English)
│   ├── Online_URL_Parsing_Guide.md   # Online PDF parsing detailed guide (English)
│   ├── MinerU_本地文档解析完整流程.md  # Local parsing complete guide (Chinese)
│   └── MinerU_在线文档解析完整流程.md  # Online parsing complete guide (Chinese)
└── scripts/                          # Executable scripts
    ├── local_file_step1_apply_upload_url.sh    # Local parsing Step 1
    ├── local_file_step2_upload_file.sh         # Local parsing Step 2
    ├── local_file_step3_poll_result.sh         # Local parsing Step 3
    ├── local_file_step4_download.sh            # Local parsing Step 4
    ├── online_file_step1_submit_task.sh        # Online parsing Step 1
    └── online_file_step2_poll_result.sh        # Online parsing Step 2

---

🔧 Requirements

Required Environment Variables

Scripts automatically read MinerU Token from environment variables (choose one):

# Option 1: Set MINERU_TOKEN
export MINERU_TOKEN="your_api_token_here"

# Option 2: Set MINERU_API_KEY
export MINERU_API_KEY="your_api_token_here"

Required Command-Line Tools

• curl - For HTTP requests (usually pre-installed)
• unzip - For extracting results (usually pre-installed)

Optional Tools

• jq - For enhanced JSON parsing and security (recommended but not required)
  • If not installed, scripts will use fallback methods
  • Install: apt-get install jq (Debian/Ubuntu) or brew install jq (macOS)

Optional Configuration

# Set API base URL (default is pre-configured)
export MINERU_BASE_URL=