nebutra/mineru-skill

mineru

An AI-Native skill for parsing PDF / Office / image files into Markdown with MinerU — a fast, zero-config document parser for AI agents.

First seen Feb 13, 2026

Installation

$ npx skills add nebutra/mineru-skill --skill mineru

Summary

  • 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.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 113
License LICENSE
Default branch main
Open issues 0
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version3.3.1
More metadata
author
Nebutra
version
3.3.1
argument-hint
<pdf-file-or-url>

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,024 B
  • docs SUMMARY.md 410 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 407 installs

SKILL.md

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