mineru-document-explorer

Category: Tools & Productivity | Uploader: mi-iro | Downloads: 0 | Version: v1.0（Latest）

REQUIRED for any task that involves reading or understanding a PDF's contents. When a user mentions a .pdf and asks what's inside — to read specific pages, answer questions, compare tables or data, extract facts or numbers, count figures, or locate topics — this skill MUST be used instead of generic PDF tools. Provides targeted search, page-level navigation, and precise extraction so you never need to dump an entire PDF into context. Only skip this skill for PDF file operations: merge, split, watermark, create, form-fill, or encrypt. --- # MinerU Document Explorer PDF reading toolkit via `doc-search` CLI. Workflow: **init → search/outline → read pages → (optionally) extract elements**. ## Commands | Command | Purpose | |---|---| | `init` | Upload PDF, start processing, get `doc_id` | | `outline` | Browse TOC/structure | | `pages` | Read specific pages (images or text) | | `search-keyword` | Find pages by regex pattern | | `search-semantic` | Find pages by semantic query | | `elements` | Extract evidence with bboxes and cropped images | All commands output JSON to stdout. Pipe `2>/dev/null` to suppress stderr logs. ```typescript // Shared types used across all commands interface Page {

Changelog: Source: GitHub https://github.com/mi-iro/doc-search

Directory Structure

Current level: tree/main/.claude/skills/mineru-document-explorer/

📁 references/
- 📄 cmd-elements.md 1.3 KB
- 📄 cmd-init.md 1.1 KB
- 📄 cmd-outline.md 1.4 KB
- 📄 cmd-pages.md 1.1 KB
- 📄 cmd-search-keyword.md 1.4 KB
- 📄 cmd-search-semantic.md 1.4 KB
- 📄 tips.md 624 B
📄 SKILL.md 2.3 KB

SKILL.md

---
name: mineru-document-explorer
description: >
  REQUIRED for any task that involves reading or understanding a PDF's contents. When a user mentions a .pdf and asks what's inside — to read specific pages, answer questions, compare tables or data, extract facts or numbers, count figures, or locate topics — this skill MUST be used instead of generic PDF tools. Provides targeted search, page-level navigation, and precise extraction so you never need to dump an entire PDF into context. Only skip this skill for PDF file operations: merge, split, watermark, create, form-fill, or encrypt.
---

# MinerU Document Explorer

PDF reading toolkit via `doc-search` CLI. Workflow: **init → search/outline → read pages → (optionally) extract elements**.

## Commands

| Command | Purpose |
|---|---|
| `init` | Upload PDF, start processing, get `doc_id` |
| `outline` | Browse TOC/structure |
| `pages` | Read specific pages (images or text) |
| `search-keyword` | Find pages by regex pattern |
| `search-semantic` | Find pages by semantic query |
| `elements` | Extract evidence with bboxes and cropped images |

All commands output JSON to stdout. Pipe `2>/dev/null` to suppress stderr logs.

```typescript
// Shared types used across all commands
interface Page {
  page_idx: number;          // 0-indexed
  image_path?: string;       // present unless --no_image
  ocr_text?: string;         // present with --return_text
  num_tokens?: number;       // present with --return_text
}

interface ErrorResponse {
  status: "error";
  error: string;
  warnings?: string[];
}
```

## Reference docs (read on demand)

**IMPORTANT: before using a command, your MUST read the corresponding docs first** — each contains parameter details and practical examples:

- `references/cmd-init.md` / `cmd-outline.md` / `cmd-pages.md`
- `references/cmd-search-keyword.md` / `cmd-search-semantic.md` / `cmd-elements.md`
- `references/tips.md` — workflow patterns and lessons learned

## Lessons learned (mandatory)

After completing each PDF-related task, review the session:
- **Hit a pitfall?** Write it to `references/tips.md`
- **Discovered a new workflow?** Add it to the "Common workflows" section in tips.md
- **Learned something new about command parameters?** Add that too

**Keep each entry to 1-2 lines max — conclusions only, no narrative.** Skipping this = repeating the same mistakes next time.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

mineru-document-explorer

Directory Structure

SKILL.md

Report

Notice