Search Engine
Web search via a self-hosted SearXNG instance.
tool name: search_engine
Performs a web search with country, language, recency, pagination, and result-type controls.
The backend is a self-hosted SearXNG instance (ai.searxng_url) — free, no per-query cost.
Results are titles, links and short snippets. When a snippet is not enough, open the result's link with Read URL to read the page itself.
On a connection error or HTTP 403 the SearXNG container is usually down — pair this with Restart Search Engine.
Download from Koris
Run this from the koris repository root:
pnpm hub:pull search-engine
Trusted senders can also download it from chat:
/tools download search-engine
If the plugin is already installed, add --force to overwrite it.
Downloaded files go to plugins/tools/search-engine/
Tools, skills, and MCP servers are downloaded from the main branch.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| query | string | yes | The search query string. |
| num | number | — | Number of results (default: 5, max: 50). |
| start | number | — | Pagination offset (0 = first page, 10 = second page). |
| gl | string | — | Country code (ISO 3166-1 alpha-2), e.g. "br", "us", "de". |
| hl | string | — | Language code, e.g. "pt-br", "en". |
| time_period | stringpast_hour, past_day, past_week, past_month, past_year | — | Recency filter. |
| search_type | stringweb, news, images, video | — | Search type (default: "web"). |