Privatesearch

io.github.CloudCorpRecords由 GitHub 帳號 CloudCorpRecords 發布v0.1.0更新於 Nov 7, 2026

Web search through DuckDuckGo and readable page fetching, no API key needed.

已驗證STDIO僅桌面網頁搜尋與抓取瀏覽器自動化

概覽

AI 產生的概覽

免金鑰即可透過 DuckDuckGo 搜尋網頁並抓取可讀正文，以兩個 MCP 工具在本機提供。

可以做什麼
  • 透過 DuckDuckGo 搜尋網頁，回傳標題、已還原的目標網址與摘要，可選結果數量與地區代碼
  • 抓取網頁並回傳可讀正文，移除腳本、樣式、標頭內容與標籤
適用情境
適合需要讓助理上網查資料或讀取網頁正文，但不想申請搜尋 API 帳號、金鑰或訂閱的情境。
執行需求
以本機 stdio 程序執行，可透過 npx 使用 npm 套件，或使用已發布的容器映像；未宣告帳號、API 金鑰、環境變數或請求標頭。需要能連線 DuckDuckGo 及被抓取的網頁。
安裝前請注意
搜尋字詞與抓取的網址會傳送給 DuckDuckGo 及目標網站，對這些第三方可見。抓取失敗會以工具錯誤回報，而搜尋無結果時回傳空清單而非錯誤。不提供寫入、傳送或刪除類操作。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Privatesearch，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

privatesearch

privatesearch looks things up on the web without an account, an API key, or a search subscription. It asks DuckDuckGo's public HTML endpoint a question and hands back the titles, addresses, and excerpts of what came up, and it can also open a page and return the words on it as plain readable text. It works from the command line or as an MCP server for agents.

Install

bash
npx @reneturcios/privatesearch search "trail running shoes"

Or run the container image:

bash
docker run -i ghcr.io/cloudcorprecords/privatesearch

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

bash
# Search the web; results print as title / URL / snippet blocksprivatesearch search "composting basics"privatesearch search "composting basics" --max-results 5 --region uk-enprivatesearch 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

Exit codes: 0 on success, 1 when a search or fetch fails (the error names the problem), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

bash
npx -y @reneturcios/privatesearch mcp

MCP client configuration:

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

Tools

ToolInputWhat it returns
searchquery (string, required), max_results (integer, optional), region (string, optional, a DuckDuckGo region code such as us-en)The matching results: for each one a title, the destination URL (redirect wrappers are unwrapped), and a snippet excerpt.
fetch_contenturl (string, required)The page's readable text: script, style, and head material removed, tags stripped, entities decoded.

Search reads the result blocks of the HTML endpoint's response page; when the endpoint returns no blocks the result list is empty rather than an error. Fetch failures (non-2xx responses, unreachable hosts) are reported as tool errors.

Development

bash
npm installnpm 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

License

MIT — see LICENSE.

來源：README.md，提交 e0b9700

工具

2

fetch_content

Fetch a web page and return its readable text content.

輸入參數url必填

版本歷史

1
  1. v0.1.0最新Oct 30, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分