web-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Web Search

网页搜索

Web search and content extraction using ddgs — a multi-engine metasearch CLI. No API keys, no signup, no browser required.

使用ddgs——一款多引擎元搜索CLI工具——进行网页搜索与内容提取。无需API密钥，无需注册，无需浏览器。

Setup

安装配置

Install ddgs (run once):

bash

uv tool install ddgs

Install Node.js dependencies for content extraction (run once):

bash

cd {baseDir}
npm install

安装ddgs（仅需运行一次）：

bash

uv tool install ddgs

安装内容提取所需的Node.js依赖（仅需运行一次）：

bash

cd {baseDir}
npm install

Search

搜索功能

bash

{baseDir}/search.js "query"                         # Basic search (5 results)
{baseDir}/search.js "query" -n 10                   # More results
{baseDir}/search.js "query" --content               # Include page content as markdown
{baseDir}/search.js "query" -t w                    # Results from last week
{baseDir}/search.js "query" -t m                    # Results from last month
{baseDir}/search.js "query" -r es-es                # Results in Spanish
{baseDir}/search.js "query" -b google               # Use Google backend
{baseDir}/search.js "query" -n 3 --content          # Combined options

bash

{baseDir}/search.js "query"                         # 基础搜索（返回5条结果）
{baseDir}/search.js "query" -n 10                   # 返回更多结果
{baseDir}/search.js "query" --content               # 包含页面内容（以Markdown格式输出）
{baseDir}/search.js "query" -t w                    # 返回最近一周的结果
{baseDir}/search.js "query" -t m                    # 返回最近一个月的结果
{baseDir}/search.js "query" -r es-es                # 返回西班牙语结果
{baseDir}/search.js "query" -b google               # 使用Google作为搜索后端
{baseDir}/search.js "query" -n 3 --content          # 组合使用多个选项

Options

可选参数

```
-n <num>
```
— Number of results (default: 5)
```
--content
```
— Fetch and include page content as markdown
```
-r <region>
```
— Region code:
```
us-en
```
,
```
es-es
```
,
```
de-de
```
,
```
fr-fr
```
, etc. (default: none)
```
-t <timelimit>
```
— Filter by time:
```
d
```
(day),
```
w
```
(week),
```
m
```
(month),
```
y
```
(year)

-b <backend>

— Search backend:

auto

all

bing

brave

duckduckgo

google

mojeek

yandex

yahoo

wikipedia

(default: auto)

```
-n <num>
```
— 返回结果数量（默认值：5）
```
--content
```
— 抓取并包含页面内容（以Markdown格式输出）
```
-r <region>
```
— 区域代码：
```
us-en
```
、
```
es-es
```
、
```
de-de
```
、
```
fr-fr
```
等（默认值：无）
```
-t <timelimit>
```
— 按时间过滤：
```
d
```
（天）、
```
w
```
（周）、
```
m
```
（月）、
```
y
```
（年）

-b <backend>

— 搜索后端：

auto

、

all

、

bing

、

brave

、

duckduckgo

、

google

、

mojeek

、

yandex

、

yahoo

、

wikipedia

（默认值：auto）

News Search

新闻搜索

bash

{baseDir}/search.js --news "query"                  # News search
{baseDir}/search.js --news "query" -n 10 -t w       # News from last week
{baseDir}/search.js --news "query" --content         # News with full article content

News backends:

auto

all

bing

duckduckgo

yahoo

bash

{baseDir}/search.js --news "query"                  # 新闻搜索
{baseDir}/search.js --news "query" -n 10 -t w       # 返回最近一周的新闻
{baseDir}/search.js --news "query" --content         # 包含新闻全文（以Markdown格式输出）

新闻搜索支持的后端：

auto

、

all

、

bing

、

duckduckgo

、

yahoo

Extract Page Content

提取页面内容

bash

{baseDir}/content.js https://example.com/article

Fetches a URL and extracts readable content as markdown.

bash

{baseDir}/content.js https://example.com/article

抓取指定URL的内容，并提取可读部分以Markdown格式输出。

Output Format

输出格式

Text search

普通搜索结果

text

--- Result 1 ---
Title: Page Title
Link: https://example.com/page
Snippet: Description from search results
Content: (if --content flag used)
  Markdown content extracted from the page...

--- Result 2 ---
...

text

--- 结果1 ---
标题: 页面标题
链接: https://example.com/page
摘要: 搜索结果中的描述内容
内容: （若使用--content参数则显示）
  从页面提取的Markdown内容...

--- 结果2 ---
...

News search

新闻搜索结果

text

--- Result 1 ---
Title: Article Title
Link: https://news.example.com/article
Date: 2026-02-08T10:18:00+00:00
Source: Reuters
Snippet: Article summary...
Content: (if --content flag used)
  Full article as markdown...

--- Result 2 ---
...

text

--- 结果1 ---
标题: 文章标题
链接: https://news.example.com/article
日期: 2026-02-08T10:18:00+00:00
来源: 路透社
摘要: 文章摘要...
内容: （若使用--content参数则显示）
  文章全文的Markdown格式内容...

--- 结果2 ---
...

When to Use

适用场景

Searching for documentation or API references
Looking up facts or current information
News search for recent events
Fetching content from specific URLs
Any task requiring web search without interactive browsing
When no API key is available (unlike Brave Search)

搜索文档或API参考资料
查询事实信息或实时资讯
搜索近期事件的新闻
抓取指定URL的内容
任何无需交互式浏览的网页搜索任务
无法获取API密钥时（如Brave Search需要密钥，而本工具无需）