A3Boy/dsh-web-tools 预览 preview

A3Boy/dsh-web-tools

用于DeepSeek Harness的多提供商网页搜索与抓取——支持Tavily、Exa、Firecrawl、Brave、You.com、Jina及SearXNG,具备回退机制和原生设置界面。

Project Overview项目介绍

dsh-web-tools is a native plugin built exclusively for DeepSeek Harness (DSH) that adds unified web search and deep content extraction capabilities to DSH agents. It integrates with 10 different providers including 8 general web search APIs plus dedicated support for Xiaohongshu and Twitter/X content retrieval. Instead of flattening all provider capabilities to a lowest common denominator, it parses user search intent through SearchHints and compiles that intent into provider-specific parameters to leverage each engine’s unique capabilities like category filtering, freshness controls, and domain restrictions for improved search accuracy.

DSH agents use this plugin automatically for all standard web_search and web_fetch calls, so users do not need to learn or invoke any new custom tools. It includes multiple resilience features to avoid workflow interruptions: multi-API key pooling, automatic failover for rate limits or auth errors, cooldown windows for rate-limited providers, and support for multiple routing strategies including ordered, round-robin, and random selection. New users get Exa set as the default provider, but you can reconfigure preferences to match your specific use case, from social media discovery to self-hosted metasearch.

The plugin is written in TypeScript and released under the open-source MIT license. To install it for local development, you need to have pnpm installed, run pnpm install to get dependencies, then pnpm run build to compile the bundle into the lib directory. For self-hosted SearXNG users, you must enable JSON output in your SearXNG settings.yml to use the provider, and leave the API key field empty in the DSH plugin settings. Xiaohongshu and Twitter/X use dedicated local browser profiles for authenticated access, and do not export or share cookies with any third parties.

dsh-web-tools 是专为 DeepSeek Harness 开发的原生网页搜索插件,提供统一的网页搜索和网页内容提取能力。它支持接入 Exa、Tavily、Firecrawl、SearXNG 等 8 个搜索服务提供商,还额外支持小红书和 Twitter/X 平台的搜索提取,不会把所有提供商的能力抹平到通用最低标准,而是适配各服务商的原生特性。

当用户需要让 DSH 代理获取最新的网页内容或者特定平台信息时,这个插件可以自动根据搜索意图编译出适配不同提供商的查询参数,同时支持多 API 密钥池、自动故障转移和多种路由策略,避免因单个提供商配额用尽或限流中断任务。适合需要稳定网页检索能力的 DSH 用户使用。

这个插件使用 TypeScript 开发,采用 MIT 开源许可证,使用自托管 SearXNG 需要手动开启 JSON 输出格式才能正常工作。小红书和 Twitter/X 使用本地浏览器配置文件保存登录态,不会导出或分享 cookies。首次使用需要在 DSH 插件面板配置各提供商的 API 密钥。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 34 stars - an early-stage project星标 34,属于早期项目
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:A3Boy/dsh-web-tools

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

READMEREADME

dsh-web-tools

dsh-web-tools

Empower DeepSeek Harness with unified search and deep content extraction across the open web and social platforms.

Native-Capability Adaptation Across 8 Web Providers · SearchHints Semantic Compilation · Multi-Source Resilience · Xiaohongshu & Twitter / X Retrieval

GitHub Stars MIT License DeepSeek Harness TypeScript

English | 简体中文

What problem does it solve?

When web access depends on a single provider, exhausted quota, rate limits, or timeouts can interrupt retrieval. Wrapping multiple APIs with a naive proxy often flattens them to a lowest common denominator, failing to leverage each provider's specialized search modes, categories, freshness, domain rules, and extraction capabilities.

dsh-web-tools connects Exa, Tavily, Firecrawl, Parallel, Brave, You.com, Jina, SearXNG, Xiaohongshu, and Twitter / X to DSH’s standard web_search / web_fetch interface.

While keeping the tool interface unified, dsh-web-tools normalizes search intents through SearchHints and compiles queries into native provider-specific parameters. This leverages each engine's native categories, freshness filters, domain policies, regional targeting, and content extraction, while maximizing uptime through multi-key allocation, automated failover, and dedicated browser profiles.


Key Highlights:

  • Native-Capability Adaptation Across 8 Web Providers: Keeps the standard web_search / web_fetch contracts while compiling unified search intent into provider-specific native parameters instead of reducing every backend to the same lowest-common-denominator feature set.
  • SearchHints → Provider-Specific Parameter Compilation: Normalizes technical, research, news, date, region, and domain constraints from queries, compiling them into provider-native parameters through deterministic code without additional LLM latency.
  • Xiaohongshu & Twitter / X Platform Sources: Both platforms support signed-in native search, detail extraction, and returned comments or replies through dedicated local browser profiles.
  • Multi-Source Scheduling & Resilience: Features multi-API-key pooling, 401 failover, 429 cooldown windows, configurable Ordered / Round-Robin / Random routing, and failover chains.
  • Native DSH Tool Integration: Plugs directly into standard web_search / web_fetch without requiring new tool declarations, and includes a session-level "Search Mode" toggle.

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

← 上一个 Prev dsh-better-edit 下一个 Next dsh-recall-plugin →