К основному содержанию
скилл CX Codex

mineru · nebutra — скилл для Claude Code: что делает и как установить

Скилл mineru конвертирует PDF, документы Office и сканы в чистый Markdown с формулами LaTeX и таблицами без начальной настройки токена.

MIT 19 установок ★ 138 обновлён 2026-09-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Nebutra/MinerU-Skill --skill mineru -a claude-code
Открыть на GitHub

Что делает mineru

Скилл запускает скрипт scripts/mineru.py через Python 3 или утилиту uv. Для небольших файлов размером до 10 МБ и объёмом до 20 страниц инструмент обращается к бесплатному Agent API, которому не требуется авторизация. Если файл превышает лимит либо запускается пакетная обработка каталога, скрипт переключается на Standard API при наличии переменной окружения MINERU_TOKEN.

Парсер извлекает текст, распознаёт сканы через флаг --ocr, сохраняет таблицы и формулы. Результат можно вывести прямо в консоль через --stdout, передать агенту в формате JSON или отправить во внешние базы заметок флагом --to, включая Obsidian и Notion. Для связи с инструментами по протоколу MCP в состав входит сервер scripts/mineru_mcp.py.

Файлы больше 20 страниц не обработаются через бесплатный Agent API без токена.

Какие задачи решает

  • конвертировать отчёты PDF и презентации в Markdown с разметкой таблиц
  • распознать текст и формулы LaTeX со сканированных страниц
  • пакетно разобрать папку документов в несколько потоков
  • отправить распарсенный контент прямо в хранилище Obsidian или Notion

Примеры запросов агенту

  • Преобразуй документ paper.pdf в Markdown и покажи текст в ответе
  • Запусти mineru для папки ./docs/ с флагом --ocr и выводом в ./output/
  • Распарси таблицу report.xlsx и отправь результат в Obsidian

Как установить mineru

1Через Skills CLI (Vercel)

npx skills add Nebutra/MinerU-Skill --skill mineru -a claude-code

2Вручную: положить файлы

~/.claude/skills/nebutra-mineru/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/nebutra-mineru/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о mineru

Как установить mineru в Claude Code?

Выполните в терминале команду npx skills add Nebutra/MinerU-Skill --skill nebutra-mineru -a claude-code.

Что делает скилл mineru?

Он переводит документы форматов PDF, Word, Excel, PPT и изображения в Markdown, сохраняя формулы LaTeX, таблицы и иллюстрации.

Нужен ли API-токен для работы?

Для файлов до 10 МБ и до 20 страниц токен не нужен, парсинг идёт через бесплатный Agent API. Для больших документов и пакетной пачки потребуется задать MINERU_TOKEN.

Исходный текст

SKILL.md · MIT
---
name: mineru
description: "An AI-Native skill for parsing PDF / Office / image files into clean Markdown with MinerU — a fast, zero-config document parser for AI agents. Works with NO token via the lightweight Agent API and auto-upgrades to the Standard API (token) for large files, batches, and DOCX/HTML/LaTeX export. Use when: (1) Converting PDF/Word/PPT/Excel/image to Markdown, (2) Extracting text, tables, formulas, or running OCR on scanned docs, (3) Batch-parsing a folder in parallel, (4) Piping parsed Markdown straight back to an agent or into Obsidian."
homepage: https://mineru.net
metadata:
  author: Nebutra
  version: "3.3.1"
  argument-hint: <pdf-file-or-url>
  openclaw:
    emoji: "📄"
    requires:
      bins: ["python3"]
---

# MinerU PDF Parser

Parse PDF, Office (Word/PPT/Excel), and image files into clean Markdown — with
LaTeX formulas, tables, images, and OCR. One zero-dependency script, two backends,
automatic routing.

## Zero-config quick start (no token, no install)

```bash
# Parse a local file or URL — the Agent API needs no login
python3 scripts/mineru.py paper.pdf

# Pipe the Markdown straight back to an agent
python3 scripts/mineru.py paper.pdf --stdout

# Machine-readable status for tool pipelines
python3 scripts/mineru.py paper.pdf --json
```

No `pip install`, no API key. The free **Agent API** handles files ≤ 10 MB / ≤ 20 pages.

### Run with uv (zero-install, managed Python)

`scripts/mineru.py` carries [PEP 723](https://peps.python.org/pep-0723/) inline
metadata, so [uv](https://docs.astral.sh/uv/) runs it directly — no venv, no
`pip install`, with a uv-managed interpreter:

```bash
uv run scripts/mineru.py paper.pdf --stdout       # zero-install run
uv run --no-project --with pytest pytest -q       # dev suite via uv
```

## Power mode (token) — large files, batches, extra formats

```bash
export MINERU_TOKEN="..."          # https://mineru.net/apiManage/token

# Parallel batch a directory, resume on re-run
python3 scripts/mineru.py ./pdfs/ --output ./out/ --workers 8 --resume

# Export DOCX/HTML/LaTeX alongside Markdown (auto-routes to the Standard API)
python3 scripts/mineru.py report.pdf --format docx --format latex
```

When a token is set, the tool **auto-routes**: small single files still use the
free Agent API; anything large (> 10 MB / > 20 pages), batched, or needing extra
export formats uses the **Standard API** (≤ 200 MB / ≤ 200 pages). If the Agent
API hits a size/page limit, it auto-escalates to the Standard API.

## Supported modalities

| Modality | Extensions | OCR |
|----------|-----------|-----|
| PDF | `.pdf` | `--ocr` |
| Image | `.png .jpg .jpeg .jp2 .webp .gif .bmp` | built-in |
| Word | `.doc .docx` | — |
| Slides | `.ppt .pptx` | — |
| Sheet | `.xls .xlsx` | — |
| HTML | `.html` (Standard API, `MinerU-HTML` model) | — |

## Common options

```
INPUT...          One or more files, a directory, or a URL
--output, -o      Output directory (default: ./output)
--api             auto | agent | standard   (default: auto)
--model           pipeline | vlm | MinerU-HTML  (default: vlm)
--format          docx | html | latex  (repeatable; forces Standard API)
--lang            OCR/document language (default: ch)
--ocr             Enable OCR for scanned documents
--pages           Page range, e.g. "1-10" or "2,4-6"
--workers, -w     Concurrent submit/upload/download slots (default: 8)
--resume          Skip inputs already parsed
--stdout          Print Markdown to stdout
--json            Print machine-readable status to stdout
--to SINK         Deliver into a content tool (repeatable); --list-sinks to enumerate
--obsidian PATH   Shortcut for --to obsidian with this vault
--engine          cloud | local | auto  (local/auto parse born-digital PDFs offline)
--split           Split oversized PDFs past the page caps, parse parts, merge (needs pypdf)
--chunk           Emit heading-aware RAG chunks (.chunks.json + --json)
--doctor          Environment self-check and exit
```

## MCP server

Expose MinerU over MCP (zero-dependency stdio JSON-RPC) so an MCP host can call it:

```bash
python3 scripts/mineru_mcp.py
```

Tools: `mineru_parse`, `mineru_parse_to` (parse + deliver to sinks), `mineru_list_sinks`.

## Deliver into your tools (`--to`)

Parse once and push the Markdown into content tools via each one's official path:

```bash
python3 scripts/mineru.py paper.pdf --to obsidian --to notion --to feishu
```

Targets: `obsidian` `logseq` `siyuan` `notion` `linear` `yuque` `coda` `slack`
`feishu` `confluence` `onenote` `ticktick` `dingtalk` `airtable` `wecom` (all
zero-dependency), plus `roam` and `wps` via optional extras. Each reads its config
from env vars (run `--list-sinks`). Per-target auth, fidelity, and image notes:
[references/integrations.md](references/integrations.md).

## Output

```
output/
└── document-name/
    ├── document-name.md    # clean Markdown
    └── images/             # extracted figures (Standard API)
```

## Performance (real, measured)

End-to-end latency for the official demo PDF via the free Agent API:
**cold ≈ 14 s · warm ≈ 13 s** (submit → poll → download). Batches scale with
`--workers`. Numbers come from the no-mock live benchmark in `tests/test_live.py`.

## Testing

```bash
python3 -m pytest                      # fast unit suite (offline)
MINERU_LIVE=1 python3 -m pytest -m live -s   # real API + benchmark (no mocks)
```

## API Reference

See [references/api_reference.md](references/api_reference.md). Official docs:
https://mineru.net/apiManage/docs · Token: https://mineru.net/apiManage/token

© Nebutra · MIT · Nebutra/MinerU-Skill

Похожие скиллы

Все скиллы по теме «Документы и офис» →

Сначала — mineru от других авторов.

mineru opendatalab Подключает MinerU для чтения, OCR, поиска и разбора локальных документов. Разбирает PDF, сканы, таблицы и длинные файлы. CX Codex +1 2 100установок MinerU Open MCP opendatalab MinerU Open MCP — MCP-сервер для Claude Code, который разбирает документы через MinerU API и возвращает Markdown. Запускается по запросу обработать файл. CX Codex +1 ★ 231звёзд репо paddleocr-doc-parsing PaddlePaddle Скилл paddleocr-doc-parsing извлекает структурированный Markdown и JSON из документов PDF и сканов. Переводит таблицы по ячейкам, формулы в LaTeX и сохраняет порядок чтения. CX Codex +1 483установок markitdown julianobarbosa Скилл-инструкция по Microsoft MarkItDown: превращает PDF, Word, Excel, картинки и ссылки в Markdown, готовый для контекста LLM. CX Codex +1 1 700установок ocr mr-shaper Скилл ocr для Claude Code извлекает текст из графических файлов и PDF с помощью распознавания символов. Читает таблицы со скриншотов и оцифровывает сканы. CX Codex +1 509установок docling.rs docling-project MCP-сервер docling.rs превращает PDF, Office, HTML и сканы в Markdown с сохранением структуры — заголовки, таблицы и OCR для агентов. CX Codex +1 ★ 144звёзд репо ReadAnyDoc arpitpatel25 MCP-сервер ReadAnyDoc для Claude Code переводит PDF, сканы и офисные файлы в Markdown или типизированные поля с координатами на странице. Обрабатывает документы через vision-модели. CX Codex +1 ★ 11звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой