Configuração: SearXNG (Sidecar)

A ferramenta web_search é roteada através de uma cadeia de motores: Brave → SearXNG → DuckDuckGo → IAsk. Ao executar nossa própria instância do SearXNG, evitamos os limites de taxa de um único motor e quebras de raspagem (scrape), e desbloqueamos categorias exclusivas do SearXNG: science, it, files e music.

Escolha um caminho de configuração do SearXNG:

A. Docker Compose (quando o TomoriBot é executado no Docker)

Use este caminho se você executar o TomoriBot com a pilha do Docker Compose do repositório. Em seguida, execute com o perfil searxng:

docker compose --profile searxng up -d

Isso inicia o serviço searxng junto com o TomoriBot: o bot o acessa em http://searxng:8080/ automaticamente.

Se você executa o TomoriBot diretamente com bun run dev, use o caminho autônomo (standalone) abaixo.

Se estiver usando em produção, defina SEARXNG_SECRET em .env para qualquer string de mais de 32 caracteres (ela tem um padrão automático no ambiente de desenvolvimento).

B. Docker Autônomo (quando executar `bun run dev`)

Primeiro, defina SEARXNG_BASE_URL=http://localhost:8080/ em .env para que o bot saiba onde se conectar.

Então, em vez de executar o TomoriBot diretamente com bun run dev, use bun run launch --searxng. Isso gerencia o ciclo de vida do contêiner automaticamente e espera que o contêiner esteja íntegro (healthy) antes de iniciar o bot:

bun run launch --searxng

Se preferir gerenciar o contêiner você mesmo, mantenha SEARXNG_BASE_URL=http://localhost:8080/ em .env e execute:

PowerShell:

docker run -d --name searxng -p 8080:8080 `
  -v "${PWD}/servers/searxng:/etc/searxng:rw" `
  -e SEARXNG_SECRET=dev-only-not-for-production `
  searxng/searxng:latest

Bash (Linux/macOS):

docker run -d --name searxng -p 8080:8080 \
  -v "${PWD}/servers/searxng:/etc/searxng:rw" \
  -e SEARXNG_SECRET=dev-only-not-for-production \
  searxng/searxng:latest

Em seguida, execute bun run dev assim que o contêiner estiver íntegro (docker ps mostra (healthy)).

C. Sem SearXNG

Deixe SEARXNG_BASE_URL não definido. A cadeia recorrerá para Brave → DuckDuckGo → IAsk.

Quando nenhum sidecar do SearXNG está configurado, o esquema web_search montado não anuncia mais as categorias exclusivas do SearXNG. As categorias comuns (text, image, video, news) ainda aparecem quando o Brave está configurado, e a pesquisa apenas em texto aparece quando somente o fallback MCP do DuckDuckGo/IAsk está disponível.

Ajuste de Resultados de Imagem

Os resultados de imagem do SearXNG são validados com HEAD, opcionalmente compactados e postados como anexos do Discord: uma experiência do usuário (UX) idêntica às imagens do Brave. Se todos os URLs candidatos falharem na validação, o SearXNG retornará uma lista de texto de links de imagens em vez de uma falha grave (hard failure).

Variável	Padrão	Descrição
`SEARXNG_IMAGE_COUNT`	`3` (máx. 10)	Quantas imagens válidas são enviadas ao Discord. Substituído pelo argumento `count` do LLM.
`SEARXNG_IMAGE_POOL`	`10`	Conjunto de URLs candidatos quando o LLM não especifica `count`. Quando `count` é especificado, o conjunto é `count × 3` (limitado a 30) para absorver falhas de proteção contra hotlink.
`IMAGE_MIN_SIZE_BYTES`	`5120` (5 KB)	Imagens abaixo desse tamanho são rejeitadas: filtra imagens de erro/placeholder. Compartilhado com a pesquisa de imagens do Brave.
`WEB_SEARCH_TIMEOUT_MS`	—	Tempo limite de solicitação por motor.
`WEB_SEARCH_HEALTHCHECK_CACHE_SEC`	`60`	Por quanto tempo o resultado da verificação de integridade fica em cache antes de ser verificado novamente.

(Veja .env.optional.example para todas as opções ajustáveis.)