Skills pdf-parser

使用 MinerU API 将 PDF 解析为 Markdown,支持公式、表格、OCR。提供本地文件和在线 URL 两种解析方式。触发条件:(1) 用户说"解析 PDF [路径]",(2) 用户说"将 PDF 转为 Markdown",(3) 在 paper-workflow 中自动调用。使用场景:学术论文解析、文档提取、知识库构建。

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/alex-zxyz/mineru-pdf-parser" ~/.claude/skills/openclaw-skills-pdf-parser && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/alex-zxyz/mineru-pdf-parser" ~/.openclaw/skills/openclaw-skills-pdf-parser && rm -rf "$T"
manifest: skills/alex-zxyz/mineru-pdf-parser/SKILL.md
source content

PDF Parser Skill

基于 MinerU 提供 PDF 解析能力。

功能

  • PDF 解析: 将 PDF 转换为 Markdown 格式
  • 公式识别: 支持 LaTeX 公式提取
  • 表格识别: 自动识别并转换表格结构
  • OCR: 支持图片型 PDF 文字识别
  • 多语言: 支持中文、英文,日文、韩文等

⚠️ 安装前必读

使用本技能即表示:

  1. 你愿意提供你的 MinerU API Token (
    MINERU_TOKEN
    )
  2. Token 会被发送给 https://mineru.net/
  3. 确认 MinerU 服务可信,接受其隐私政策
  4. 已在本地源码中确认无额外意外行为

前提条件

1. 安装依赖

pip install requests

2. 获取 MinerU Token

访问 https://mineru.net/ 注册并获取 API Token。

3. 设置环境变量

Windows (PowerShell):

$env:MINERU_TOKEN = "your-token-here"

macOS / Linux:

export MINERU_TOKEN=your-token-here

支持的引擎

引擎说明
vlmVLM 引擎(默认)
pipeline管道引擎
MinerU-HTMLHTML 输出

快速开始

# 解析 PDF (默认 vlm 引擎)
python scripts/mineru_api.py -f <pdf路径> --wait

# 指定引擎
python scripts/mineru_api.py -f <pdf路径> --engine pipeline --wait

选项

参数说明默认值
-f, --files本地 PDF 文件-
--engine解析引擎vlm
--lang语言 (ch/en/ja/ko)ch
--wait等待解析完成

环境变量

变量必填说明
MINERU_TOKENMinerU API Token

输出

解析结果保存在

~/.openclaw/MinerU_Results/
目录下。

工作流

  1. 设置
    MINERU_TOKEN
    环境变量
  2. 执行解析命令
  3. 等待解析完成
  4. 读取 full.md 分析内容
  5. 根据内容重命名目录