Plugin directory / Automation / dsh-tool-hackernews
dsh-tool-hackernews
Verified · install-tested on dsh tanf1ng
What it does
Hacker News tool suite (hn_top_stories, hn_search, hn_item) for DeepSeek Harness agents
Works — verified, early-stage project
Hacker News tool suite (hn_top_stories, hn_search, hn_item) for DeepSeek Harness agents It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
dsh-tool-hackernews
English | 中文
Hacker News tool suite for DeepSeek Harness (DSH) agents: hn_top_stories, hn_search, and hn_item. Built on the free Algolia HN search API — no API key required.
Tools
| Tool | Args | Behavior |
|---|---|---|
hn_top_stories |
limit (optional, 1–30) |
The current Hacker News front page: titles, links, scores, comment counts, authors, relative times. |
hn_search |
query (required), tag (story/comment/poll/ask_hn/show_hn), since_hours (1–8760), limit (1–30) |
Keyword search over HN, optionally restricted to a tag or to the last N hours. |
hn_item |
id (required), max_comments (0–100) |
One story with a bounded top-level comment tree (HTML stripped, depth-indented) so context stays safe. |
All three tools are read-only and concurrency-safe, so DSH may schedule sibling calls in parallel. Each request carries the deployment's cooperative timeout budget and forwards the caller's AbortSignal.
Install
DSH plugins install into a profile via dsh plugin (pnpm under the hood). From this GitHub repository:
dsh plugin --profile <name> add "github:tanf1ng/dsh-tool-hackernews"
Or from a local checkout with pnpm:
pnpm install
pnpm build
# then in the profile that should load it:
dsh plugin --profile <name> add "file:../../dsh-tool-hackernews"
Enable the plugin in the profile's cordis.patch.yml (or a product bundle):
- id: tool-hackernews
name: dsh-tool-hackernews
Config
All keys optional:
| Key | Default | Meaning |
|---|---|---|
registerTopStories |
true |
Register hn_top_stories. |
registerSearch |
true |
Register hn_search. |
registerItem |
true |
Register hn_item. |
topStoriesLimit |
10 |
Default result bound for hn_top_stories. |
searchLimit |
8 |
Default result bound for hn_search. |
maxComments |
20 |
Default comment bound for hn_item. |
fetchTimeoutMs |
15000 |
Per-request timeout budget (ms). |
Development
pnpm install
pnpm build # tsc -> lib/
pnpm test # smoke test against a stub fetch (no network needed)
The package follows the official DSH tool-plugin pattern: a Cordis plugin (name / inject / Config / apply) that registers defineTool definitions on ctx.tools, with full parameter schemas, canonical output schemas, text renderers, and presentCall UI cards.
License
MIT
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-tool-hackernews for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:tanf1ng/dsh-tool-hackernewsHeadless (CLI) profile:
dsh plugin --profile headless add github:tanf1ng/dsh-tool-hackernewsTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
When to use it
Automate a repetitive job — scheduling, chaining tasks, or reacting to events — so it runs without you starting it.
Who it's for
Users with recurring work who want it cron-style and hands-off rather than manually triggered.
For developers — extending it
Triggers and task templates are the seams — add event-driven or file-watch triggers, and richer workflow composition.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-tool-hackernews/)<a href="https://dshbase.com/plugins/dsh-tool-hackernews/"><img src="https://dshbase.com/badges/dsh-tool-hackernews.svg" alt="dshbase install-tested"></a>