Skip to content
cccskills
FreePublished on GitHub

mineru

Parse PDFs, Office files, images, and HTML into Markdown/structured outputs with MinerU. Use when SciForge or Codex needs document parsing/OCR for scientific papers, supplementary files, PDFs, scanned documents, tables, formulas, or URL/local-file parsing through MinerU standard or Agent lightweight APIs.

The English summary is being prepared. Showing the original description.

See how to install

Files included (4)

  • SKILL.md2.5 KB
  • agents/openai.yaml186 B
  • references/api.md2.7 KB
  • scripts/mineru_parse.py11.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

MinerU

Use MinerU to turn PDFs, Office files, images, and HTML into Markdown and structured outputs for downstream research workflows.

Choose API Mode

  • Prefer standard mode for scientific papers and reproducible project work. It requires MINERU_API_KEY, supports files up to 200 MB / 200 pages, batch upload, pipeline / vlm / MinerU-HTML, tables, formulas, and zip outputs.
  • Use agent mode for quick, small, non-sensitive parsing. It needs no token, is IP-rate-limited, supports a single file or URL, returns Markdown only, and is intended for lightweight agent workflows.

Do not store API keys in skill files, source code, logs, or committed .env files. Read standard API credentials from MINERU_API_KEY.

Quick Commands

Use the bundled CLI:

python .codex/skills/mineru/scripts/mineru_parse.py standard-file path/to/paper.pdf --output-dir outputs/results/mineru/paper --model-version vlm --extra-format html
python .codex/skills/mineru/scripts/mineru_parse.py standard-url https://example.com/paper.pdf --output-dir outputs/results/mineru/paper --model-version vlm
python .codex/skills/mineru/scripts/mineru_parse.py agent-file path/to/small.pdf --output-dir /tmp/mineru-small
python .codex/skills/mineru/scripts/mineru_parse.py agent-url https://example.com/small.pdf --output-dir /tmp/mineru-small

For local files in standard mode, the CLI requests a signed upload URL, uploads the file, polls the batch result, downloads the result zip, and extracts it.

For standard URL mode, the CLI submits the URL task, polls it, downloads the result zip, and extracts it.

For agent mode, the CLI downloads the returned Markdown file.

Recommended Defaults

  • Use --model-version vlm for scientific papers with formulas, tables, and figures.
  • Use --model-version MinerU-HTML only for HTML source files.
  • Use --pages to limit expensive or slow parses during tests.
  • Keep raw PDFs and downloaded zips in ignored local folders; commit only extracted, reviewed Markdown/metadata when appropriate.

Resources

  • scripts/mineru_parse.py: deterministic CLI wrapper for MinerU API calls.
  • references/api.md: concise API reference extracted from the local MinerU HTML documentation.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Submit protein folding tasks to the AlphaFold3 C550 inference platform. Use when the user needs to run AlphaFold3 predictions with pre-prepared JSON input files on the AI4S Kubernetes cluster.

The English summary is being prepared. Showing the original description.

AGI4Sci/SciForge83Updated Sep 3, 2026

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md, or recording or editing an ADR.

The English summary is being prepared. Showing the original description.

AGI4Sci/SciForge83Updated Sep 3, 2026

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

The English summary is being prepared. Showing the original description.

AGI4Sci/SciForge83Updated Sep 3, 2026

Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.

The English summary is being prepared. Showing the original description.

AGI4Sci/SciForge83Updated Sep 3, 2026

Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or work through tasks.

The English summary is being prepared. Showing the original description.

AGI4Sci/SciForge83Updated Sep 3, 2026

Archive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete.

The English summary is being prepared. Showing the original description.

AGI4Sci/SciForge83Updated Sep 3, 2026

See all skills by AGI4Sci

Report a problem with this skill