MinerU Document Explorer

通过 doc-search CLI 解析 PDF，生成文档大纲，按页读取内容，支持关键词与语义检索，并提取图表等元素。强调先搜索缩小范围再读取相关页，输出 JSON，可选用外部 API 增强能力。

rise-1210

热度 50.88

最近更新 2026-05-11 17:38:19

分类：知识依赖：代码执行 / 读写文件 / 第三方 API应用场景：研究 / 摘要总结 / 数据处理

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add mineru-document-explorer

Metadata

name: mineru-document-explorer
description: REQUIRED for any task involving reading or understanding PDF contents. Use when a user asks about a .pdf file — reading pages, answering questions, extracting data, or locating topics. Skip only for PDF file operations: merge, split, watermark, create, form-fill, or encrypt.
credentials: {"optional":["DOC_SEARCH_PAGEINDEX_API_KEY","DOC_SEARCH_PAGEINDEX_BASE_URL","DOC_SEARCH_EMBEDDING_BASE_URL","DOC_SEARCH_RERANKER_BASE_URL","MINERU_TOKEN"]}
network: true

MinerU Document Explorer

PDF reading toolkit via doc-search CLI. Search first, then read relevant pages — never scan an entire PDF.

⚠️ Network capabilities: This skill can optionally call external APIs (PageIndex outline generation, MinerU cloud OCR, embedding/reranker services) and run a local FastAPI server. All network features are opt-in and disabled by default.

Path conventions

SKILL_DIR  = <this file's parent directory>
SCRIPTS    = SKILL_DIR/scripts

Setup check

Read SKILL_DIR/config-state.json. If missing or setup_complete is not true:

Read references/setup.md and run the installer
After setup, ask the user if they want to configure PageIndex (e.g. "If you have an OpenAI-compatible API key, you can enable PageIndex to auto-generate a document outline — useful for scanned docs or manuals. Want to set it up?")
If the user provides pageindex_api_key / pageindex_base_url → write to SCRIPTS/doc-search/config.yaml; if skipped → continue immediately, do not block

⚠️ MUST read reference docs before acting — no guessing

Any uncertainty about parameters, return fields, or query phrasing → MUST read the corresponding cmd file before running any command. Do not infer or guess.

references/cmd-init.md / cmd-outline.md / cmd-pages.md
references/cmd-search-keyword.md / cmd-search-semantic.md / cmd-elements.md

For complex tasks, errors, unexpected results, or unfamiliar scenarios → MUST read references/tips.md first. It contains proven workflows and hard-won pitfalls that will save you from repeating mistakes.

Command cheatsheet

All output is JSON on stdout. --timeout is a global flag before the subcommand; default is 120s.

doc-search init --doc_path "<path_or_url>"
doc-search outline --doc_id "<id>" [--max_depth N] [--root_node "<node_id>"]
doc-search pages --doc_id "<id>" --page_idxs "<p>" [--no_image] [--return_text]
doc-search search-keyword --doc_id "<id>" --page_idxs "<p>" --pattern "<regex>" [--return_text]
doc-search search-semantic --doc_id "<id>" --page_idxs "<p>" --query "<q>" [--top_k N] [--no_image] [--return_text]
doc-search --timeout 300 elements --doc_id "<id>" --page_idxs "<p>" --query "<q>"

Key reminders

Use outline and keyword search to narrow the reading range — never scan the full document
--page_idxs is 0-indexed — do not confuse with printed page numbers
After extracting figures/tables with elements, you must read crop_path to verify ; and the query should be "the actual chart image, not the caption text" ; if the query fails, check page_idxs or rephrase the query

Lessons learned (mandatory)

After completing any PDF task: pitfalls / new workflows / parameter discoveries → append to references/tips.md, 1-2 lines each, conclusions only.