# duckduckgo-search

**Repository Path**: web/duckduckgo-search

## Basic Information

- **Project Name**: duckduckgo-search
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-03
- **Last Updated**: 2026-08-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DuckDuckGo Search API

基于 DuckDuckGo 搜索引擎的 PHP API 接口，允许您通过简单的 HTTP 请求获取搜索结果。

## 功能特性

- 通过 API 接口获取 DuckDuckGo 搜索结果
- 支持自定义地区设置
- 支持时间范围筛选
- 支持限制返回结果数量
- 支持跨域请求（CORS）

## 系统要求

- PHP 5.6+
- cURL 扩展
- DOM 扩展

## 安装部署

1. 将所有文件上传到您的 Web 服务器 服务器需可以访问 `https://html.duckduckgo.com` 所以最好是`香港`或`国外`服务器.如果你的服务器无法访问这个网址需要借助可以访问的服务器搭建`反向代理`来实现
2. 确保 PHP 环境满足上述要求
3. 访问 `index.php` 即可使用

## API 使用方法

### 请求参数

- `q` (必需): 搜索关键词
- `region` (可选): 地区代码，默认为 `cn-zh`（中国） `wt-wt`（全球）
- `timelimit` (可选): 时间限制，可选值：`d`/`day`, `w`/`week`, `m`/`month`, `y`/`year`
- `max_results` (可选): 最大结果数量，默认为 10，最大支持 20

### 示例请求

```bash
# 基础搜索
GET /?q=人工智能

# 带参数的搜索
GET /?q=人工智能最新动态&region=cn-zh&timelimit=w&max_results=10

# POST 请求
POST /
Content-Type: application/x-www-form-urlencoded

q=人工智能&region=cn-zh&timelimit=w&max_results=5
```

### 响应格式

```json
{
  "success": true,
  "query": "人工智能最新动态",
  "region": "cn-zh",
  "timelimit": "w",
  "max_results": 10,
  "results": [
    {
      "title": "标题",
      "href": "https://example.com",
      "body": "摘要信息...",
      "url_display": "显示的URL"
    }
  ],
  "count": 10,
  "timestamp": "2023-01-01T00:00:00+00:00"
}
```

## 错误响应

```json
{
  "success": false,
  "error": "错误信息",
  "timestamp": "2023-01-01T00:00:00+00:00"
}
```

## 重要提醒

1. **法律合规**: 请确保您的使用符合 DuckDuckGo 的服务条款和 robots.txt 文件规定
2. **频率限制**: 请注意不要过于频繁地发起请求，避免被识别为恶意行为
3. **PHP 5.6 安全问题**: PHP 5.6 已停止安全更新，建议在生产环境中使用较新的 PHP 版本
4. **稳定性**: 由于依赖页面抓取，当 DuckDuckGo 更新页面结构时，可能需要调整解析逻辑

## 文件说明

- `DuckDuckGoSearch.php`: 核心搜索类，实现搜索和解析功能
- `index.php`: API 接口入口文件
- `README.md`: 本说明文件

## 开发者

此工具仅供学习和研究目的使用。

## 许可证

MIT License