How do I install the Mineru skill?

Run npx skillmds@latest add nebutra/mineru-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Mineru safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Mineru?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Mineru free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Mineru?

nebutra (@nebutra) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Mineru by nebutra — Agent Skill

Name: Mineru
Rating: 4.2 (5 reviews)
Author: nebutra

Mineru

An AI-Native skill for parsing PDF / Office / image files into Markdown with MinerU — a fast, zero-config document parser for AI agents. Works with NO token via the Agent API and auto-upgrades to the Standard API (token) for large files, batches, and DOCX/HTML/LaTeX export. Use when converting PDF/Word/PPT/Excel/image documents, extracting text/tables/formulas, running OCR, or batch processing.

nebutra Updated Sep 22, 2026

File contents

MinerU PDF Parser

Parse PDF, Office, and image documents into structured Markdown via the MinerU API.

Quick Start

# Zero-config: no token, no install (free Agent API)
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/mineru.py" ./document.pdf --output ./output/

# Pipe Markdown back to an agent
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/mineru.py" ./document.pdf --stdout

# Power mode: token unlocks large files / batch / extra formats
export MINERU_TOKEN="..."   # https://mineru.net/apiManage/token
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/mineru.py" ./pdfs/ --output ./output/ --workers 8 --resume

Features

Auto-routing: free Agent API by default, auto-upgrades to the Standard API (token) for large/batch/extra-format jobs
Multi-modal: PDF, images, Word, PPT, Excel, HTML
High-performance OCR: --ocr with language selection (--lang)
Formula & table recognition: LaTeX formulas, structured tables
Multi-format export: Markdown (default), plus DOCX / HTML / LaTeX
AI-Native output: --stdout (Markdown) and --json (machine status)
Batch + resume: parallel workers with --resume
Zero dependencies: standard library only

Authentication

A token is optional — the Agent API works without one. Set a token to unlock the Standard API (≤ 200 MB / ≤ 200 pages, batch, DOCX/HTML/LaTeX):

export MINERU_TOKEN="your-token-here"   # https://mineru.net/apiManage/token

Official API docs: https://mineru.net/apiManage/docs

Frequently asked questions