ディレクトリに戻る

dsh-firecrawl

キュレーションリスト掲載メンテナンス: 活発

firecrawl/dsh-firecrawl

Firecrawl バックエンド web_search / web_fetch(ctx.web)

GitHub で見る
$ npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add @firecrawl/dsh-firecrawl

18

スター

6

フォーク

TypeScript

言語

MIT

ライセンス

2026-08-17

作成日

2026-10-21

最終プッシュ

MIT ライセンスのネイティブ dsh プラグイン。`web_search` / `web_fetch` のプロバイダを Firecrawl に置き換え、JS レンダリング・PDF パース・検索/取得挙動の設定を追加します。代償は Firecrawl のクレジット消費と、モデルが選んだ公開 URL への外部取得です。

DSH 統合

ネイティブ実行

作者による申告

安全性監査

未監査

最終検証日

2026-11-10

ライセンス

MIT

01どんなタスクに使えるのか?

  • ローカルの fetch バックエンドを有効にせずに、DeepSeek Harness へ実時間の Web 検索とページ取得を追加する

    Firecrawl API が返す `web_search` の結果と `web_fetch` の本文(markdown または HTML)。JS レンダリング・PDF パース・結果ごとのスクレイプに対応

    `web_fetch` は使いたいが、モデルが選んだ URL を自ネットワークへ直接向けたくない DeepSeek Harness 利用者

  • 検索と取得の挙動(ドメイン・時間フィルタ・プロキシモード・キャッシュ)を profile のパッチファイルで調整する

    `~/.dsh/profiles/web/cordis.patch.yml` のプロバイダ別設定——ソース、件数、スクレイプ深度、プロキシモード、タイムアウト、本文上限

    Firecrawl 呼び出しにドメインの許可/拒否リストやコスト上限を効かせたい、あるいは遅いクライアントレンダリングページを扱いたい運用者

02DeepSeek Harness への導入方法

前提条件

  • pnpm 10 以上(README の “Before you start” に記載)
  • Harness を起動するターミナルで `FIRECRAWL_API_KEY` を export しておくこと
  • DeepSeek Harness 側でモデルプロバイダが設定済みであること

インストール手順

  1. 01

    キーを export する:`export FIRECRAWL_API_KEY="fc-your-key"`

  2. 02

    web profile へインストール:`npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add @firecrawl/dsh-firecrawl`

    $ npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add @firecrawl/dsh-firecrawl

  3. 03

    起動中の Harness プロセスを停止し、`npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web` で起動し直す

    $ npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web

導入成功の確認

  • 合成後の profile 設定を出力し、2 つのプロバイダ固定行と 2 つのプラグイン行を grep で確認する
  • 最新の Web 情報が必要な依頼をエージェントに投げ、トランスクリプトに `web_search` / `web_fetch` のカードが出れば実行済み

ロールバック

  • `npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web remove @firecrawl/dsh-firecrawl` を実行し、Harness を再起動する

03DSH 統合と能力の範囲

DSH 統合ネイティブ実行

ネイティブな dsh プラグイン(`web` profile)。`ctx.web` ケイパビリティシームに `web-search-firecrawl` と `web-fetch-firecrawl` の 2 つのプロバイダを登録し、組み込みの `web_search` / `web_fetch` ツールの応答元を Firecrawl に差し替えます。新しいツールは追加しません。

  • 検索プロバイダ(`/v2/search`)

    モデルが `web_search` に渡すクエリ→`WebSearchResult` の各項目:url・title・snippet、ニュース結果は `publishedAt` 付き

    呼び出しごとに Firecrawl のクレジットを消費する。`scrapeContent` はさらにクレジットとレイテンシを要する
  • 取得プロバイダ(`/v2/scrape`)

    モデルが `web_fetch` に渡す URL→`WebFetchResult`:statusCode・最終 url・markdown(または HTML)本文。`maxBodyChars` で切り詰め

    非 2xx のページもエラーではなく結果として返る
  • URL とリダイレクトのガード

    モデルが選んだリクエスト URL→非 http(s)・長すぎる・資格情報を含む URL は `WEB_INVALID_URL` として、資格情報付きリクエストが送出される前に拒否される

    API リクエストの HTTP リダイレクトは `Location` の宛先に接続する前に拒否される

04誰に向いているのか?使うべきでない場面は?

向いている用途

  • `web_fetch` は使いたいが、モデルが選んだ URL を自ネットワークへ直接向けたくない DeepSeek Harness 利用者
  • Firecrawl 呼び出しにドメインの許可/拒否リストやコスト上限を効かせたい、あるいは遅いクライアントレンダリングページを扱いたい運用者

不向きな用途

  • Firecrawl はモデルが要求した任意の公開 URL に到達できます。プライベートネットワークには届きませんが、自分が選んでいないページも取得します。受け入れられない配備では `web_fetch` を無効のままにするよう README が指示しています。
  • README は `@deepseek-ai/dsh@0.1.0-rc.6` と Node.js `^22.19.0 || >=24.0.0` を対象にしています。DeepSeek Harness は開発者プレビューのため、以降の dsh ではプラグイン側の更新が必要になる場合があります。

05互換性・メンテナンス・セキュリティ上の注意

  • Firecrawl はモデルが要求した任意の公開 URL に到達できます。プライベートネットワークには届きませんが、自分が選んでいないページも取得します。受け入れられない配備では `web_fetch` を無効のままにするよう README が指示しています。
  • README は `@deepseek-ai/dsh@0.1.0-rc.6` と Node.js `^22.19.0 || >=24.0.0` を対象にしています。DeepSeek Harness は開発者プレビューのため、以降の dsh ではプラグイン側の更新が必要になる場合があります。
  • Git からインストールする場合は、profile の workspace ファイルに SHA 固定の `allowBuilds` エントリが必要です(pnpm は Git 依存のビルドスクリプトを既定でブロックします)。キーは更新のたびに変わるため、README は npm 経由を推奨しています。
  • どちらのプロバイダも Firecrawl のクレジットを消費します。`scrapeContent` はクレジットとレイテンシを払って要約を厚くし、`stealth` プロキシはより高いクレジットコストで再試行します。
2026-08-172026-10-21作者は未記載

MIT · GitHub リリース未発行(facts pack の latest_release は null)。README は dsh 0.1.0-rc.6 を対象

06よくある質問

dsh-firecrawl は DeepSeek Harness に新しいツールを追加しますか?

いいえ。`ctx.web` シームに 2 つのプロバイダを登録するだけで、モデル向けツールは追加しません。モデルは従来どおりクエリか URL を渡し、`web_search` / `web_fetch` ツール自体は `@deepseek-ai/dsh-tool-web` に残ります。

基底バンドルで web_fetch が無効なのに、なぜこのプラグインで有効にできるのですか?

基底バンドルの取得バックエンドは SSRF 対策を後段に委ねるローカル HTTP クライアントで、モデルが選んだ URL が私設ネットワークに届く恐れがあります。Firecrawl は自社インフラから取得するため、harness は URL を API に POST して markdown を受け取るだけで、モデルが選んだ接続を開きません。

対応する dsh / Node.js のバージョンは?

README は `@deepseek-ai/dsh@0.1.0-rc.6` と Node.js `^22.19.0 || >=24.0.0` を対象とし、DeepSeek Harness は開発者プレビューのため以降のバージョンではプラグイン更新が必要になり得ると注記しています。

検索が本当に置き換わったか確認する方法は?

`npx --yes @deepseek-ai/dsh@0.1.0-rc.6 --profile web --dump-config` を実行し、`searchProvider: firecrawl`、`fetchProvider: firecrawl`、2 つのプラグイン行を grep します。そのうえで最新 Web 情報が必要な依頼を投げ、トランスクリプトに `web_search` / `web_fetch` のカードが出るか確認します。

検索は残して取得だけ無効にできますか?

`~/.dsh/profiles/web/cordis.patch.yml` に `tool-web` の行を追加し、`config: { fetch: false }` を設定します。`FIRECRAWL_API_KEY` は平文保存されるこのファイルではなく環境変数に置いてください。

08データと出典

  • 作者による申告github.com2204a7ec9cbc…

    It adds no new tools — the model keeps asking for a query or a URL exactly as before, and Firecrawl answers.

  • 作者による申告github.com2204a7ec9cbc…

    They register into the seam; they do not own it, and they register no model-facing tools — those stay with `@deepseek-ai…

このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-10。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。