Flan246/dsh-lit-search

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 .bib for 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

MCP server (Claude Code, Cursor, ChatGPT, ...)

Use dsh-lit-search from any MCP host via the companion package dsh-lit-search-mcp (listed on the official MCP Registry as io.github.Flan246/dsh-lit-search):

claude mcp add lit-search -- npx -y dsh-lit-search-mcp

or in any MCP host's config: "command": "npx", "args": ["-y", "dsh-lit-search-mcp"].