技能包

在 Claude Code 里用 MinerU 转文档

适合把 PDF、图片或办公文档转成 Markdown 等文本,但默认只有 flash-extract,完整 extract 要先跑认证。

官方来源 · pdf-converter-mineru

安装

npx skills add tanis90/pdf-converter-mineru

适合谁

如果你已经在 Claude Code 里处理本地文档,希望把 PDF、图片或 Office 文档转成可编辑文本,这个技能对得上。官方把它写成基于 MinerU 生态的 Claude Code 技能,用来转换 PDF 和其他文档。MinerU 的页面写在

https://mineru.net/

输出格式被写成 Markdown、Word、HTML、LaTeX 或纯文本。它点名的使用环境是 Claude Code:当你提出转换或抽取文档时,Claude 会自动调用 mineru-open-api。页面没有写其他智能体的安装命令,也没有把支持面写成互斥名单。

更合适的人是:手头有一份可以公开给本机转换的 PDF 或办公文件,想先看默认 flash-extract 的结果,而不是一上来做完整 extract。官方说明见

https://github.com/tanis90/pdf-converter-mineru

3 分钟完成第一次尝试

只走这一条官方安装路径:

npx skills add tanis90/pdf-converter-mineru

前置:本机已能打开 Claude Code,并且准备好一份本地 PDF 或办公文档。安装由上述命令完成,页面没有另给第二条安装器。

第一次任务选低风险转换。先和 Claude 确认源文件路径、目标格式(建议先选 Markdown 或纯文本)以及结果要写到哪里;你点头后,再让它转换。默认模式是 flash-extract,不必先做认证。转换会写新文件,也是一次对外调用,确认路径无误再执行。

成功信号:技能装上后,Claude 自动走 mineru-open-api,并生成一份可打开的 Markdown 或纯文本,而不是提示未安装。若它要做 mineru-open-api auth,先停下来,确认这是你要解锁 extract 模式,而不是第一次尝试必需步骤。

使用案例

案例一:用默认 flash-extract 把 PDF 转成 Markdown。

官方写明可把 PDF 转成 Markdown,并且默认使用 flash-extract。第一次只转一份已知 PDF,核对标题和段落是否还在。页面没有写页眉页脚、扫描件或加密 PDF 会怎样,也没有写 flash-extract 和 extract 的质量差别,能确认的只有默认模式名称,以及 Claude 会自动调用 mineru-open-api。

案例二:先认证,再对图片或 Office 文档做 extract。

官方写明运行 mineru-open-api auth 后才能解锁 extract 模式,并且转换范围包括图片和 Office 文档,目标仍可以是 Markdown、Word、HTML、LaTeX 或纯文本。先单独跑认证,看到解锁成功后再选一份图片或办公文件。认证会改本地凭证,确认命令窗口来自 mineru-open-api auth 再继续。页面没有写出认证要填哪些字段,也没有写 extract 的额外开关。

两个案例都建立在同一条 npx 安装命令上。第一次不要并行尝试其他安装方式。

使用边界

可复制的官方安装命令只有 npx skills add tanis90/pdf-converter-mineru。默认始终是 flash-extract;要 extract,必须先成功跑完 mineru-open-api auth。页面没有把认证写成第一次转换的前提,也没有写可以跳过 Claude、直接当独立转换器来用。

能力覆盖 PDF、图片和 Office 到五种文本或文档格式,但没有给出文件大小、页数或语言范围。转换会写出新文件,路径需要你事先确认。MinerU 被写成底层生态,细节以

https://mineru.net/

为准;本技能页没有复述 MinerU 的配额或账号规则。