axm-bib 0.1.0

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

axm-bib

Bibliographic tools: search papers, resolve DOIs to BibTeX, download open-access PDFs.

---

Features

• 🔍 Search — Find papers by title/keywords (Semantic Scholar + CrossRef fallback)
• 📖 DOI → BibTeX — Resolve any DOI to a BibTeX entry (CrossRef)
• 📥 PDF Download — Download open-access PDFs (Unpaywall + arXiv fallback)
• 🤖 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 an open-access PDF
axm-bib pdf 10.48550/arXiv.1706.03762

CLI Options

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	auto	Output directory

MCP Integration

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

• search_paper(query, limit) — Search papers
• doi_to_bibtex(doi) — Resolve DOI
• get_pdf(doi) — Download PDF

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-extras
uv run pytest           # 122 tests, 93% coverage
uv run ruff check src/  # lint

License

Apache License 2.0