convez.ai
AgenteIntegração & APIsIntermediário
furkankaynak

SearXNG Plugin para Agentes de IA

furkankaynak/searxng-plugin

Busca web privada e ilimitada para agentes de IA — zero APIs, zero limites

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin que integra uma instância SearXNG auto-hospedada em agentes de IA (Claude Code, Cursor, OpenCode, Codex), oferecendo busca web semântica ilimitada sem APIs externas, rate limits ou rastreamento. Inclui skill de busca local e subagente de expansão de queries para resultados mais relevantes.

Instalação

$npx convez-ai furkankaynak/searxng-plugin

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Integrar busca web privada em Claude Code, Cursor ou OpenCode
  • Evitar rate limits e custos de serviços de busca terceirizados
  • Pesquisa semanticamente expandida com subagent local

Veredito

Solução prática e bem-documentada para quem quer desacoplar busca web de provedores terceirizados. Requer SearXNG já rodando, mas oferece verdadeiro controle total sobre privacidade e escala em ambientes self-hosted.

README

A tradução para o português deste README ainda está na fila.

searxng-plugin

Self-hosted, unlimited, private web search for AI coding agents.

Give Claude Code, Cursor, OpenCode, Codex, and Antigravity a local SearXNG search engine — zero API keys, zero rate limits, zero third-party tracking.


The problem

Every major AI coding agent needs web search, but every built-in option has a catch:

OptionWho sees your queriesRate limitCostAPI key needed
Claude Code WebSearch (built-in)AnthropicPlan‑based token budget$20–200/mo planN/A
OpenCode websearch (built-in)Exa AI cloud1 000 req/mo free tier$7/1k after freeNo (free) / Yes (paid)
Exa Search MCPExa AI cloud1 000 req/mo free tier$7/1k requestsYes
Brave Search MCPBrave cloud5 000 req/mo free credit$5/1k after creditYes
Tavily MCPTavily / Nebius cloud1 000 credits/mo free$0.008/creditYes
searxng-pluginyour own machineunlimitedfreenone

How it works

  SearXNG ──→ MCP Server  ──→ searxng-plugin ──→ Your agent
  (your host)    (@anthropic/     (web-search-local      (Claude Code,
                  searxng-mcp)     skill + semantik-web    Cursor, OpenCode,
                                   subagent)               Codex, …)
  1. You already have (or set up) a SearXNG instance — a meta‑search engine that aggregates ~247 sources.
  2. The plugin wires that instance into your AI coding agent via the standard MCP protocol.
  3. The bundled web-search-local skill ensures every web search goes through your instance.
  4. The semantic-web subagent expands vague queries into 4–7 sharper searches for better results.

What you get

ArtifactWhat it does
web-search-local skillRoutes all web searches through your SearXNG instance
semantic-web subagentContext‑aware query expansion for broader, smarter discovery
SearXNG MCP configPre‑built MCP configuration for every supported platform

Quick start (30 seconds)

# Install with skills.sh (recommended — works on any MCP agent)
npx skills add furkankaynak/searxng-plugin

That's it. The skill is placed into .agents/skills/web-search-local/ and your agent discovers it automatically.

Manual install

Clone, build, and install for one or all platforms:

git clone https://github.com/furkankaynak/searxng-plugin.git
cd searxng-plugin

# (Optional) point to your SearXNG instance
npm run configure -- --url http://myhost:8888

# Build platform bundles
npm run build

# Install for your agent
node scripts/install.mjs --platform claude-code
node scripts/install.mjs --platform cursor
node scripts/install.mjs --platform opencode
node scripts/install.mjs --platform codex
node scripts/install.mjs --platform antigravity

# Or all at once
node scripts/install.mjs --platform all

Install a specific scope

# Global / user-level install (e.g. ~/.claude/)
node scripts/install.mjs --platform claude-code --scope global

# Preview what would happen
node scripts/install.mjs --platform claude-code --dry-run

Supported platforms

PlatformSkillSubagentMCPFormat
Claude Code✅✅.mcp.jsonPlugin bundle
Cursor✅✅mcp.jsonPlugin bundle
OpenAI Codex✅✅ (TOML).codex/config.tomlPlugin bundle
OpenCode✅✅opencode.jsonProject layout
Antigravity (Gemini CLI)✅——Agent Skills
Any MCP‑compatible agent✅—.mcp.jsonAgent Skills

Configuring the SearXNG URL

Your SearXNG instance might not be at http://localhost:8888. Change it with one of these methods (highest priority first):

# 1. CLI flag (single build)
npm run build -- --url http://mysearxng:4000

# 2. Environment variable (single build)
SEARXNG_URL=http://mysearxng:4000 npm run build

# 3. Config file (permanent)
npm run configure -- --url http://mysearxng:4000
npm run build

Smart merging

When you install, shared config files are merged, not overwritten:

FileBehavior
.mcp.json, mcp.jsonDeep‑merge mcpServers — existing servers are preserved
opencode.jsonDeep‑merge mcp key, append to plugin array
config.tomlAppend [mcp_servers.searxng] if not already present
Everything elseNormal copy

Use --no-merge to overwrite instead:

node scripts/install.mjs --platform claude-code --no-merge

Why not just use Exa / Brave / Tavily?

NeedThose servicessearxng-plugin
Monthly cost$5–200+ depending on volume$0
Rate limit500–5 000 req/mo free tierUnlimited
Data sovereigntyYour queries go to a third‑party APIYour machine, your data
API keyAlways required (except OpenCode free)None
Index breadthSingle engine (Brave, Exa, …)~247 engines via SearXNG
Offline capableNoYes (if SearXNG is on‑prem)

Project structure

src/                              # Canonical source (edit these)
  skills/web-search-local/        #   SKILL.md
  agents/                         #   semantic-web.md
  mcp/                            #   MCP config templates
scripts/                          # Build, configure, install tools
  build.mjs                       #   src/ → platform bundles
  configure.mjs                   #   SearXNG URL configuration
  install.mjs                     #   Deploy bundles to agent (with merge)
plugin.config.json                #   Default SearXNG URL
.agents/skills/web-search-local/  # Universal discovery path (skills.sh)
claude-code/                      # Generated platform bundles
cursor/
codex/
opencode/
antigravity/
agent-skills/

Development

# Edit sources in src/, then rebuild
npm run build
node scripts/install.mjs --platform <name> --dry-run
node scripts/install.mjs --platform <name>

License

MIT

Ver o original no GitHub

Bom para

Relacionados