How do I install the Mineru skill?

Run npx skillmds@latest add tomevault-io/mineru 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. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. 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?

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

Mineru by tomevault-io — Agent Skill

Name: Mineru
Author: tomevault-io

Mineru

Use when working with 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.

tomevault-io Updated Sep 17, 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

Source: Nebutra/MinerU-Skill — distributed by TomeVault.

---name: minerudescription: Use when working with 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.---# MinerU PDF ParserParse PDF, Office, and image documents into structured Markdown via the MinerU API.## Quick Start```bash# 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 agentpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/mineru.py" ./document.pdf --stdout# Power mode: token unlocks large files / batch / extra formatsexport MINERU_TOKEN="..." # https://mineru.net/apiManage/tokenpython3 "${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## AuthenticationA token is **optional** — the Agent API works without one. Set a token to unlockthe Standard API (≤ 200 MB / ≤ 200 pages, batch, DOCX/HTML/LaTeX):```bashexport MINERU_TOKEN="your-token-here" # https://mineru.net/apiManage/token```Official API docs: https://mineru.net/apiManage/docs---> Source: [Nebutra/MinerU-Skill](https://github.com/Nebutra/MinerU-Skill) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions