opencode-web-deepsearch

DuckDuckGo web search tool for OpenCode with deep search capabilities.

Features

• DuckDuckGo Search: Uses DuckDuckGo for web searching (no API key required)
• Deep Search: Iterative search refinement that finds more relevant results
• Content Extraction: Extracts clean text content from web pages
• Source Deduplication: Automatically deduplicates sources by domain
• Raw JSON Output: Returns structured data for AI evaluation

Installation

1. Install Python dependencies

pip install ddgs beautifulsoup4 requests aiohttp lxml

2. Add plugin to OpenCode

The npm package name is opencode-web-deepsearch.

Add to your opencode.json:

{
  "plugin": ["opencode-web-deepsearch"]
}

OpenCode will automatically install the plugin from npm using Bun.

Usage

The tool is available as web-deepsearch in OpenCode.

Arguments

| Argument | Type | Default | Description | |----------|------|---------|-------------| | query | string | required | Search query | | max_sources | number | 3 | Maximum sources to extract | | deep_search | boolean | true | Enable iterative search refinement |

Example

Use the web-deepsearch tool to search for "TypeScript 5.x features"

Or with explicit arguments:

{
  "query": "TypeScript 5.x new features",
  "max_sources": 5,
  "deep_search": true
}

Output Format

{
  "query": "TypeScript 5.x new features",
  "sources": [
    {
      "title": "TypeScript 5.0 - Major Changes",
      "url": "https://example.com/typescript-5",
      "snippet": "TypeScript 5.0 brings...",
      "content": "Full extracted content...",
      "domain": "example.com"
    }
  ],
  "iterations_used": 3,
  "source_count": 5,
  "domain_count": 3
}

Requirements

• Python 3.8+
• ddgs
• beautifulsoup4
• requests
• aiohttp
• lxml

Development

# Install dependencies
pip install ddgs beautifulsoup4 requests aiohttp lxml

# Build TypeScript
npm run build

# Test Python script directly
python3 scripts/WebSearchAgent.py --query "test" --max-sources 1 --deep-search false

# Test with Docker
docker build -f Dockerfile.test -t opencode-plugin-test .
docker run -it opencode-plugin-test bash

Comparison with OpenCode's Built-in Search (Exa)

| Aspect | web-deepsearch | Standard OpenCode (Exa) | |--------|---------------|-------------------------| | API Key | Not required | Optional (for higher limits) | | Cost | Free | Limited free tier | | Code search | Not included | Via get_code_context_exa | | Deep search | Iterative refinement | Not available | | Content extraction | Full page extraction | Via web_fetch_exa | | Latency | Slower (DuckDuckGo) | Faster (Exa API) | | Reliability | Depends on DuckDuckGo | More stable (Exa) |

When web-deepsearch is better:

• You don't have an Exa API key
• You need iterative deep search
• You want a free solution without limits

When Exa is better:

• You need code search (GitHub code search)
• You need faster results
• You have an API key and need higher limits

License

MIT