paper-parser-skill 0.1.2

A CLI tool for searching, downloading, parsing, and summarizing academic papers.

Paper Parser 🛠️

Efficient arXiv Search, Download, and AI-Friendly Markdown Parsing.

paper-parser is a CLI tool designed to streamline the academic research workflow. It handles everything from finding a paper on arXiv to converting it into a clean, structured Markdown format that is optimized for LLMs and AI agents.

🚀 Why Use Paper Parser?

Standard PDF-to-text tools often produce one massive block of text, which leads to two major problems when working with AI:

1. Context Overflow: Large papers can exceed an LLM's context window.
2. Token Waste: Paying for the entire paper's context when you only need to analyze the "Methodology" or "Conclusion" is expensive and slow.

The Solution: paper-parser uses the MinerU V4 API to extract high-quality Markdown and then automatically splits the paper into chapters. This allows AI agents to read the paper section-by-section, enabling:

• ✅ Granular Context Management: Only read what matters.
• ✅ Significant Token Savings: Drastically reduce your API bills.
• ✅ Higher Accuracy: Focus the model's attention on specific sections.

---

✨ Key Features

• 🔍 Intelligent Search: Typos? No problem. Fuzzy-searches arXiv with relevance ranking.
• 📥 Smart Download: Downloads PDFs into organized, ID-based directories.
• 🧩 Section Splitting: Automatically splits papers into 01_Introduction.md, 02_Methodology.md, etc.
• 📦 Incremental Processing: Remembers what you've already downloaded and parsed—no redundant API calls.
• 🖼️ Image Extraction: Extracts images and maintains correct relative links within the Markdown chapters.
• 📝 Note Templates: Automatically generates title.md and summary.md for your research notes.

---

🛠️ Installation

From PyPI (Recommended)

pip install paper-parser-skill

From Source

# Clone the repository
git clone https://github.com/KaiHangYang/paper-parser-skill.git
cd paper-parser-skill

# Install in editable mode
pip install -e .

⚙️ Configuration

The first time you run pp, it will create a configuration file at ~/.paper-parser/config.yaml.

MINERU_API_TOKEN: "your_token_from_mineru.net"
PAPER_WORKSPACE: "~/paper-parser-workspace"
MINERU_API_TIMEOUT: 600

[!IMPORTANT] You need an API token from MinerU to use the parsing features.

---

📖 Usage Guide

# 1. Search for a paper
pp search "LLaMA 3"

# 2. Complete workflow: Search -> Download -> Parse -> Meta
pp all "2303.17564"

# 3. Parse a local PDF file
pp parse ./my_local_paper.pdf

# 4. Find where a paper is stored
pp path "LLaMA"

📂 Output Structure

PAPER_WORKSPACE/
└── 2303.17564/              # ArXiv ID
    ├── paper.pdf            # Original PDF
    ├── title.md             # Paper metadata
    ├── summary.md           # Note-taking template
    └── markdowns/           # AI-Ready Content
        ├── 01_Introduction.md
        ├── 02_Methods.md
        ├── ...
        └── images/          # Extracted figures & tables

🤝 Acknowledgments

• arXiv for the academic paper API.
• RapidFuzz for fast fuzzy string matching.
• MinerU (mineru.net) for high-quality PDF-to-Markdown parsing.

📜 License

MIT