liustack/modsearch

🥇 The strongest free web search plugin for DeepSeek Harness, and the search bridge for every model without native web access. Free, no signup, no API key. Ask the web or X, get structured JSON evidence. | 🥇 全网最强的 DeepSeek Harness 免费联网搜索插件，免费免注册免 API key。为不能联网的模型补上搜索，问网页或 X，拿回结构化 JSON 证据（搜索、抓取、引用）。

ModSearchとは？

ModSearchは、大規模言語モデル（LLM）チャットアプリ（特にDeepSeek Harness（dsh））に、リアルタイムのウェブ検索、X（Twitter）検索、個別ページの取得機能を追加するプラグインです。これは、無料または低コストの検索バックエンド（Firecrawl、Antigravity CLI、Tavily、Exa、Grok、内蔵のローカルフェッチャー）を連鎖させ、クォータが尽きた場合やリクエストが失敗した場合に自動的に次のバックエンドへフォールバックすることで実現します。

なぜ重要か

多くの一般的なLLM（DeepSeek、GLM、Claudeなど）は、直接のインターネットアクセスなしで動作するため、最新情報の利用が制限されます。ModSearchは、デフォルトのエンジン（Firecrawlのキーレスティアは月1,000無料クレジット）にAPIキーやクレジットカード登録を必要とせず、この機能を復元します。開発者やエンドユーザーは、モデルに最新ニュースを尋ねたり、ブログ記事を要約したり、特定のページを取得したりすることができ、ソースと信頼性メモ付きの構造化JSONレスポンスを受け取れます。

コア機能

機能	説明
デフォルトで無料のウェブ検索	初期設定でFirecrawlのキーレスティア（月1,000無料クレジット）を使用。
自動フェイルオーバー付き複数エンジン	Antigravity CLI、Tavily、Exa、Grok（X）、ローカルフェッチャーを追加可能。クォータやエラー発生時にキーをローテーションし、エンジンを切り替えます。
エンジンごとのキーローテーション	単一エンジンに複数のAPIキーを指定可能。ModSearchはフォールバック前に順番に試行します。
X（Twitter）検索	Grok Buildツールがインストールされている場合、ModSearchはXコーパスをクエリし、一般的なウェブインデックスでは見つからないコンテンツに到達できます。
DeepSeek Harnessへのワンクリックインストール	`npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@<version>` でdshに直接プラグインをインストール。
多くのチャット環境で動作	Claude Code、Codex、Pi、OpenCode、CLI（`modsearch`）でも利用可能。
構造化出力	結果、ソースURL、および集約または低信頼性情報を示す`uncertainty`フィールドを含むJSONを返します。

仕組み（ハイレベルフロー）

モデルに質問します（最新情報が必要な質問やURLを指定）。
ModSearchスキルがリクエストを検出し、最適な利用可能エンジン（Firecrawlから開始）を選択します。
認証、レート制限、クォータチェックを自動処理し、検索またはページ取得を実行します。
生の結果がLLMに返され、LLMが応答を合成し、ソースリストと信頼性メモを追加します。

はじめに

インストール（最短パス）

# DeepSeek Harnessプラグインとしてインストール（最も一般的なユースケース）
npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@5.10.2

または、汎用スキルインストーラーを使用：

npx skills add liustack/modsearch

デフォルトのFirecrawlキーレスエンジンは即座に動作します。アカウントもAPIキーも不要です。

追加エンジンの設定（オプション）

# Antigravity CLI – ブラウザサインインが必要
curl -fsSL https://antigravity.google/cli/install.sh | bash
agy   # サインインして終了

# Tavilyキーを追加（お持ちの場合）
modsearch config set tavily.apiKey <YOUR_TAVILY_KEY>

# Exaキーを追加
modsearch config set exa.apiKey <YOUR_EXA_KEY>

環境変数（TAVILY_API_KEY、EXA_API_KEY、FIRECRAWL_API_KEY）でもキーを設定できます。

基本的な使用方法

インストール後、コマンドを実行する必要はありません。チャットするだけです：

「最新のAIニュースを要約して」 → ModSearchがウェブ検索を実行し、6件の最近の記事を集約し、ソースとuncertaintyメモ付きのJSONを返します。
「Node.jsリリースページのメンテナンスについて何と書いてある？」 → ModSearchがページを取得し、スケジュールを抽出し、テーブルとソースリンク付きで応答します。

テスト用にCLIを好む場合：

modsearch search "AI breakthroughs 2024"
modsearch read_page https://example.com/blog/post

CLIはスキルがバックグラウンドで行うことを反映しています。

設定のハイライト

エンジンの有効/無効 – modsearch config set tavily.enabled false
キーローテーション – 複数キーをカンマ区切りで指定：modsearch config set exa.apiKey key1,key2
セルフホストエンドポイント – エンジンをカスタムURLに向ける：modsearch config set tavily.baseURL https://my-proxy.example.com
セキュリティ – 内蔵SSRFガード、DNSリバインディング保護、プライベートネットワークアドレスのオプションブロック（docs/security.md参照）。

すべての設定は~/.modsearch/config.jsonにパーミッション0600で保存されます。

対象ユーザー

有料検索APIを支払わずに最新情報を必要とするAIエージェントを開発する開発者。
よりリッチなウェブ検索体験を求めるDeepSeek Harnessユーザー。
LLM駆動アシスタント（Claude Code、Codex、Pi、OpenCode）を試している人で、すぐに動作するプラグインが必要な方。

制限と注意点

無料ティアには月間クレジット制限があります（例：Firecrawl 1,000クレジット）。使い切るとModSearchは次のエンジンにフォールバックしますが、全体のスループットは無料クォータの合計に制限されます。
X（Twitter）検索にはGrok Buildツールと有効なX PremiumまたはSuperGrokサブスクリプションが必要です。
リポジトリはプルリクエストを受け付けていません。貢献はイシューまたは個人フォークに限定されます。

詳細情報

インストールガイド – INSTALL.md
CLIリファレンス – skills/modsearch/references/cli.md
エンジン設定 – skills/modsearch/references/configure.md
出力スキーマ – skills/modsearch/references/output-schema.md
セキュリティ詳細 – docs/security.md
デモスクリーンショット – READMEにプラグインの動作を示すものが含まれています。

クイックまとめ

ModSearchはLLMチャットアプリ向けの無料でプラグアンドプレイのウェブ検索レイヤーです。
自動キーローテーションとフェイルオーバー付きの複数の検索バックエンドをバンドルしています。
DeepSeek Harnessへのインストールは単一コマンドで、デフォルトエンジンはユーザー提供の認証情報なしで動作します。
このツールはソースと信頼性情報を含む構造化JSONを返し、信頼性の高いAIアシスタントの構築を容易にします。