Skip to content

docs+skill: add searxng-search optional skill and documentation#20841

Merged
kshitijk4poor merged 1 commit into
mainfrom
feat/searxng-search-provider
May 6, 2026
Merged

docs+skill: add searxng-search optional skill and documentation#20841
kshitijk4poor merged 1 commit into
mainfrom
feat/searxng-search-provider

Conversation

@kshitijk4poor

Copy link
Copy Markdown
Collaborator

Closes the remaining gaps from #11562 that were not covered by the core SearXNG integration in #20823.

What this adds

The core SearXNG code (provider class, dispatch, availability checks, tests, OPTIONAL_ENV_VARS, hermes tools picker) already landed in #20823. This PR is purely the additive scaffolding that was unique to #11562.

Addition Notes
optional-skills/research/searxng-search/SKILL.md Installable skill — curl usage, category/engine params, Python example, fallback detection flow
optional-skills/research/searxng-search/scripts/searxng.sh Helper script for health checks and quick queries
website/docs/user-guide/configuration.md Web Search Backends section updated: 5 backends, SearXNG row in table, per-capability split config example, correct search-only note (does NOT say 'falls back to Firecrawl' — that was the old #11562 behavior, superseded by #20823's clear error)
website/docs/reference/environment-variables.md SEARXNG_URL row added after TAVILY_API_KEY
website/docs/reference/optional-skills-catalog.md searxng-search entry alongside duckduckgo-search

Credits (from #11562)

@w4rum, @nathansdev, @moyomartin, @0xMihai, @nicobailon, @searxng-fan, @Local-First

Ref: #11562 #20823 #19198

Closes the remaining gaps from PR #11562 that weren't covered by the
core SearXNG integration landed in #20823.

- optional-skills/research/searxng-search/ — installable skill with
  SKILL.md (curl-based usage, category support, Python example) and
  searxng.sh helper script for health checks and instance queries
- website/docs/user-guide/configuration.md — SearXNG added to the
  Web Search Backends section (5 backends, backend table, per-capability
  split config example, correct search-only note)
- website/docs/reference/environment-variables.md — SEARXNG_URL row
- website/docs/reference/optional-skills-catalog.md — searxng-search entry

The core SearXNG code, OPTIONAL_ENV_VARS, hermes tools picker, and tests
were already on main via #20823.  This commit is purely additive docs +
the optional skill scaffold.

Credits from #11562 salvage:
  @w4rum — original _searxng_search structure
  @nathansdev — tools_config.py integration
  @moyomartin — category support and result formatting
  @0xMihai — config/env var approach
  @nicobailon — skill and documentation structure
  @searxng-fan — error handling patterns
  @Local-First — self-hosted-first philosophy and docs
@kshitijk4poor kshitijk4poor merged commit 94016dd into main May 6, 2026
7 of 9 checks passed
@kshitijk4poor kshitijk4poor deleted the feat/searxng-search-provider branch May 6, 2026 17:16
@alt-glitch alt-glitch added type/docs Documentation improvements comp/tools Tool registry, model_tools, toolsets tool/web Web search and extraction P3 Low — cosmetic, nice to have labels May 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/tools Tool registry, model_tools, toolsets P3 Low — cosmetic, nice to have tool/web Web search and extraction type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants