dsh-lit-search
Academic literature search, citation and BibTeX tools for DeepSeek Harness and
any agent. One package, three forms: dsh Cordis plugin, standalone CLI, and an
agent skill.
Features
- Merged search — keyword search across Crossref, OpenAlex and Semantic
Scholar, deduplicated by DOI, with title/authors/year/venue/citation counts.
Filter by publication year (--from/--to) and sort by citations, date or
relevance (--sort). - Citation formatting — GB/T 7714 (default, for Chinese theses), GB/T 7714
numeric ([1]-style,gbt7714-numeric), APA, BibTeX. - Batch BibTeX — generate a combined
.bibfor a list of DOIs, with the
failed DOIs reported separately. - Related works — related papers for a DOI via OpenAlex
related_works.
Usage
1. dsh plugin
dsh plugin add dsh-lit-search
Registers four agent tools: lit_search, lit_cite, lit_bib, lit_related.
2. Standalone CLI
npx dsh-lit-search search "attention is all you need" -n 5
npx dsh-lit-search search "moe" --from 2024 --sort date
npx dsh-lit-search cite 10.1038/nature14539 -s bibtex
npx dsh-lit-search cite 10.1038/nature14539 -s gbt7714-numeric
npx dsh-lit-search bib 10.1038/nature14539 10.48550/arXiv.1706.03762
npx dsh-lit-search related 10.1038/nature14539 -n 5
All commands print human-readable text by default; pass --json before the
subcommand (e.g. npx dsh-lit-search --json search "transformers") for
machine output. Exit codes: 0 success, 1 business error, 2 usage error.
3. Agent skill
Copy skill/ into ~/.agents/skills/dsh-lit-search/ (or your agent's skill
directory). The skill tells the agent to run the CLI above.
Data sources
- Crossref — DOI metadata and works search.
- OpenAlex — works search, citation counts, related works.
- Semantic Scholar — works search, citation counts.
All are free public APIs; no API key required. HTTP goes through a single
layer with a 10s timeout, one retry on 5xx/network errors, and a polite
mailto: User-Agent.
License
MIT
