name: crossref-local
description: |
[WHAT] Offline, zero-API-key DOI lookup + full-text search over the CrossRef corpus.
[WHEN] Use when the user asks to "look up a DOI", "resolve DOI to BibTeX", "find a paper by DOI", "enrich BibTeX with missing fields".
[HOW] import crossref_local then call habanero.Crossref().
tags: [crossref-local]
allowed-tools: mcp__scitex__crossref_*
primary_interface: python
interfaces:
python: 3
cli: 2
mcp: 2
skills: 2
hook: 0
http: 0
crossref-local
Interfaces: Python ⭐⭐⭐ (primary) · CLI ⭐⭐ · MCP ⭐⭐ · Skills ⭐⭐ · Hook — · HTTP —
Local mirror of the CrossRef database with FTS5 full-text search across 167M+ scholarly works — offline, millisecond queries, no rate limits. Also exposes citation networks, per-topic caches, and an HTTP/MCP relay.
Installation & import
pip install crossref-local installs the standalone:
import crossref_local
This package does not ship as a submodule of the scitex umbrella.
Mandatory
- 01_installation.md — pip install + extras + verify
- 02_quick-start.md — search / get / enrich / relay
- 03_python-api.md — Public callables grouped by area
- 04_cli-reference.md —
crossref-localconsole entry
Deep-dive
- 13_configuration.md — env vars, DB vs HTTP mode, relay server
- 14_search.md —
search(),count(),exists(), FTS5 syntax - 15_retrieval.md —
get(),get_many(),enrich(),enrich_dois() - 16_models.md —
Work,SearchResultdataclasses - 05_citations.md —
get_citing(),get_cited(),CitationNetwork - 17_checker.md —
check_citations(),check_bibtex(),check_doi_list() - 07_cache.md — topic caches: create, query, stats, plots, export
- 08_export.md —
save()with json / bibtex / text formats - 09_async.md —
aio.search(),aio.count_many()
Interfaces
- 10_cli.md —
crossref-localCLI (search, check, relay, mcp) - 11_mcp.md — MCP server, tools reference, client config
- 06_http-api.md — FastAPI routes (works, citations, collections, compat)
Environment
- 12_env-vars.md — SCITEX_* env vars read by crossref-local at runtime