Mineru

What it does

When your agent uses it

• Converting PDF/Word/PPT/Excel/image documents
• Extracting text/tables/formulas
• Batch processing

Example prompts

• “/mineru”

Requirements

• Python 3
• A credential in MINERU_TOKEN

What it can do on your machine

Read from SKILL.md and the folder at commit 02433d8. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 14 files in scripts/ (Python, from the files we listed), which the agent can run.

  Shell commands in SKILL.md call:

  • python3

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • mineru.net

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • MINERU_TOKEN

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mineru loads about 504 tokens when it runs, and up to ~8.7k if it reads all its reference files. Until then it costs about 101 tokens; SKILL.md has 111 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~101

When it runs · the whole SKILL.md, loaded when a task matches

~504

With references · SKILL.md plus every file in references/, read only if the agent opens them

~8.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Nebutra/MinerU-Skill at commit 02433d8, republished under its MIT licence (© Nebutra). 111 words, ~504 tokens.

name

mineru

description

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.

metadata.author

Nebutra

metadata.version

3.3.1

metadata.argument-hint

<pdf-file-or-url>

# 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

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

© Nebutra, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 29 other files (scripts, references) in skills/mineru of Nebutra/MinerU-Skill.

• SKILL.md
• references/api_reference.md
• references/comparison.md
• references/integrations.md
• scripts/__init__.py
• scripts/chunking.py
• scripts/local_engine.py
• scripts/mineru.py
• scripts/mineru_mcp.py
• scripts/sinks/__init__.py
• scripts/sinks/_http.py
• scripts/sinks/_md.py
• scripts/sinks/airtable.py
• scripts/sinks/base.py
• scripts/sinks/coda.py
• scripts/sinks/confluence.py
• scripts/sinks/dingtalk.py
• scripts/sinks/feishu.py
• … and 12 more

Open the folder on GitHubat commit 02433d8