mineru-document-extractor（Mineru 文档提取器） Skills下载安装命令和教程

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手，先确认命令和权限，再让它执行。

请帮我安装这个 Agent Skill：mineru-document-extractor（Mineru 文档提取器）
来源仓库：https://modelscope.cn
仓库路径：mineru-document-extractor
安装命令：
npm install -g mineru-open-api
安装前请先检查当前环境是否支持对应 CLI，并向我确认将要执行的命令、安装目录、联网范围和文件读写权限；确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过对应宿主从第三方来源获取 Skill；本站只展示命令，不托管安装包，也不自动执行。

skills.sh安装方式未标明

npm install -g mineru-open-api

这个 Skill 是做什么的

前端设计类 Skill 关注页面结构、视觉规范和组件写法，输出通常是可运行的界面代码。

mineru-document-extractor 用于整理文档、README 和 Markdown 材料。适合在 Local Agent 中把零散信息整理成结构清晰的文档。使用 npm install -g mineru-open-api 安装。安装前建议确认权限范围和维护状态，避免触发联网或文件读写。

注意是否会执行命令或访问外部资源，确保符合安全策略。

来源仓库内路径：mineru-document-extractor

上手步骤

4 步

1
确认自己的宿主工具
公开资料标注支持 Local Agent；先确认自己用的是其中之一，再按对应工具的 Skills 目录放置。
2
拿到安装命令
可以直接复制的命令是 npm install -g mineru-open-api；命令里的占位符换成自己的路径或密钥再执行。
3
安装后重启宿主
命令执行完要完全退出宿主工具再打开，让新装的 Skill 被重新扫描到，否则列表里可能看不到。
4
按最小权限试用
它需要接触敏感数据，先在测试目录或测试账号里跑，确认没问题再放到正式项目。

常见问题

6 条

mineru-document-extractor 怎么安装？

在终端执行 npm install -g mineru-open-api。装完完全退出宿主工具再打开，让它重新扫描本地 Skill。

mineru-document-extractor 支持哪些 AI 工具？

公开资料标注支持 Local Agent。其他工具只要能读取本地 Skill 目录，一般也能手动放进去，但要自己确认触发方式是否一致。

mineru-document-extractor 需要什么权限？

权限级别是接触敏感数据。该 Skill 可能接触密钥、Token、环境变量或敏感配置，应进入高风险复核队列，默认不自动发布。

mineru-document-extractor 是免费的吗？

公开资料没有标注明确许可证，收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

mineru-document-extractor 用的人多吗？

公开数据是累计安装 1,599 次，近一周安装 68 次，下载 560 次。这些数字来自第三方目录统计，只能当作热度参考，不代表质量或安全性。

mineru-document-extractor 安全吗？

没有查到第三方扫描结果，安全性无法从公开资料判断，安装前请自行审查源码、依赖和命令行为。

值得选的地方和要先想清楚的地方

值得选的地方

专注 Local Agent 一种宿主，触发方式和使用习惯不用来回切换。

先想清楚的地方

需要接触敏感数据，装到常用环境前要先评估影响面。
许可证没有明确标注，能不能商用、能不能再分发都不确定。
没有第三方扫描结果，安全性只能靠自己读源码判断。
第三方目录整理，版本更新和行为细节以来源仓库为准。

适不适合你

更适合

已经在用 Local Agent，想直接扩展它能力的人。
需要处理前端设计类任务、又不想每次都手写提示词的人。

不太适合

环境里有大量密钥、凭证，不方便给第三方 Skill 读取的人。
需要明确授权才能用到公司项目里的场景。
要求有安全扫描结论才肯安装的团队。

前端设计类 Skill 对比

6 个同类

Skill	总安装	GitHub 星	权限	许可证	扫描
frontend-design 前端设计 · Codex、Claude	8,823,360	126,072	只读	MIT	通过
vercel-composition-patterns Vercel 组合模式 · Codex、Claude	3,858,816	25,893	需要联网	MIT	通过
vercel-react-native-skills Vercel React native skills 前端 · Codex、Claude	2,468,664	25,878	只读	MIT	通过
adapt adapt 搜索 · Codex、Claude	2,027,040	23,125	操作浏览器	未明确	通过
bolder bolder 分析 · Codex、Claude	2,004,288	23,130	只读	未明确	通过
mineru-document-extractor Mineru 文档提取器 · 本页	1,599	—	接触敏感数据	未明确	未收录

按安装量取同分类前几名；数字来自第三方目录统计，只作热度参考，不代表质量结论。

SKILL.md 原文

Document Extraction with mineru-open-api

Installation

npm install -g mineru-open-api

Or via Go (macOS/Linux):

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

Verify installation

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):

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.

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.

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.

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

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.

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:

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

Or on macOS:

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 有每分钟/每小时的请求上限）。你可以： 1. 稍等几分钟后重试 2. 前往 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

平台分布

Local Agent

88.81%

按下载量换算497

安全审计

暂无安全审计结果可展示。

权限和风险

接触敏感数据

该 Skill 可能接触密钥、Token、环境变量或敏感配置，应进入高风险复核队列，默认不自动发布。

安装前确认

本站仅展示第三方公开信息，不托管安装包，不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。目前只有一个公开来源，建议同时核对源仓库。

继续浏览同类 Skills

更多前端设计 Skills（10,216）返回 Skills 目录

上一个 Skill

mineru-document-extractor（Mineru 文档提取器）

opendatalab/mineru-ecosystem

用于辅助数据整理、表格处理、CSV/Excel 分析、指标计算和图表准备。它适合让 Agent 清洗字段、汇总数据、发现异常、生成统计口径或把分析结果转成可读说明。使用时需要确认数据来源、字段含义和时间范围，避免把样本数据当全量事实；涉及敏感数据、导出文件或批量写回时，应先确认权限和脱敏边界。

下一个 Skill