Open-source agentic AI Search Execution Platform. Track AI visibility, find opportunities, and let agents turn signals into prioritized actions and drafted fixes across ChatGPT, Claude, Gemini, Google AI Overviews, Google AI Mode, Perplexity, Grok, and Microsoft Copilot.
TypeScript aeoai-agentai-searchanswer-engine-optimizationbrand-monitoringchatgptclaudecopilotdockergeminigeogoogle-ai-overviewsgrokmcpnextjsopen-sourceperplexityseosupabasetypescript
# =============================================================================
# AEO Platform — Environment Variables
# Copy this file to .env.local and fill in your values
# =============================================================================
# -----------------------------------------------------------------------------
# Supabase
# Get these from: https://supabase.com/dashboard/project/YOUR_PROJECT/settings/api
# -----------------------------------------------------------------------------
NEXT_PUBLIC_SUPABASE_URL=https://xxxxxxxxxxxxxxxxxxxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
# -----------------------------------------------------------------------------
# AI API Keys (users can provide their own)
# -----------------------------------------------------------------------------
OPENAI_API_KEY=sk-...
GOOGLE_GEMINI_API_KEY=AIza...
ANTHROPIC_API_KEY=sk-ant-...
# -----------------------------------------------------------------------------
# Agent (in-product BYOK)
# -----------------------------------------------------------------------------
# Cloud customers paste their own AI provider keys in Settings › AI
# Providers. We encrypt them at rest with AES-256-GCM; this is the master key. Must be a
# 32-byte (256-bit) value, base64-encoded.
# Generate one: `openssl rand -base64 32`
# Self-host instances can skip this — they use ANTHROPIC_API_KEY directly.
ANSVISOR_ENCRYPTION_KEY=base64-32-bytes-here
PERPLEXITY_API_KEY=pplx-...
GROK_API_KEY=xai-...
# -----------------------------------------------------------------------------
# App
# -----------------------------------------------------------------------------
NEXT_PUBLIC_APP_URL=http://localhost:3000
# -----------------------------------------------------------------------------
# Product analytics (optional — OFF by default for self-hosted)
# -----------------------------------------------------------------------------
# When unset, PostHog is never loaded and no events are sent anywhere.
# Set NEXT_PUBLIC_POSTHOG_KEY to enable funnel / retention analytics. You can
# point it at PostHog Cloud, your own self-hosted PostHog, or any compatible
# endpoint via NEXT_PUBLIC_POSTHOG_HOST. The official cloud deployment uses
# its own PostHog project; self-host users get zero telemetry by default.
NEXT_PUBLIC_POSTHOG_KEY=
NEXT_PUBLIC_POSTHOG_HOST=https://us.i.posthog.com
# -----------------------------------------------------------------------------
# Cloud / Self-hosted mode
# Set to "true" only for the official cloud deployment.
# Self-hosted instances should leave this unset or "false" — all features
# will be unlocked automatically.
# -----------------------------------------------------------------------------
NEXT_PUBLIC_IS_CLOUD=false
# -----------------------------------------------------------------------------
# Action Center: show "Regenerate tasks" in an action's Tasks tab (AC-004).
# Set to "true" together with the server's ACTION_TASKS_AI.
# -----------------------------------------------------------------------------
NEXT_PUBLIC_ACTION_TASKS_AI=
# -----------------------------------------------------------------------------
# Content Editor Quality (Drive quality spec): which phase is live, 0 (unset)
# for none. 1 shows Instructions › Quality and the header's Quality chip.
# 2 adds the AI checks, starting with the site type picked in the editor
# (CE-056); set the server's CONTENT_QUALITY_PHASE to the same value, so the
# Content Agent is told it too. 3 weighs the checks by the page's type (a
# product page has no author, a comparison wants balance; CE-052).
# -----------------------------------------------------------------------------
NEXT_PUBLIC_CONTENT_QUALITY_PHASE=
# -----------------------------------------------------------------------------
# Chat: the new Chat (Drive Chat specs, CHAT-00…25), off unless "true".
# Off, today's /dashboard/agent stays as it is. Read by server code at
# request time (not NEXT_PUBLIC_, so never in the browser's code); a change
# applies once the app starts again: a restart when self-hosted, a new
# deployment on Vercel. Set the server's CHAT_AGENTIC and CHAT_AGENTIC_ORGS
# to the same values.
# CHAT_AGENTIC_ORGS: with Chat on, only these organizations (ids,
# comma-separated); empty = every organization.
# With Chat on, a workspace without its own key (own keys: Growth and
# Enterprise, or a Starter key saved before) runs Chat on ANTHROPIC_API_KEY
# above, and each model step draws on its monthly AI budget through the
# server's internal endpoints (CRON_SECRET below).
# -----------------------------------------------------------------------------
CHAT_AGENTIC=
CHAT_AGENTIC_ORGS=
# -----------------------------------------------------------------------------
# AEO Server (backend API)
# -----------------------------------------------------------------------------
NEXT_PUBLIC_API_URL=http://localhost:80
# -----------------------------------------------------------------------------
# Cron / Internal-endpoint secret (cloud only — not needed for self-hosted)
# -----------------------------------------------------------------------------
# Shared secret that authenticates calls from the web layer to the server's
# internal endpoints. Used by:
# - Vercel Cron → /api/cron/daily-tracking
# - Stripe success route → post-checkout tracking trigger
# - MCP layer → content-brief generation (throws if unset)
# Web sends: Authorization: Bearer ${CRON_SECRET}
# Server checks its own CRON_SECRET copy — both values MUST match.
# Generate: openssl rand -hex 32
# CRON_SECRET=
# -----------------------------------------------------------------------------
# Stripe (cloud only — not needed for self-hosted)
# -----------------------------------------------------------------------------
# NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_...
# STRIPE_SECRET_KEY=sk_test_...
# STRIPE_WEBHOOK_SECRET=whsec_...
# STRIPE_STARTER_MONTHLY_PRICE_ID=price_...
# STRIPE_GROWTH_MONTHLY_PRICE_ID=price_...
# Annual prices (a year up front, 20% off twelve months: Starter $470, Growth
# $2,390 — the amounts in web/src/config/plans.ts). Without them the Billing
# page's Annual choice can't be bought.
# STRIPE_STARTER_ANNUAL_PRICE_ID=price_...
# STRIPE_GROWTH_ANNUAL_PRICE_ID=price_...
# The first-month offer with "Buy now": 50% off a monthly plan's first month
# through the SAVE50 promotion code (FIRST_MONTH_OFFER in
# web/src/config/plans.ts). On unless set to `off`; off, every plan button
# and line shows the plain price. End the code in Stripe as well.
# NEXT_PUBLIC_FIRST_MONTH_OFFER=
# -----------------------------------------------------------------------------
# Supabase Service Role Key (cloud only — for Stripe webhooks)
# -----------------------------------------------------------------------------
# SUPABASE_SERVICE_ROLE_KEY=eyJhbGciOi...