OpenSERP Web Search
When to Use
- You need up-to-date information not in your training data
- Researching a topic, technology, library, or recent event
- Searching for news articles or current affairs
- Finding documentation, tutorials, or code examples
- Looking up anything that benefits from a live web search
Procedure
Run the search script with your query:
./scripts/search "<query>"
Default search (Google, Bing, DuckDuckGo)
./scripts/search "Python asyncio best practices"
Custom engine list
./scripts/search "AI announcements" --engines bing,yandex
Regional search with result limit
./scripts/search "Docker multi-stage build" --engines google,bing --limit 15 --region us
Multi-engine mega search with mode
./scripts/search "golang" --engines google,bing,yandex --mode balanced --limit 20
Filter by domain
./scripts/search "python" --engines google --site python.org --limit 5
Filter by file type
./scripts/search "machine learning" --file pdf --limit 10
Extract page content from top result
./scripts/search "python tutorial" --engines google --limit 1 --extract 1
Options
| Flag |
Short |
Default |
Description |
--engines |
-E |
google,bing,duckduckgo |
Comma-separated engines: google, bing, duckduckgo, yandex, baidu, ecosia |
--mode |
— |
balanced |
Mega mode: balanced, any, fast |
--limit |
-l |
10 |
Maximum results to return |
--format |
-f |
json |
Output format: json or text |
--server |
-s |
— |
OpenSERP instance URL (overrides OPENSERP_URL env) |
--region |
-r |
— |
Region code (e.g. us, uk, de, cn) |
--lang |
-n |
— |
Language code (e.g. EN, DE, RU, ES, fr-FR) |
--date |
— |
— |
Date range in YYYYMMDD..YYYYMMDD format |
--site |
— |
— |
Restrict to a specific domain (e.g. github.com) |
--file |
— |
— |
File extension filter (e.g. pdf, doc) |
--start |
— |
— |
Pagination offset (e.g. 0, 10, 20) |
--extract |
— |
— |
Fetch page content for top N results (1-5) |
--extract-mode |
— |
— |
Extraction strategy: auto, fast, rendered |
Environment Variables
| Variable |
Description |
OPENSERP_URL |
Default OpenSERP instance URL (default: http://localhost:7007) |
1---2name: openserp-search3description: Search the web using a local OpenSERP instance. Use for web searches, finding current information, researching topics, checking news, looking up documentation, or finding recent events. Supports engines: google, bing, duckduckgo, yandex, baidu, ecosia.4---56# OpenSERP Web Search78## When to Use9- You need up-to-date information not in your training data10- Researching a topic, technology, library, or recent event11- Searching for news articles or current affairs12- Finding documentation, tutorials, or code examples13- Looking up anything that benefits from a live web search1415## Procedure1617Run the [search script](./scripts/search) with your query:1819```bash20./scripts/search "<query>"21```2223### Default search (Google, Bing, DuckDuckGo)24```bash25./scripts/search "Python asyncio best practices"26```2728### Custom engine list29```bash30./scripts/search "AI announcements" --engines bing,yandex31```3233### Regional search with result limit34```bash35./scripts/search "Docker multi-stage build" --engines google,bing --limit 15 --region us36```3738### Multi-engine mega search with mode39```bash40./scripts/search "golang" --engines google,bing,yandex --mode balanced --limit 2041```4243### Filter by domain44```bash45./scripts/search "python" --engines google --site python.org --limit 546```4748### Filter by file type49```bash50./scripts/search "machine learning" --file pdf --limit 1051```5253### Extract page content from top result54```bash55./scripts/search "python tutorial" --engines google --limit 1 --extract 156```5758## Options5960| Flag | Short | Default | Description |61|------|-------|---------|-------------|62| `--engines` | `-E` | `google,bing,duckduckgo` | Comma-separated engines: `google`, `bing`, `duckduckgo`, `yandex`, `baidu`, `ecosia` |63| `--mode` | — | `balanced` | Mega mode: `balanced`, `any`, `fast` |64| `--limit` | `-l` | `10` | Maximum results to return |65| `--format` | `-f` | `json` | Output format: `json` or `text` |66| `--server` | `-s` | — | OpenSERP instance URL (overrides `OPENSERP_URL` env) |67| `--region` | `-r` | — | Region code (e.g. `us`, `uk`, `de`, `cn`) |68| `--lang` | `-n` | — | Language code (e.g. `EN`, `DE`, `RU`, `ES`, `fr-FR`) |69| `--date` | — | — | Date range in `YYYYMMDD..YYYYMMDD` format |70| `--site` | — | — | Restrict to a specific domain (e.g. `github.com`) |71| `--file` | — | — | File extension filter (e.g. `pdf`, `doc`) |72| `--start` | — | — | Pagination offset (e.g. `0`, `10`, `20`) |73| `--extract` | — | — | Fetch page content for top N results (1-5) |74| `--extract-mode` | — | — | Extraction strategy: `auto`, `fast`, `rendered` |7576## Environment Variables7778| Variable | Description |79|----------|-------------|80| `OPENSERP_URL` | Default OpenSERP instance URL (default: `http://localhost:7007`) |
varlabz