duckduckgo-search
# DuckDuckGo Search & Fetch
Search the web and fetch URL content using DuckDuckGo (no API key required).
## Prerequisites
需要安装依赖:
```bash
pip3 install duckduckgo-search
```
## 功能
### 1. 网页搜索 (ddg_search.py)
```bash
python3 scripts/ddg_search.py "your search query" [--max-results 10]
```
### 2. 网页抓取 (ddg_fetch.py)
```bash
python3 scripts/ddg_fetch.py "https://example.com" [--timeout 30]
```
## Usage Examples
### 搜索
```bash
# Basic search
python3 scripts/ddg_search.py "OpenClaw AI agent"
# Search with more results
python3 scripts/ddg_search.py "Python best practices" --max-results 15
```
### 抓取网页
```bash
# Fetch a webpage
python3 scripts/ddg_fetch.py "https://openclaw.ai"
# With custom timeout
python3 scripts/ddg_fetch.py "https://example.com" --timeout 15
# Plain text output
python3 scripts/ddg_fetch.py "https://example.com" --format text
```
## Output Format
### 搜索结果 (JSON)
```json
{
"query": "search query",
"count": 10,
"results": [
{
"title": "Result title",
"url": "https://example.com",
"snippet": "Description snippet"
}
]
}
```
### 抓取结果 (JSON)
```json
{
"url": "https://example.com",
"title": "Page Title",
"text": "Extracted readable content...",
"description": "Meta description",
"status_code": 200,
"error": null
}
```
## Integration with OpenClaw
Example workflow
```python
# Search
result = exec({
"command": "python3 /path/to/skills/duckduckgo-search/scripts/ddg_search.py query"
})
# Parse: json.loads(result.stdout)
# Fetch URL
result = exec({
"command": "python3 /path/to/skills/duckduckgo-search/scripts/ddg_fetch.py https://example.com"
})
# Parse: json.loads(result.stdout)
```
标签
skill
ai
