deepseekplugins

DeepSeek Harness plugin

litkit-search

DeepSeek Harness (dsh) plugin adapter for litkit — academic literature search, citation audit, and download tools. Root npm package of the polyglot litkit-search monorepo, so `dsh plugin add

Docs & Rendering
Jump to install

Source facts

Repository
bpc-oss/litkit-search
Latest update
Aug 20, 2026
Category
Docs & Rendering
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/bpc-oss/litkit-search
Plugin: litkit-search
Author: bpc-oss

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

litkit-dsh — Unified Academic Literature Search Toolkit

![Python](https://www.python.org/) ![License: MIT](LICENSE) ![GitHub release](https://github.com/bpc-oss/litkit-search/releases) ![CI](https://github.com/bpc-oss/litkit-search/actions)

Search, download, verify, and export scholarly literature from 25+ sources with one CLI. Bulk retrieval with deduplication, citation audit for manuscripts, a multi-strategy PDF download chain, and agent-client integrations (MCP + DSH).

> Distributed on GitHub as litkit-search — import name and CLI stay > litkit-dsh. PyPI publishing is planned.

---

Features

  • 25 academic sources — arXiv, PubMed, Crossref, Semantic Scholar, OpenAlex,

DBLP, IEEE Xplore, Scopus, Web of Science, SSRN, bioRxiv, ChemRxiv, Zenodo, DOAJ, Scite, OpenCitations, ACM, BASE, CORE, Dimensions, Lens, Springer, ORCID, and more. Most work out of the box with zero API keys.

  • Bulk retrieval with deduplication and ranked results.
  • Citation audit (litkit-dsh verify) — check a manuscript's (docx/pdf)

references against the sources.

  • PDF download chain — open-access first, then institutional access, then

browser-assisted and shadow-library fallbacks (see [Legal notice](#legal-notice)).

  • Export to BibTeX / RIS / JSON.
  • Workflows — topic-search, deep-search, bulk-review.
  • Chinese literature search (zh-search).
  • Agent-ready — MCP server for any agent client, plus a DeepSeek Harness

(dsh) plugin adapter.

Quick start

# 1. Install (Python >= 3.11) — GitHub-only distribution (PyPI planned)
pip install "litkit-search @ git+https://github.com/bpc-oss/litkit-search.git"
# or from source: git clone https://github.com/bpc-oss/litkit-search && pip install .

# 2. (Optional) Configure API keys — most sources need none
litkit-dsh sync-keys                   # interactive: point to a keys file

# 3. Search
litkit-dsh search "deep learning drug discovery" --limit 20 --export ris

# 4. Run a citation audit on a manuscript
litkit-dsh verify paper.docx -o report/

# 5. Check your environment
litkit-dsh doctor

See [docs/install.md](docs/install.md) for platform-specific guides (Windows / macOS / Linux) and [docs/configuration.md](docs/configuration.md) for the full configuration reference.

Configuration

  • Zero-key default: arXiv, PubMed, Crossref, Semantic Scholar, OpenAlex,

DBLP, DOAJ, Zenodo, bioRxiv and most other sources work without keys.

  • Optional keys (enable higher rate limits / richer metadata): Scopus, WoS,

OpenAlex, Semantic Scholar, PubMed — configure via litkit-dsh sync-keys or a .env file (copy .env.example and fill in).

  • Institutional access: set INSTITUTIONAL_PROXY / INSTITUTIONAL_DIRECT

in .env to use your university's EZProxy or on-campus/VPN access for publisher PDFs. You are responsible for using only access you are entitled to.

  • Chinese literature (zh-search): requires institutional library access

(e.g. SZU library); see [docs/configuration.md](docs/configuration.md).

CLI overview

CommandPurpose
litkit-dsh searchMulti-source search with dedup
litkit-dsh downloadSearch + download PDFs
litkit-dsh download-supplDownload supplementary materials
litkit-dsh verifyCheck references in a manuscript
litkit-dsh workflow citation-auditCitation audit workflow
litkit-dsh workflow bulk-reviewBulk review by topic
litkit-dsh topic-search / deep-searchResearch expansion
litkit-dsh zh-searchChinese literature search
litkit-dsh sourcesList all 25 sources + status
litkit-dsh exportExport results (BibTeX/RIS/JSON; conversion in progress)
litkit-dsh doctorEnvironment self-check

Agent integration

litkit-dsh speaks MCP, so any MCP-capable agent client can use it:

  • MCP server (litkit-mcp): works with Claude Desktop, Codex, Cursor,

OpenCode, DeepSeek Harness, and others. See [docs/mcp.md](docs/mcp.md).

  • DeepSeek Harness plugin: install the Cordis adapter into any dsh profile.

See [docs/dsh-plugin.md](docs/dsh-plugin.md).

# dsh install (GitHub-only distribution):
dsh plugin --profile web add github:bpc-oss/litkit-search

Legal notice

This project includes download strategies that may access paywalled content:

  • Institutional access: uses your own university credentials/VPN. Only use

access you are entitled to, and respect your institution's terms.

  • Shadow-library fallbacks (Sci-Hub / LibGen / Anna's Archive): included as

a declared, optional download path. Availability varies by network, and accessing paywalled content this way may violate publisher terms or local law in your jurisdiction. Use at your own risk; the maintainers assume no liability. These paths are only engaged as a last-resort fallback and can be disabled via configuration.

Roadmap

  • Full BibTeX/RIS export conversion (litkit-dsh export).
  • More sources and per-source rate-limit tuning.
  • Additional agent adapters and MCP resource/prompt endpoints.
  • Lazily-loaded/opt-in DNS resolution for shadow-library domains.

Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md). Adding a new source? Follow the conventions in [src/litkit-dsh/sources/](src/litkit-dsh/sources/) — each source is a self-contained module registered in the source registry.

License

[MIT](LICENSE) © 2026 bpshil. Changelog: [CHANGELOG.md](CHANGELOG.md).

Back to searchOpen GitHub repository

More related plugins

View category