# paddleocr-doc-parsing

Parses PDFs and images through PaddleOCR and returns text, tables, formulas, charts and reading order. Useful when you need the structure of a report or paper, not just raw text.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 369 installs · ★ 469
- Author: freestylefly
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/freestylefly/canghe-skills/tree/HEAD/skills/paddleocr-doc-parsing/SKILL.md
- Updated: 2026-06-08
- HTML: https://affpapa.org/en/nevibecode/skills/freestylefly-paddleocr-doc-parsing

## What it does

The skill calls the PaddleOCR Document Parsing API through `python scripts/vl_caller.py`. Pass a link with `--file-url` or a local file with `--file-path`; `--file-type` sets the input kind (0 for PDF, 1 for image). By default the raw JSON lands in a temp file and the script prints the path to stderr. Add `--stdout` if you want the JSON in the console and no file written.

The response is an envelope with a `text` field plus the raw `result`. Per-page data lives in `result[n].markdown` and `result[n].prunedResult`, which carries layout, content and confidence. The agent then shows what was asked for: the full text, every table, formulas as LaTeX.

Before the first run you need `PADDLEOCR_DOC_PARSING_API_URL`, `PADDLEOCR_ACCESS_TOKEN` and `PADDLEOCR_DOC_PARSING_TIMEOUT` in the environment, and `python` on the machine. If the API is not configured the script errors out and the skill stops — there is no fallback to the model's own vision, so check the config before pointing it at a document.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add freestylefly/canghe-skills --skill paddleocr-doc-parsing -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/paddleocr-doc-parsing/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/paddleocr-doc-parsing/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add freestylefly/canghe-skills --skill paddleocr-doc-parsing -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/paddleocr-doc-parsing/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add freestylefly/canghe-skills --skill paddleocr-doc-parsing -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/paddleocr-doc-parsing/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install freestylefly/canghe-skills paddleocr-doc-parsing
```

2. **Manually: put the files in place**
- File: `.github/skills/paddleocr-doc-parsing/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add freestylefly/canghe-skills --skill paddleocr-doc-parsing -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/freestylefly/canghe-skills --path skills/paddleocr-doc-parsing
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/paddleocr-doc-parsing/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add freestylefly/canghe-skills --skill paddleocr-doc-parsing -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/freestylefly/canghe-skills/tree/HEAD/skills/paddleocr-doc-parsing/SKILL.md

## When to use it
- pull tables out of an invoice or financial report
- read formulas from a scientific paper
- handle multi-column magazine layouts
- recover reading order on pages with diagrams
- turn scans with stamps into markdown

## Example prompts
- Parse this PDF with paddleocr-doc-parsing and show me every table: `./report.pdf`
- Run paddleocr-doc-parsing on the document and print the full text without headers and footers
- Extract the formulas from this paper with paddleocr-doc-parsing, I need LaTeX

## Similar
- [liteparse](https://affpapa.org/en/nevibecode/skills/liteparse.md) — skill · 4100 installs
- [MinerU Open MCP](https://affpapa.org/en/nevibecode/mcp/mineru-open-mcp.md) — MCP server · ★ 229
- [doc-pipeline](https://affpapa.org/en/nevibecode/skills/doc-pipeline.md) — skill · 4600 installs
- [markitdown](https://affpapa.org/en/nevibecode/skills/julianobarbosa-markitdown.md) — skill · 1600 installs
- [silicon-paddle-ocr](https://affpapa.org/en/nevibecode/skills/silicon-paddle-ocr.md) — skill · 1200 installs
- [nutrient-document-processing](https://affpapa.org/en/nevibecode/skills/nutrient-sdk-nutrient-document-processing.md) — skill · 468 installs

## Other versions with the same name
- [paddleocr-doc-parsing · paddlepaddle](https://affpapa.org/en/nevibecode/skills/paddleocr-doc-parsing.md) — 471 installs

From the same set: [freestylefly/canghe-skills](https://affpapa.org/en/nevibecode/by/freestylefly/canghe-skills.md) — 8 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md