Repolode
deedy5

deedy5/ddgs

一个 Python 元搜索库,统一聚合多个网页搜索引擎的文本、图片、视频、新闻和书籍结果。

可替代:Google Custom Search API

Star
3,024
Fork
287
未关闭 Issue
33
最近提交
2个月前

这是什么?

DDGS 是一个 Python 元搜索库,可将同一查询发送给多个网页搜索服务,并以统一格式返回结果。其 text() 方法支持 Bing、Brave、DuckDuckGo、Google、Mojeek、Startpage、Yandex、Yahoo、Wikipedia 等后端,默认由系统自动选择。

除网页文本外,库还提供 images()、videos()、news() 和 books() 方法,以及 extract() 方法。后者会抓取指定 URL,并将页面转换为 Markdown、纯文本、富文本、原始 HTML 或原始字节。结果以字典列表形式返回,同样的功能也可通过命令行工具使用。

在集成方面,项目提供基于 FastAPI 的 API 服务,包含各类搜索和内容提取接口;还提供通过 stdio 运行的 MCP 服务,可将这些操作作为工具供 Cursor、Claude Desktop 等客户端调用。请求可通过 HTTP、HTTPS 或 SOCKS5 代理发出。

核心功能

  • 01聚合 Bing、Brave、Google、DuckDuckGo 等多个后端的文本搜索结果。
  • 02提供图片、视频、新闻和书籍搜索方法,并支持各类型专用筛选条件。
  • 03可将网页内容提取为 Markdown、纯文本、富文本、HTML 或原始字节。
  • 04提供命令行工具、FastAPI 接口服务和 MCP 服务。
  • 05支持 HTTP、HTTPS 和 SOCKS5 代理,并可配置超时时间。

适用场景

  • 在 Python 应用或 LLM 智能体中加入网页搜索功能,无需付费搜索 API。
  • 为支持 MCP 的 AI 助手提供搜索和网页内容提取工具。
  • 通过可用 Docker 部署的 API 服务,为内部系统提供自托管搜索接口。
  • 在命令行中批量获取搜索结果或网页文本,用于脚本处理。

快速上手

  1. 1

    使用 pip 安装基础包

    pip install -U ddgs
  2. 2

    在 Python 中运行一次文本搜索

    python3 -c "from ddgs import DDGS; print(DDGS().text('python programming', max_results=5))"

使用前须知

  • 结果来自第三方搜索后端,可用性和结果质量取决于这些服务。

标签

常见问题

ddgs 是什么?
一个 Python 元搜索库,统一聚合多个网页搜索引擎的文本、图片、视频、新闻和书籍结果。 DDGS 是一个 Python 元搜索库,可将同一查询发送给多个网页搜索服务,并以统一格式返回结果。其 text() 方法支持 Bing、Brave、DuckDuckGo、Google、Mojeek、Startpage、Yandex、Yahoo、Wikipedia 等后端,默认由系统自动选择。
ddgs 可以免费使用吗?用的什么许可证?
ddgs 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
ddgs 还在维护吗?
半年内有更新。ddgs 最近一次提交是在 2026年8月26日。
ddgs 适合用来做什么?
在 Python 应用或 LLM 智能体中加入网页搜索功能,无需付费搜索 API。 为支持 MCP 的 AI 助手提供搜索和网页内容提取工具。 通过可用 Docker 部署的 API 服务,为内部系统提供自托管搜索接口。 在命令行中批量获取搜索结果或网页文本,用于脚本处理。
ddgs 怎么安装和运行?
使用 pip 安装基础包: pip install -U ddgs 在 Python 中运行一次文本搜索: python3 -c "from ddgs import DDGS; print(DDGS().text('python programming', max_results=5))"
在哪里获取 ddgs?
源代码和安装说明在 GitHub 上:https://github.com/deedy5/ddgs

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目