Flan246/dsh-lit-search

Academic literature search, citation and BibTeX tools for DeepSeek Harness and any agent (Crossref + OpenAlex). dsh plugin + CLI + SKILL.md.

Project Overview项目介绍

This is an academic literature search, citation and BibTeX tool plugin for DeepSeek Harness, also available as standalone CLI or agent skill. It merges search results from Crossref and OpenAlex, supports multiple citation formats, and generates batch BibTeX from DOIs. Use it for organizing academic literature. No API key required, but API requests have a 10-second timeout.

这是一款面向DeepSeek Harness的学术文献搜索、引用与BibTeX工具插件,同时支持作为独立CLI、Agent技能使用。可聚合搜索Crossref和OpenAlex文献,支持多格式引用生成、批量生成BibTeX,适合整理学术文献,无需API密钥,API请求设置10秒超时。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin add dsh-lit-search

Flan246/dsh-lit-search 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-lit-search

npm version npm downloads GitHub stars license

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

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

上一个 Prev dsh-sparrow 下一个 Next dsh-files-native