reddapidev/dsh-reddit-radar

Plugin插件 ⭐ 143 Docs & Writing文档与写作

A dsh plugin that periodically scans reddapi.dev for new Reddit leads matching your one-sentence ICP, dedupes what you've already seen, and writes a dated markdown report. Also forwards 6 read-only Reddit search/lookup MCP tools.

Project Overview项目介绍

reddapidev/dsh-reddit-radar is a native DSH plugin that periodically pulls B2B lead data from reddapi.dev, which indexes over 30 million Reddit posts and 170 million comments across 50k+ tracked subreddits. To install the plugin, users run npm install @reddapi/dsh-reddit-radar then add the plugin entry to their DSH cordis.yml configuration file. The plugin uses 1024-dimensional semantic embeddings to match leads against a user’s one-sentence ideal customer profile, so it surfaces high-intent leads that match the meaning of the query, not just keywords.

This plugin is built specifically for B2B SaaS marketers and developers that want to generate organic sales leads from Reddit without paying for ad placements or sorting through thousands of low-quality keyword matches. When configured correctly, it runs on a user-specified cadence (hourly, daily, weekly, or manual), filters out any leads that have already been reported, and saves new leads to a dated markdown report in the user’s DSH workspace. It also forwards six MCP tools from reddapi.dev that let the DSH agent query Reddit for leads and subreddit data on demand between scheduled scans.

Free-tier reddapi.dev accounts work with this plugin out of the box, with a shared quota of three requests per 7-day fixed window that resets every Thursday 00:00 UTC. This quota is shared across all scheduled scans, manual tool calls, and the six forwarded MCP tools, so users must align their scan schedule with the number of days scanned to avoid wasting their limited quota. If the API key is rejected, the plugin stops the scheduled scan to avoid repeated failures, but if quota runs out, it simply waits for the next quota window to reset automatically.

这是一个专为DeepSeek Harness(DSH)开发的原生插件,核心功能是根据用户提供的一句话理想客户画像(ICP),定期扫描Reddapi.dev索引的海量Reddit内容,筛选匹配用户需求的B2B SaaS潜在销售线索。它还转发了Reddapi.dev提供的6个只读MCP工具,支持DSH代理按需直接查询Reddit公开数据。插件需要通过npm安装,安装完成后添加配置到DSH的cordis.yml文件即可启用。

该插件面向需要在Reddit获取B2B销售线索的开发者和ToB营销人员,典型工作流为:用户配置好扫描周期(支持每小时、每日、每周或手动触发)、Reddapi.dev API密钥和ICP描述后,插件会按预设周期调用API获取新线索,自动过滤已经报告过的旧线索,最终将符合要求的新线索输出到工作区带日期标记的Markdown报告中。

插件依赖Node.js环境和DSH的Cordis框架,使用免费Reddapi.dev账户即可激活,免费配额为每7天固定窗口3次请求,配额共享给插件扫描和转发的6个MCP工具。需要注意扫描周期必须和扫描天数匹配,否则会重复扫描浪费配额,API密钥错误会停止计划任务,配额用尽则会自动等待下一个周期重置。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

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

CLI Install命令行安装

dsh plugin --profile web add github:reddapidev/dsh-reddit-radar

把 reddapidev/dsh-reddit-radar 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

@reddapi/dsh-reddit-radar

A dsh plugin that periodically scans reddapi.dev for new Reddit leads matching a one-sentence ICP description, drops the ones you've already seen, and writes the new ones to a dated markdown report in your workspace. It also forwards reddapi.dev's six read-only search/lookup MCP tools so the agent can query Reddit on demand between runs.

What it's reading

50K+ subreddits tracked
30M+ posts indexed
170M+ comments indexed
1024D vector dimensions
5 lead types classified

Why this beats a keyword alert

Keyword alerts return thousands of irrelevant mentions and still miss the ones that matter, because people asking for what you sell rarely use your words for it. Nobody writes "I need a Reddit lead-gen tool for B2B SaaS". They write "how do you all find customers without spending on ads".

reddapi.dev matches on meaning, not spelling. Your ICP sentence is embedded into the same 1024-dimensional space as every indexed post, so a post lands in your report when it means the same thing, whether or not a single keyword overlaps. On top of that sits intent scoring: every lead is scored 0-100 on signal strength and auto-tagged with lead type, sentiment and industry, so what reaches your report is the handful of people ready to buy rather than everyone who happened to say a word. The demo set on reddapi.dev's homepage averages a 96% intent score.

That is the whole point of the scheduled scan in this plugin: you write one sentence about who you sell to, and a dated markdown file appears with the people who described that problem this week, in their own words, with a link to reply.

What it does

  • Scheduled lead scan. On a cadence you pick (weekly / daily / hourly / manual), it calls reddapi.dev's /api/v1/leads with your ICP as the query, filters out leads it has already reported, and writes the rest to <outDir>/<date>.md.
  • A manual tool, reddit_radar_run, that runs one pass immediately instead of waiting for the schedule.
  • Six forwarded tools — reddit_semantic_search, reddit_vector_search, reddit_list_subreddits, reddit_get_subreddit, reddit_get_trends, reddit_find_leads — thin shells over reddapi.dev's own MCP endpoint, so the agent can search Reddit directly instead of only seeing scheduled digests.
  • A one-line notice at the start of the next session when a run found new leads, hit a quota wall, or the API key was rejected.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev open-record-replay 下一个 Next dsh-meow-memory →