Loading...
Loading...
Loading...
Verify scholarly references from your terminal. Submit citations, check results, and manage your account — no browser needed.
Works standalone or as part of an AI-assisted research workflow. Submit references, do other work, check results when they're ready. Each verification costs 1 token.
Install globally:
npm install -g sourceverify-cli
Or run without installing:
npx sourceverify verify "Smith, J. (2020). Title. Journal, 1(2), 3-4."
You need a SourceVerify API key. Sign up to get one, then set it in your shell profile:
export SOURCEVERIFY_API_KEY="sk_your_key_here"
Submit references and wait for results. Polls automatically until all results are ready (default 5 minutes).
sourceverify verify "Vaswani, A. et al. (2017). Attention is all you need. NeurIPS."
sourceverify verify --timeout 60 refs.txt
sourceverify verify ref1.txt "Another, A. (2023). Inline ref. Journal, 1, 2-3."
Max 20 references per request. Accepts .txt and .csv files (one reference per line). If it times out, prints job IDs for later checking.
Submit references without waiting. Returns job IDs and a document ID immediately.
sourceverify submit "ref1" "ref2" "ref3"
Check results later with history or results.
Check the status of specific jobs by ID.
sourceverify results abc123 def456
Check your token balance and plan info.
sourceverify balance
Browse past verification results.
sourceverify history # last 20 documentssourceverify history --limit 1 # most recentsourceverify history --limit 5 -v # with parsed fieldsCancel in-progress verifications and get your tokens refunded.
sourceverify cancel abc123 def456
Both verify and submit accept .txt and .csv files. Each non-empty line is treated as one reference.
sourceverify verify refs.txt
sourceverify verify refs.txt "Inline, A. (2023). Extra ref. J., 1, 2."
AI coding agents can use the CLI to verify references without blocking their main task:
# 1. Submit references (instant, non-blocking) sourceverify submit "Vaswani, A. et al. (2017). Attention is all you need. NeurIPS." # 2. Do other work... # 3. Check if results are ready sourceverify history --limit 1
For native MCP integration with Claude Code or Cursor, see the MCP Server docs.
| Status | Meaning |
|---|---|
| VERIFIED | Reference confirmed as accurate |
| VERIFIED WITH ERRORS | Reference exists but has minor inaccuracies |
| NEEDS HUMAN REVIEW | Ambiguous results requiring manual review |
| UNVERIFIED | Could not confirm the reference exists |
Each reference verification costs 1 token. Get tokens with a subscription plan.