axm-bib 0.2.1

AXM bibliographic tools — DOI resolution, BibTeX retrieval, paper search & PDF download

axm-bib — Bibliographic tools: search papers, resolve DOIs, download & extract PDFs

---

Features

• 🔍 Search — Find papers by title/keywords (Semantic Scholar + CrossRef fallback)
• 📖 DOI → BibTeX — Resolve any DOI to a BibTeX entry (CrossRef)
• 📥 PDF Pipeline — Download, extract, and organize papers in one command
• 📄 Content Extraction — PDF → Markdown + figure PNGs (PyMuPDF)
• 🪃 arXiv Fallback — Direct download from arXiv when Unpaywall has no URL
• 🤖 MCP Integration — Auto-discovered tools via axm-mcp

Installation

uv add axm-bib

Quick Start

# Search papers
axm-bib search "attention is all you need" -n 5

# Resolve a DOI to BibTeX
axm-bib doi 10.1145/363235.363259

# Download, extract & organize a paper (full pipeline)
axm-bib pdf 10.48550/arXiv.1706.03762

Pipeline Output

axm-bib pdf creates a complete paper folder:

~/axm/papers/vaswani2017attention/
├── vaswani2017attention.pdf   # downloaded PDF
├── paper.bib                  # BibTeX entry
├── content.md                 # extracted Markdown
└── figures/
    ├── fig_001.png
    └── ...

Downloaded: ~/axm/papers/vaswani2017attention
  PDF: vaswani2017attention.pdf (1,234,567 bytes)
  BibTeX: paper.bib
  Markdown: content.md (8,432 words, 45,123 chars, 12 pages)
  Figures: 8

CLI Commands

axm-bib search

Option	Default	Description
QUERY	required	Search query (title, keywords)
--limit, -n	5	Max results (1–100)
--abstract/--no-abstract	True	Show paper abstracts
--abstract-len	0 (full)	Truncate abstracts to N chars

axm-bib doi

Option	Description
DOI	Digital Object Identifier to resolve

axm-bib pdf

Option	Default	Description
DOI	required	DOI of the paper
--output, -o	~/axm/papers/	Output directory

Downloads the PDF, extracts Markdown + figures, and writes paper.bib — all in one step. Supports arXiv papers even when Unpaywall has no URL (direct arXiv fallback).

axm-bib extract

Option	Default	Description
PDF_PATH	required	Path to a local PDF file
--output-dir, -o	auto	Output directory
--figures/--no-figures	True	Extract figures as PNG

Standalone extraction for PDFs you already have.

MCP Integration

axm-bib tools are automatically discovered by axm-mcp:

Tool	Description
bib_search	Search papers by keywords
bib_doi	Resolve DOI to BibTeX
bib_pdf	Full pipeline: download + extract + BibTeX
bib_extract	Extract a local PDF to Markdown + figures

Configuration

Variable	Purpose
UNPAYWALL_EMAIL	Email for Unpaywall API (prompted on first use)
S2_API_KEY	Optional Semantic Scholar API key for higher rate limits

Config file: ~/.config/axm-bib/config.toml

Development

git clone https://github.com/axm-protocols/axm-bib.git
cd axm-bib
uv sync --all-groups
uv run pytest           # 173 tests
uv run ruff check src/  # lint

License

Apache License 2.0