SPB Git

Repository Public Research preview

README.md 2.1 KB

# citation-verification

An agent skill for checking references instead of trusting them. It teaches the rule that matters (a DOI must resolve and its registered metadata must match the citation) and ships a command-line tool that applies it to one citation or a whole bibliography.

bash
node scripts/scholarly.mjs verify-bib references.bib --format md --out audit.md
node scripts/scholarly.mjs verify-doi 10.1016/0304-4076(86)90063-1 --title "Generalized autoregressive conditional heteroskedasticity" --year 1986
node scripts/scholarly.mjs retractions --bib references.bib
node scripts/scholarly.mjs help

# What is inside

  • SKILL.md — the rules, the statuses and the workflows (audit a manuscript, add a reference, preprints, retractions, literature search).
  • scripts/scholarly.mjs — the tool. Node.js 20+, no dependency, JSON output.
  • scripts/lib/ — the engine, identical to the one in @spboucher/scholarly-mcp.
  • references/ — thresholds and status definitions, source coverage and limits, report template.

# Requirements

Node.js 20 or newer and network access to Crossref, OpenAlex, arXiv and doi.org. No account. Optional environment variables: OPENALEX_API_KEY, SCHOLARLY_MAILTO, SCHOLARLY_ROOT, SCHOLARLY_TIMEOUT_MS.

# Privacy

Requests carry a generic client name. The titles, DOIs and author names you check are sent to the four services; nothing else is. No contact address is sent unless you set SCHOLARLY_MAILTO yourself.

# Limits

  • Comparisons are string heuristics with documented thresholds; every verdict comes with the claimed and registered values so you can overrule it.
  • Books, theses, reports and many regional journals are poorly covered: expect not_found, which does not mean invented.
  • It cannot tell whether a cited work supports the claim citing it.
  • Without an OpenAlex key, citation-graph commands share a small daily budget per IP address. Verification does not use OpenAlex.
  • Not tested: references in non-Latin scripts, bibliographies above a few dozen entries in one run, BibLaTeX-only constructs such as crossref inheritance and @xdata.

MIT licence.

Files main
Menu

Theme