openspec-lab/openspec/changes/archive/2026-09-06-tavily-proxy-setup/proposal.md

Why

Web-экстракция в Hermes сломана: SearXNG умеет только search, а для extract не было ни одного рабочего провайдера. Tavily заблокирован в РФ (403 на AWS ELB). Решение — локальный прокси-форвардер, который ходит в Tavily через существующий SOCKS5-туннель до VPS01.

What Changes

• Настроен extract_backend=tavily в конфиге Hermes
• Добавлен TAVILY_API_KEY + TAVILY_BASE_URL в /opt/hermes/.hermes/.env
• Создан скрипт /opt/hermes/.hermes/scripts/tavily_proxy.py — локальный HTTP→SOCKS5 форвардер для одного хоста (api.tavily.com)
• Создан systemd-юнит tavily-proxy.service (порт 8971, автозапуск, рестарт)

Capabilities

New Capabilities

• web-extract-tavily: Веб-экстракция страниц в Hermes через Tavily с обходом региональной блокировки

Modified Capabilities

• (нет)

Impact

• /opt/hermes/.hermes/.env — 2 переменные
• /etc/systemd/system/tavily-proxy.service — новый юнит (enabled)
• /opt/hermes/.hermes/scripts/tavily_proxy.py — новый скрипт