.env.example

# ═══════════════════════════════════════════════════════════════════
# Topic Watch — environment variables
# Copy to .env and fill in the values you need.
# Lines starting with # are ignored. No quotes needed around values.
# ═══════════════════════════════════════════════════════════════════

# ── SearXNG ──────────────────────────────────────────────────────
# SearXNG enables web/social search queries.  OPTIONAL -- if unset,
# all web queries are skipped; Google News RSS, direct RSS and
# Twitter/X will still be collected.
#
# Three deployment options (pick one):
#   A) Local Docker (recommended if Docker is already on your VPS):
#        docker compose up -d searxng
#        SEARX_BASE=http://127.0.0.1:8889
#   B) Public SearXNG instance (no install, but may be rate-limited):
#        SEARX_BASE=https://searx.be
#   C) Disabled -- leave empty or remove the variable:
#        SEARX_BASE=
SEARX_BASE=

# ── Telegram ────────────────────────────────────────────────────────
# Create a bot via @BotFather, then add it to your channel/group.
# Get CHAT_ID: send a message and call getUpdates via the API.
TELEGRAM_BOT_TOKEN=
TELEGRAM_CHAT_ID=

# ── WhatsApp (Green API) ─────────────────────────────────────────────
# Sign up at https://green-api.com (free: 100 messages/day)
# Create an instance, scan QR with WhatsApp, copy the values below.
# CHAT_ID format: 33612345678@g.us (group) or 33612345678@c.us (individual)
GREEN_API_INSTANCE=
GREEN_API_TOKEN=
GREEN_API_CHAT_ID=

# ── Twitter / X ──────────────────────────────────────────────────────
# Get a key at https://twitterapi.io — $0.15 per 1,000 tweets searched.
# Leave empty to skip Twitter/X collection.
TWITTERAPIO_KEY=

# ── Grafana Loki (optional observability) ───────────────────────────
GRAFANA_LOKI_URL=
GRAFANA_LOKI_USER=
GRAFANA_CLOUD_TOKEN=

# ── Digest output directory (optional override) ──────────────────────
# Default: <project_root>/output/cron/
# CRON_OUTPUT_DIR=/path/to/cron/output