privatesearch

privatesearch

privatesearch は、アカウント、API キー、検索サブスクリプションなしでウェブを検索します。DuckDuckGo の公開 HTML エンドポイントにクエリを送信し、検索結果のタイトル、アドレス、抜粋を返します。また、ページを開いて、そこにある文章を読みやすいプレーンテキストとして返すこともできます。コマンドラインから、またはエージェント向けの MCP サーバーとして動作します。

インストール

npx @reneturcios/privatesearch search "trail running shoes"

コンテナイメージを実行することもできます。

docker run -i ghcr.io/cloudcorprecords/privatesearch

コンテナはデフォルトで MCP サーバーとして起動します（下記を参照）。CLI として使うには、CLI 引数を渡してください。

CLI

# Search the web; results print as title / URL / snippet blocks
privatesearch search "composting basics"
privatesearch search "composting basics" --max-results 5 --region uk-en
privatesearch search "composting basics" --json

# Fetch a page as readable text (markup, scripts, and styles removed)
privatesearch fetch-content https://example.com/some/article

privatesearch --version

終了コード：成功時は 0、検索または取得に失敗した場合は 1（エラーには問題の内容が示されます）、使用方法に関するエラーの場合は 2 です。

MCP サーバー

1 つのバイナリで、どちらの形式にも対応します。mcp サブコマンドを実行すると、stdio MCP サーバーが起動します。

npx -y @reneturcios/privatesearch mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "privatesearch": {
      "command": "npx",
      "args": ["-y", "@reneturcios/privatesearch", "mcp"]
    }
  }
}

ツール

ツール	入力	返される内容
search	query（string、必須）、max_results（integer、任意）、region（string、任意、us-en などの DuckDuckGo リージョンコード）	該当する検索結果。それぞれのタイトル、リンク先 URL（リダイレクト用のラッパーは取り除かれます）、抜粋が返されます。
fetch_content	url（string、必須）	ページの読みやすいテキスト。スクリプト、スタイル、ヘッダーの内容を削除し、タグを取り除いて、エンティティをデコードします。

検索では、HTML エンドポイントのレスポンスページにある検索結果ブロックを読み取ります。エンドポイントからブロックが返されない場合、エラーではなく空の結果リストが返されます。取得に失敗した場合（2xx 以外のレスポンス、ホストに到達できない場合）は、ツールエラーとして報告されます。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。