Tools & Capabilities

dsh-web-search-firecrawl

crayonlu/dsh-web-search-firecrawl · ★ 1

crayonlu

Firecrawl-backed WebSearchProvider for the DeepSeek Harness web capability seam ( ctx.web ). Lets dsh 's web search tool run entirely on Firecrawl (v2 /search ) — no DeepSeek…

Repository Source

License: MIT
Added: 2026-08-23
Maintenance: active
Install kind: github

No manifest check is available; listing does not imply compatibility or security review.

安装

dsh plugin --profile web add github:crayonlu/dsh-web-search-firecrawl

GitHub 源码安装：首次需按提示配置 allowBuilds 构建授权后重试

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: en · Read Chinese README

Table of contents

Install
Configuration
Tests
License

Firecrawl-backed WebSearchProvider for the DeepSeek Harness web capability seam (ctx.web). Lets dsh's web_search tool run entirely on Firecrawl (v2 /search) — no DeepSeek API key required.

Install

dsh plugin --profile web add github:crayonlu/dsh-web-search-firecrawl

Then add the provider to the profile patch layer at $DSH_HOME/profiles/web/cordis.patch.yml (hot-reloaded — no restart needed):

- insert:
  - id: web-search-firecrawl
    name: '@crayonlu/dsh-web-search-firecrawl'
- id: web
  config:
    searchProvider: firecrawl
# Optional: drop the DeepSeek-backed search (and chat route) entirely.
- id: web-search-deepseek
  disabled: true
- id: llm-deepseek
  disabled: true

Configuration

Every field is optional:

Field	Default	Meaning
`apiKey`	—	Literal Firecrawl key (write it here instead of `apiKeyEnv` only if you must; it lands in a config file).
`apiKeyEnv`	`FIRECRAWL_API_KEY`	Credential reference resolved per search through `ctx.credentials` (inherited env > `$DSH_HOME/.credentials.yaml` > project/user `.env`).
`baseURL`	`https://api.firecrawl.dev/v2`	Firecrawl v2 endpoint base; `/search` is appended.
`maxResults`	`5`	Default result count when a request carries no `maxResults`.

The key resolves once per search, so an empty FIRECRAWL_API_KEY fails the request with WEB_MISSING_CREDENTIAL rather than falling through to an unrelated credential.

Tests

npm install
npm test

Unit tests mock the HTTP layer; the smoke test runs a real Firecrawl search when FIRECRAWL_API_KEY is set.

License

MIT

README

Install

Configuration

Tests

License

Related plugins

dsh-weknora

treg

dsh-anchored-standard

Deepseek-Harness-EAC

DSHA-dshapp

deepseek-harness-remote