dsh-tool-arxiv

An arXiv preprint search tool for DeepSeek Harness — scaffolded with dshp.

Adds an arxiv_search tool to your agent: search by topic or arXiv ID and get structured results (title, authors, arxiv_id, abstract, abs_url, pdf_url, submit_date). Abstracts only — PDF bodies are never fetched, keeping token usage bounded.

Install

dsh plugin --profile my add dsh-tool-arxiv
dsh --profile my --dump-config   # see the layer land
dsh --profile my                 # boot

Tool signature

| Parameter | Required | Description | |---|---|---| | query | yes | Keywords (any language) or a bare arXiv ID such as 2608.16889 | | category | no | arXiv category filter, e.g. cs.AI; omit for all fields | | max_results | no | Number of papers, default 5, capped at 20 | | sort_by | no | submittedDate (default) or relevance |

Results carry the standing caveat: arXiv preprints are not peer-reviewed.

Configuration

Optional cordis.yml overrides:

- id: tool-arxiv
  config:
    timeoutMs: 15000

Library use

The core is dependency-light and exported for reuse:

import { searchArxiv, buildApiUrl, renderPapers } from 'dsh-tool-arxiv'
const papers = await searchArxiv({ query: 'LLM agent', category: 'cs.AI', maxResults: 5 })

Develop

pnpm install && pnpm build
npx dshp verify          # boot-free composition check
npx dshp dev             # live dev overlay (needs dsh)

License

MIT