Mineru Extract

MinerU is a parsing API that converts URLs into clean Markdown with structured outputs. Point it at WeChat articles, PDFs, Office docs, or images and it handles layout, tables, formulas, and OCR better than basic web scrapers. You get a zip with extracted Markdown plus assets. The skill wraps the official mineru.net API with two scripts: an MCP-style batch parser that outputs JSON contracts, and a low-level single-URL extractor. It auto-picks between the HTML-optimized model and the general pipeline based on file extension. Useful when web_fetch gives you garbage or when you need high-fidelity extraction from paywalled or anti-bot pages, though it won't magically bypass authentication.

skills.sh installs: 184
GitHub stars: 436
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add blessonism/openclaw-search-skills --skill mineru-extract --agent claude-code

Installs into .claude/skills of the current project.

Files

MinerU Extract (official API)

Use MinerU as an upstream “content normalizer”: submit a URL to MinerU, poll for completion, download the result zip, and extract the main Markdown.

Quick start (MCP-aligned)

We align to the MinerU MCP mental model, but we do not run an MCP server.

Primary script (MCP-style): scripts/mineru_parse_documents.py
- Input: --file-sources (comma/newline-separated)
- Output: JSON contract on stdout: { ok, items, errors }
Low-level script (single URL): scripts/mineru_extract.py

Auth:

Set MINERU_TOKEN (Bearer token from mineru.net)

Default model heuristic:

URLs ending with .pdf/.doc/.ppt/.png/.jpg → pipeline
Otherwise → MinerU-HTML (best for HTML pages like WeChat articles)

1) Configure token (skill-local)

Put secrets in skill root .env (do not paste into chat outputs):

# In the mineru-extract skill directory: .env
MINERU_TOKEN=your_token_here
MINERU_API_BASE=https://mineru.net

2) Parse URL(s) → Markdown (recommended)

MCP-style wrapper (returns JSON, optionally includes markdown text):

SKILL.md on GitHub

Details

Repository: github.com/blessonism/openclaw-search-skills
Categories: Frontend Development, Backend & APIs, Automation & Workflows, Office & Documents
First seen: Jun 3, 2026

More from blessonism/openclaw-search-skills

All 3