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 分