MinerU Skill
Скилл и CLI без ключа и зависимостей: превращает PDF, Office и картинки в Markdown через облако MinerU.
- 133 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Содержимое каждого обрабатываемого документа уходит в облако MinerU, а при платном тарифе — с токеном доступа.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/mineru-skillОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Содержимое каждого обрабатываемого документа уходит в облако MinerU, а при платном тарифе — с токеном доступа.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MinerU Skill оборачивает облачный API MinerU в один Python-скрипт на стандартной библиотеке. Без токена и установки работает бесплатный Agent API: команда сразу парсит PDF, Word, PPT, Excel, HTML или картинку и печатает чистый Markdown в терминал или агенту. С переменной `MINERU_TOKEN` подключается Standard API — файлы до 200 МБ и 200 страниц, параллельные батчи, экспорт в DOCX, HTML и LaTeX. Результат можно сразу доставить в 17 инструментов: Obsidian, Notion, Confluence, Slack, Linear, Airtable и другие, флагом `--to` или их комбинацией. Отдельный скрипт поднимает тот же разбор как MCP-сервер (`mineru_mcp.py`) с инструментами `mineru_parse`, `mineru_parse_to` и `mineru_list_sinks`.
Для кого. Разработчикам и агентам, которым нужно быстро превратить документ в Markdown без учетной записи и без установки тяжелых моделей распознавания.
Подходит, если
- Агент получил ссылку на PDF и должен вернуть его содержимое текстом без ручной загрузки файла.
- Нужно разобрать папку со сканами и сразу сложить результат в Obsidian или Notion одной командой.
- В PDF есть формулы и таблицы, и важно сохранить их в LaTeX и структурированном виде, а не потерять при конвертации.
- Документ слишком большой для бесплатного тарифа, и нужен автоматический переход на платный API без смены команды.
Не подходит, если
- Документы конфиденциальные или регулируемые: инструмент загружает каждый файл в облако MinerU, офлайн-режим есть только для `born-digital` PDF.
- Важна максимальная точность формул и таблиц конкретно для вашего домена: это обертка над облаком MinerU, точность целиком зависит от него.
- Нужен RAG-конвейер со структурированным JSON-извлечением и фреймворк-интеграцией: для этого лучше подходят Unstructured, LlamaParse или Docling.
Пример запроса к агенту
Разбери все PDF в папке ./scans параллельно, пропусти уже обработанные и сложи результат в мой Obsidian-хранилище.Ограничения
Любой файл уходит в облако MinerU, офлайн доступен только режим `--engine local` для `born-digital` PDF через pymupdf4llm. Бесплатный Agent API ограничен размером файла и страницами; крупные документы требуют `MINERU_TOKEN` и переходят на Standard API автоматически. Разбивка файлов больше лимитов (`--split`) требует отдельного пакета `pypdf`, а чанкинг для RAG (`--chunk`) не заменяет специализированные RAG-фреймворки. Точность распознавания равна точности облака MinerU: инструмент не улучшает и не ухудшает качество OCR и таблиц.
Как отключить. Удалите каталог со скиллом (`~/.claude/skills/mineru/` при ручной установке) и уберите переменную `MINERU_TOKEN`, если она была задана. Отдельно остановите процесс `mineru_mcp.py`, если запускали его как MCP-сервер.
Частые вопросы
Как установить MinerU Skill в Claude Code или Codex?
Через Vercel Skills: `npx skills add Nebutra/MinerU-Skill` ставит скилл сразу под нужного агента из 35 с лишним поддержанных. Альтернатива — ручное клонирование в `~/.claude/skills/mineru/`.
Нужен ли токен для начала работы?
Нет. Бесплатный Agent API работает без регистрации и ключа. `MINERU_TOKEN` нужен только для файлов за пределами бесплатного лимита по размеру и страницам и для экспорта в DOCX, HTML, LaTeX.
Как доставить результат сразу в несколько инструментов?
Флаг `--to` повторяется: `python3 scripts/mineru.py paper.pdf --to obsidian --to notion --to slack` разложит Markdown по всем трем сразу.
Чем это отличается от официального MCP-сервера MinerU?
Обе обертки дают идентичный результат OCR и таблиц, потому что бьют в один и тот же `backend`. MinerU Skill отличается нулевыми зависимостями ядра, бесплатным стартом без ключа и 17 готовыми интеграциями доставки, которых у официального MCP нет.
Можно ли работать офлайн?
Только с `born-digital` PDF (текст уже в файле, не сканы) через `--engine local`, который использует pymupdf4llm. Сканы и остальные форматы всегда идут через облако.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыMinerU — CLI с библиотекой документов: уже разобранный отчет можно искать и читать повторно из локального кеша.
Пять скиллов превращают PDF научной статьи в слайды, постер, страницу проекта, пост для Xiaohongshu и статью для WeChat.
Скилл и CLI от Firecrawl: агент переводит Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV и PDF в Markdown на вашей машине
Скилл и CLI превращают Markdown в DOCX, PDF, PPTX, XLSX, PNG и еще десяток форматов, все считается локально
MCP-сервер, который превращает PDF, DOCX, XLSX, PPTX, изображения, аудио, веб-страницы и расшифровки YouTube в Markdown
Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MinerU Skill (эта карточка) | нет | не нужна | 133 | |
| MinerU | нет | 83 203 | движок самого MinerU с полным self-host; этот скилл — легковесная обертка над его облачным API с бесплатным стартом без ключа | |
| MarkItDown | да | не нужна | 194 189 | MarkItDown конвертирует локально без облака и без OCR-точности MinerU, но без доставки в 17 инструментов |
| Docling | нет | 70 176 | Docling разбирает документы полностью офлайн; MinerU Skill жертвует офлайн-режимом ради облачной точности MinerU и готовой доставки |
Коротко о README
README приводит сравнительную таблицу с десятком похожих инструментов и прямо называет случаи, когда конкурент подходит лучше: офлайн-работу, RAG-извлечение или точность формул выше среднего.