Agent skill

Mineru

by LeoYeAI in LeoYeAI/openclaw-master-skills

MinerU document extraction CLI that converts PDFs, images, and web pages into Markdown, HTML, LaTeX, or DOCX via the MinerU API.

MITAuto-check passedDocuments & Office

Install Mineru

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill mineru -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills mineru --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mineru-ai .claude/skills/mineru && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "mineru" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/mineru-ai into .claude/skills/mineru/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mineru", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/mineru-ai

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill mineru -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills mineru --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/mineru-ai .agents/skills/mineru && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "mineru" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/mineru-ai into .agents/skills/mineru/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mineru", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill mineru -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills mineru --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/mineru-ai .cursor/skills/mineru && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "mineru" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/mineru-ai into .cursor/skills/mineru/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mineru", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/LeoYeAI/openclaw-master-skills.git --path skills/mineru-ai

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill mineru -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills mineru --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/mineru-ai .gemini/skills/mineru && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "mineru" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/mineru-ai into .gemini/skills/mineru/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mineru", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills mineru

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill mineru -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/mineru-ai .github/skills/mineru && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "mineru" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/mineru-ai into .github/skills/mineru/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mineru", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill mineru -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills mineru --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/mineru-ai .opencode/skills/mineru && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "mineru" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/mineru-ai into .opencode/skills/mineru/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mineru", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: mineru
GitHub stars: 2.2k
Token cost: ~4.4k tokens
SKILL.md length: 1,727 words
Files: 3
Skills in repo: 1,235
Repo updated: Jul 20, 2026
First seen: Oct 9, 2026
Licence: MIT

At a glance

MinerU document extraction CLI that converts PDFs, images, and web pages into Markdown, HTML, LaTeX, or DOCX via the MinerU API.

Works in 4 steps: Start fast (no token): mineru-open-api… → Need more? Create token at… → Web pages: mineru-open-api crawl to… → …
Tasks that involve Word documents
SKILL.md covers Installation, Two extraction modes, Core workflow and Authentication, plus 8 more sections
Calls npm and go; reaches arxiv.org; needs MINERU_TOKEN

What it does

Mineru is an agent skill from LeoYeAI/openclaw-master-skills. MinerU document extraction CLI that converts PDFs, images, and web pages into Markdown, HTML, LaTeX, or DOCX via the MinerU API. Supports token-free flash extraction for quick start, precision extraction with table/formula recognition, web crawling, batch processing, and piped workflows.

Its SKILL.md is about 4.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `CONTRIBUTING.md` and `_meta.json`).

It sits in Documents & Office, covering Word documents, LaTeX and Data pipelines and ETL. It works with Microsoft Word, LaTeX and Microsoft PowerPoint. The repository describes itself as: 🧠 Curated collection of 1209+ best OpenClaw skills — weekly updated by MyClaw.ai. The licence is MIT.

When your agent uses it

Tasks that involve Word documents
Tasks that involve LaTeX
Tasks that involve Data pipelines and ETL

Example prompts

“/mineru”

Requirements

Node.js
A credential in MINERU_TOKEN
Pre-approved tools (allowed-tools): Bash(mineru-open-api:*)

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

Start fast (no token): mineru-open-api flash-extract for quick Markdown conversion
Need more? Create token at https://mineru.net/apiManage/token, run mineru-open-api auth, then use mineru-open-api extract for tables…
Web pages: mineru-open-api crawl to convert web content
Check results: output goes to stdout (default) or -o directory

What it can do on your machine

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

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Bash(mineru-open-api:*)
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- npm
- go
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:
- arxiv.org
Also links to:
- mineru.net
- github.com
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 4.4k tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 1,727 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~74
When it runs · the whole SKILL.md, loaded when a task matches: ~4.4k

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

Auto-check passed

The automated check found no risky patterns in SKILL.md.

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from LeoYeAI/openclaw-master-skills at commit e5199b5, republished under its MIT licence (© LeoYeAI). 1,727 words, ~4,445 tokens.

Download SKILL.mdSave it as .claude/skills/mineru/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.

name: mineru
description: MinerU document extraction CLI that converts PDFs, images, and web pages into Markdown, HTML, LaTeX, or DOCX via the MinerU API. Supports token-free flash extraction for quick start, precision extraction with table/formula recognition, web crawling, batch processing, and piped workflows.
allowed-tools: Bash(mineru-open-api:*)
read_when: Extracting text from PDF documents, Converting documents to Markdown, Crawling web pages to Markdown, Batch document processing, OCR on scanned documents…

Document Extraction with mineru-open-api

Installation

bash

npm install -g mineru-open-api

Or via Go (macOS/Linux):

bash

go install github.com/opendatalab/MinerU-Ecosystem/cli/mineru-open-api@latest

Verify installation

bash

mineru-open-api version

Two extraction modes

	`flash-extract`	`extract`
Token required	No	Yes (`mineru-open-api auth`)
Speed	Fast	Normal
Table recognition	No	Yes
Formula recognition	No	Yes
OCR	Yes	Yes
Output formats	Markdown only	md, html, latex, docx, json
Batch mode	No	Yes
Model selection	pipeline	Yes (vlm, pipeline, MinerU-HTML)
File size limit	10 MB	Much higher
Page limit	20 pages	Much higher
Rate limit	Per-IP per-minute cap	Based on API plan
Best for	Quick start, small/simple docs	Large docs, tables, production

flash-extract limits

Limit	Value
File size	Max 10 MB
Page count	Max 20 pages
Supported types	PDF, Images (png/jpg/jpeg/jp2/webp/gif/bmp), Docx, PPTx
IP rate limit	Per-minute request caps (HTTP 429 when exceeded)

When any limit is exceeded, the agent should suggest switching to extract with a token (create at https://mineru.net/apiManage/token), which has significantly higher limits.

Core workflow

Start fast (no token): mineru-open-api flash-extract <file> for quick Markdown conversion
Need more? Create token at https://mineru.net/apiManage/token, run mineru-open-api auth, then use mineru-open-api extract for tables, formulas, OCR, multi-format, and batch
Web pages: mineru-open-api crawl <url> to convert web content
Check results: output goes to stdout (default) or -o directory

Authentication

Only required for extract and crawl. Not needed for flash-extract.

Configure your API token (create one at https://mineru.net/apiManage/token):

bash

mineru-open-api auth                    # Interactive token setup
export MINERU_TOKEN="your-token"  # Or set via environment variable

Token resolution order: --token flag > MINERU_TOKEN env > ~/.mineru/config.yaml.

Supported input formats

Format	`flash-extract`	`extract`
PDF (`.pdf`)	Yes	Yes
Images (`.png`, `.jpg`, `.jpeg`, `.jp2`, `.webp`, `.gif`, `.bmp`)	Yes	Yes
Word (`.docx`)	Yes	Yes
Word (`.doc`)	No	Yes
PowerPoint (`.pptx`)	Yes	Yes
PowerPoint (`.ppt`)	No	Yes
HTML (`.html`)	No	Yes
URLs (remote files)	Yes	Yes

The crawl command accepts any HTTP/HTTPS URL and extracts web page content.

Commands

flash-extract — Quick extraction (no token needed)

Fast, token-free document extraction. Outputs Markdown only. No table recognition. Limited to 10 MB / 20 pages per file, with IP-based rate limiting.

bash

mineru-open-api flash-extract report.pdf                     # Markdown to stdout
mineru-open-api flash-extract report.pdf -o ./out/           # Save to file
mineru-open-api flash-extract https://example.com/doc.pdf    # URL mode
mineru-open-api flash-extract report.pdf --language en       # Specify language
mineru-open-api flash-extract report.pdf --pages 1-10        # Page range

flash-extract flags

Flag	Short	Default	Description
`--output`	`-o`	(stdout)	Output path (file or directory)
`--language`		`ch`	Document language
`--pages`		(all)	Page range, e.g. `1-10`
`--timeout`		`900`	Timeout in seconds

extract — Precision extraction (token required)

Convert PDFs, images, and other documents to Markdown or other formats. Supports table/formula recognition, OCR, multiple output formats, and batch mode.

bash

mineru-open-api extract report.pdf                         # Markdown to stdout
mineru-open-api extract report.pdf -f html                 # HTML to stdout
mineru-open-api extract report.pdf -o ./out/               # Save to directory
mineru-open-api extract report.pdf -o ./out/ -f md,docx    # Multiple formats
mineru-open-api extract *.pdf -o ./results/                # Batch extract
mineru-open-api extract --list files.txt -o ./results/     # Batch from file list
mineru-open-api extract https://example.com/doc.pdf        # Extract from URL
cat doc.pdf | mineru-open-api extract --stdin -o ./out/    # From stdin

extract flags

Flag	Short	Default	Description
`--output`	`-o`	(stdout)	Output path (file or directory)
`--format`	`-f`	`md`	Output formats: `md`, `json`, `html`, `latex`, `docx` (comma-separated)
`--model`		(auto)	Model: `vlm`, `pipeline`, `html` (see below)
`--ocr`		`false`	Enable OCR for scanned documents
`--formula`		`true`	Enable/disable formula recognition
`--table`		`true`	Enable/disable table recognition
`--language`		`ch`	Document language
`--pages`		(all)	Page range, e.g. `1-10,15`
`--timeout`		`900`/`1800`	Timeout in seconds (single/batch)
`--list`			Read input list from file (one path per line)

Model comparison: vlm vs pipeline

	`vlm`	`pipeline`
Parsing accuracy	Higher — better at complex layouts, mixed content	Standard
Hallucination risk	May produce hallucinated text in rare cases	No hallucination — biggest advantage
Best for	Academic papers, complex tables, intricate layouts	General documents where fidelity matters most

When the user values accuracy and the document has complex formatting, suggest --model vlm. When the user prioritizes reliability and no-hallucination guarantee, suggest --model pipeline (or omit --model to use auto).

crawl — Web page extraction (token required)

Fetch web pages and convert to Markdown.

bash

mineru-open-api crawl https://example.com/article              # Markdown to stdout
mineru-open-api crawl https://example.com/article -f html      # HTML to stdout
mineru-open-api crawl https://example.com/article -o ./out/     # Save to file
mineru-open-api crawl url1 url2 -o ./pages/                     # Batch crawl
mineru-open-api crawl --list urls.txt -o ./pages/               # Batch from file list

crawl flags

Flag	Short	Default	Description
`--output`	`-o`	(stdout)	Output path
`--format`	`-f`	`md`	Output formats: `md`, `json`, `html` (comma-separated)
`--timeout`		`900`/`1800`	Timeout in seconds (single/batch)
`--list`			Read URL list from file (one per line)
`--stdin-list`		`false`	Read URL list from stdin
`--concurrency`		`0`	Batch concurrency

auth — Authentication management

bash

mineru-open-api auth              # Interactive token setup
mineru-open-api auth --verify     # Verify current token is valid
mineru-open-api auth --show       # Show current token source and masked value

Supported `--language` values

The --language flag accepts the following values (default: ch). Used by both flash-extract and extract. Values are organized by script/language family — each value covers all languages listed in its group.

Standalone language packs

For specific languages or CJK combinations.

Value	Included languages	说明
`ch`	Chinese, English, Chinese Traditional	中英文（默认值）
`ch_server`	Chinese, English, Chinese Traditional, Japanese	繁体、手写体
`en`	English	纯英文
`japan`	Chinese, English, Chinese Traditional, Japanese	日文为主
`korean`	Korean, English	韩文
`chinese_cht`	Chinese, English, Chinese Traditional, Japanese	繁体中文为主
`ta`	Tamil, English	泰米尔文
`te`	Telugu, English	泰卢固文
`ka`	Kannada	卡纳达文
`el`	Greek, English	希腊文
`th`	Thai, English	泰文

Language family packs

One value covers many languages sharing the same script system.

Value	Script/Family	Included languages
`latin`	Latin script (拉丁语系)	French, German, Afrikaans, Italian, Spanish, Bosnian, Portuguese, Czech, Welsh, Danish, Estonian, Irish, Croatian, Uzbek, Hungarian, Serbian (Latin), Indonesian, Occitan, Icelandic, Lithuanian, Maori, Malay, Dutch, Norwegian, Polish, Slovak, Slovenian, Albanian, Swedish, Swahili, Tagalog, Turkish, Latin, Azerbaijani, Kurdish, Latvian, Maltese, Pali, Romanian, Vietnamese, Finnish, Basque, Galician, Luxembourgish, Romansh, Catalan, Quechua
`arabic`	Arabic script (阿拉伯语系)	Arabic, Persian, Uyghur, Urdu, Pashto, Kurdish, Sindhi, Balochi, English
`cyrillic`	Cyrillic script (西里尔语系)	Russian, Belarusian, Ukrainian, Serbian (Cyrillic), Bulgarian, Mongolian, Abkhazian, Adyghe, Kabardian, Avar, Dargin, Ingush, Chechen, Lak, Lezgin, Tabasaran, Kazakh, Kyrgyz, Tajik, Macedonian, Tatar, Chuvash, Bashkir, Malian, Moldovan, Udmurt, Komi, Ossetian, Buryat, Kalmyk, Tuvan, Sakha, Karakalpak, English
`east_slavic`	East Slavic (东斯拉夫语系)	Russian, Belarusian, Ukrainian, English
`devanagari`	Devanagari script (天城文语系)	Hindi, Marathi, Nepali, Bihari, Maithili, Angika, Bhojpuri, Magahi, Santali, Newari, Konkani, Sanskrit, Haryanvi, English

Output behavior

No -o flag: result goes to stdout; status/progress messages go to stderr
With -o flag: result saved to file/directory; progress messages on stderr
Batch mode (extract/crawl only): requires -o to specify output directory
Binary formats (docx, extract only): cannot output to stdout, must use -o
Markdown output includes extracted images saved alongside the .md file

General rules

When using this skill on behalf of the user:

Quote file paths that contain spaces or special characters with double quotes in commands. Example: mineru-open-api extract "report 01.pdf", NOT mineru-open-api extract report 01.pdf.
Don't run commands blindly on errors — if the user asks "提取失败了怎么办", explain the exit code and troubleshooting steps instead of re-running the command.
Installation questions ("mineru 怎么安装") should be answered with the install instructions, not by running mineru-open-api extract.
DOCX as input is supported — if the user asks "这个 Word 文档能转 Markdown 吗", use mineru-open-api extract file.docx or mineru-open-api flash-extract file.docx. Note: .doc format is only supported by extract, not flash-extract.
Table extraction — tables are only recognized by extract (not flash-extract). If the user mentions tables, use extract.
For stdout mode (no -o), only one text format can be output at a time. If the user wants multiple formats, suggest adding -o.

Show full SKILL.md (691 more words)Show less

Choosing between flash-extract and extract

The agent MUST follow this decision logic:

Default to flash-extract when:
- User has NOT configured a token (no ~/.mineru/config.yaml, no MINERU_TOKEN env)
- User wants a quick/simple extraction without mentioning tables, formulas, OCR, or specific formats
- File is under 10 MB and under 20 pages
- User is trying the tool for the first time
Use extract when:
- User explicitly asks for table recognition, formula recognition, or OCR
- User requests non-Markdown output formats (html, latex, docx, json)
- User needs batch processing (multiple files)
- File is over 10 MB or over 20 pages (exceeds flash-extract limits)
- User has a token configured and wants precision-quality extraction
If unsure, prefer flash-extract — it's faster and requires no setup, but check file size first.
When the user does NOT specify an output path (-o), the agent MUST generate a default output directory to prevent file overwrites. Use:

~/MinerU-Skill/<name>_<hash>/

Naming rules:

<name>: derived from the source, then sanitized for safe directory names.
- For URLs: last path segment (e.g. https://arxiv.org/pdf/2509.22186 → 2509.22186)
- For local files: filename without extension (e.g. report.pdf → report)
- Sanitization: replace spaces and shell-unsafe characters (space, (, ), [, ], &, ', ", !, #, $, `) with _. Collapse consecutive _ into one. Keep alphanumeric, -, _, ., and CJK characters.
<hash>: first 6 characters of the MD5 hash of the full original source path or URL (before sanitization). This ensures:
- Different URLs with similar basenames get unique directories
- Re-running the same source reuses the same directory (idempotent) How the agent should generate the hash:

bash

echo -n "https://arxiv.org/pdf/2509.22186" | md5sum | cut -c1-6

Or on macOS:

bash

echo -n "https://arxiv.org/pdf/2509.22186" | md5 | cut -c1-6

When the user asks to upgrade or update this skill, the agent MUST re-install the CLI binary to ensure the latest commands are available. Run the install command before using any new features

flash-extract limit handling

When flash-extract fails due to file limits or rate limiting, the agent MUST provide a clear explanation and suggest extract as the upgrade path:

Rate limited (HTTP 429):

flash-extract 请求频率超出限制（每 IP 有每分钟/每小时的请求上限）。你可以：

稍等几分钟后重试

前往 https://mineru.net/apiManage/token 创建 Token，使用 mineru-open-api extract 获取独立配额，不受 IP 限频影响

Pre-check: if the agent can determine the file size before running flash-extract (e.g. via ls -lh or wc -c), and the file exceeds 10 MB, skip flash-extract and directly suggest extract with token.

Post-extraction friendly hints

After flash-extract completes successfully, the agent MUST append a brief hint:

Tip: flash-extract 为快速免登录模式（限 10MB/20页，不含表格识别）。如需解析更大文件、表格/公式识别或多格式导出，请前往 https://mineru.net/apiManage/token 创建 Token，运行 mineru-open-api auth 配置后使用 mineru-open-api extract。

Keep the hint to ONE short sentence. Do NOT repeat the hint if the user has already seen it in this session.

Examples:

Source	`<name>`	Output directory
`https://arxiv.org/pdf/2509.22186`	`2509.22186`	`~/MinerU-Skill/2509.22186_a3f2b1/`
`https://arxiv.org/pdf/2509.200`	`2509.200`	`~/MinerU-Skill/2509.200_c7e9d4/`

When the user specifies -o: use the user's path as-is, do NOT override with the default directory.

Exit codes

Code	Meaning	Recovery
0	Success	—
1	General API or unknown error	Check network connectivity; retry; use `--verbose` for details
2	Invalid parameters / usage error	Check command syntax and flag values

Troubleshooting

"no API token found" (on extract/crawl): Run mineru-open-api auth or set MINERU_TOKEN env variable. Or use flash-extract which needs no token.
Timeout on large files: Increase with --timeout 1600 (seconds)
Batch fails partially: Check stderr for per-file status; succeeded files are still saved
Binary format to stdout: Use -o flag; docx cannot stream to stdout
Private deployment: Use --base-url https://your-server.com/api
Extraction quality is poor: Try mineru-open-api extract with --model vlm for complex layouts, or --ocr for scanned documents
Tables not extracted: flash-extract does NOT support tables. Use mineru-open-api extract with a token.
HTTP 429 on flash-extract: IP rate limit hit. Wait a few minutes or switch to mineru-open-api extract with token.

Notes

extract requires a token but provides precision-featured extraction
All status/progress messages go to stderr; only document content goes to stdout
Batch mode automatically polls the API with exponential backoff
Token is stored in ~/.mineru/config.yaml after mineru-open-api auth

Reporting Issues

Skill issues: Open an issue at https://github.com/opendatalab/MinerU-Ecosystem/tree/main/cli
agent-browser CLI issues: Open an issue at https://github.com/MinerU-Extract/mineru-document-extractor

Files

SKILL.md and 2 other files in skills/mineru-ai of LeoYeAI/openclaw-master-skills.

SKILL.md
CONTRIBUTING.md
_meta.json

Open the folder on GitHubat commit e5199b5

Compare with similar skills

Mineru next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Mineru compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Mineru this skillLeoYeAI/openclaw-master-skills	2.2k	—	~4.4k	Automated safety check: Pass	MIT	2 mo ago
MineruNebutra/MinerU-Skill	123	—	~504	Automated safety check: Pass	MIT	16 days ago
MineruNebutra/MinerU-Skill	123	—	~1.4k	Automated safety check: Pass	MIT	16 days ago
Lexoid CLIoidlabs-com/Lexoid	109	—	~2k	Automated safety check: Notes	Apache-2.0	2 days ago
Lexoid Pythonoidlabs-com/Lexoid	109	—	~3.5k	Automated safety check: Notes	Apache-2.0	2 days ago
Ambiguity Reportlawve-ai/awesome-legal-skills	847	—	~4.6k	Automated safety check: Pass	Apache-2.0	7 days ago

Similar skills

Mineru
Nebutra/MinerU-Skill
An AI-Native skill for parsing PDF / Office / image files into Markdown with MinerU — a fast, zero-config document parser for AI agents.
123 GitHub stars~504 tokensUpdated 16 days ago
Documents & OfficeAuto-check passed
Mineru
Nebutra/MinerU-Skill
An AI-Native skill for parsing PDF / Office / image files into clean Markdown with MinerU — a fast, zero-config document parser for AI agents.
123 GitHub stars~1.4k tokensUpdated 16 days ago
Documents & OfficeAuto-check passed
Lexoid CLI
oidlabs-com/Lexoid
Parse and convert documents (PDFs, images, web pages, DOCX/XLSX/PPTX, audio) from the terminal using the lexoid CLI.
109 GitHub stars~2k tokensUpdated 2 days ago
Documents & OfficeAuto-check: notes
Lexoid Python
oidlabs-com/Lexoid
Parse and convert documents (PDFs, images, web pages, DOCX/XLSX/PPTX, audio) inside a Python program using the lexoid library.
109 GitHub stars~3.5k tokensUpdated 2 days ago
Documents & OfficeAuto-check: notes
Ambiguity Report
lawve-ai/awesome-legal-skills
Turn an interpretive-ambiguity audit of a legal text — contract, statute, regulation, or judicial opinion — into a polished deliverable.
847 GitHub stars~4.6k tokensUpdated 7 days ago
Documents & OfficeAuto-check passed
Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
781 GitHub starsUsed in 14 repos~3.2k tokens
Documents & OfficeAuto-check: notes

Questions about Mineru

What does Mineru do?

MinerU document extraction CLI that converts PDFs, images, and web pages into Markdown, HTML, LaTeX, or DOCX via the MinerU API. Mineru is an agent skill from LeoYeAI/openclaw-master-skills. MinerU document extraction CLI that converts PDFs, images, and web pages into Markdown, HTML, LaTeX, or DOCX via the MinerU API.

When should I use Mineru?

Mineru fits situations like: tasks that involve Word documents; tasks that involve LaTeX; tasks that involve Data pipelines and ETL.

How do I install Mineru in Claude Code?

Run `npx skills add LeoYeAI/openclaw-master-skills --skill mineru -a claude-code`. Or copy the skill folder (skills/mineru-ai in LeoYeAI/openclaw-master-skills) into .claude/skills/mineru in your project. Claude Code loads it when a task matches its description.

How do I install Mineru in Codex?

Run `npx skills add LeoYeAI/openclaw-master-skills --skill mineru -a codex`. Or copy the skill folder (skills/mineru-ai in LeoYeAI/openclaw-master-skills) into .agents/skills/mineru in your project. Codex loads it when a task matches its description.

Can I use Mineru in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add LeoYeAI/openclaw-master-skills --skill mineru -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mineru, .gemini/skills/mineru, .github/skills/mineru and .opencode/skills/mineru in your project.

What does Mineru need to run?

Going by SKILL.md and its folder, Mineru needs the command-line tools its instructions call (npm and go) and credentials named MINERU_TOKEN. Our summary lists: Node.js; A credential in MINERU_TOKEN. Its frontmatter pre-approves these tools: Bash(mineru-open-api:*).

Does Mineru access the network?

SKILL.md names 3 domains. In commands or code: arxiv.org; the agent is likely to contact it when it follows the instructions. As links in the text: mineru.net and github.com. This is read from the text; nothing was executed.

Is Mineru safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Mineru use?

Mineru is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mineru use?

About 4.4k tokens (SKILL.md is roughly 18k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Mineru?

Skills that share tags, products or a category with Mineru: Mineru (Nebutra/MinerU-Skill, 123 stars), Mineru (Nebutra/MinerU-Skill, 123 stars), Lexoid CLI (oidlabs-com/Lexoid, 109 stars) and Lexoid Python (oidlabs-com/Lexoid, 109 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mineru?

LeoYeAI (a GitHub user) maintains it in LeoYeAI/openclaw-master-skills, which has 2,161 GitHub stars. The repository holds 1,235 skills in this directory. The repository was last updated on July 20, 2026.

Source: LeoYeAI/openclaw-master-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Mineru

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Document Extraction with mineru-open-api

Installation

Verify installation

Two extraction modes

flash-extract limits

Core workflow

Authentication

Supported input formats

Commands

flash-extract — Quick extraction (no token needed)

flash-extract flags

extract — Precision extraction (token required)

extract flags

Model comparison: vlm vs pipeline

crawl — Web page extraction (token required)

crawl flags

auth — Authentication management

Supported --language values

Standalone language packs

Language family packs

Output behavior

General rules

Choosing between flash-extract and extract

flash-extract limit handling

Post-extraction friendly hints

Exit codes

Troubleshooting

Notes

Reporting Issues

Files

Compare with similar skills

Similar skills

More from LeoYeAI/openclaw-master-skills

Related

Questions about Mineru

Supported `--language` values