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
docs(server): add backend README (#188)
titanniya542-speca8253bdf5f70
diff --git a/server/README.md b/server/README.mdnew file mode 100644index 000000000..2cc4028fb--- /dev/null+++ b/server/README.md@@ -0,0 +1,87 @@+# Ansvisor Server++The server package runs the Ansvisor backend: an Express API with Socket.IO support and background workers for brand tracking, keyword volumes, content briefs, competitor and topic workflows, and the AI traffic pixel.++It is designed to run alongside the `web/` app during local development and can also run as the production API service for self-hosted deployments.++## Prerequisites++- Node.js 20 or newer+- npm, or Yarn if you prefer using it for package scripts+- A configured Supabase project+- At least one AI provider API key for tracking and content generation++## Setup++Install dependencies from this directory:++```bash+cd server+npm install+```++Create the environment file from the checked-in example:++```bash+cp .env.example .env+```++Then fill in the values required by your deployment. See [`./.env.example`](./.env.example) for the full reference and inline notes.++## Running the Service++For local development, run the nodemon-powered dev server:++```bash+npm run dev+```++You can also run the same script with Yarn:++```bash+yarn dev+```++For production, the package starts `src/server.js` with PM2:++```bash+yarn start+```++The service listens on `PORT`, which defaults to `80`.++## Environment Variables++Use [`./.env.example`](./.env.example) as the source of truth. It groups the required and optional values by purpose:++- Supabase connection values for database, auth, and server-side access+- AI provider keys and default model selections for suggestions and content workflows+- CORS origins for the dashboard API and Socket.IO+- Cloud versus self-hosted mode through `IS_CLOUD`+- DataForSEO credentials for keyword volume data+- Cloro scraper credentials, webhook callback settings, and platform provider selection+- AI volume multiplier configuration+- Stripe secrets for cloud deployments only++## Routes++The server exposes a small public surface plus authenticated API routes:++| Route | Purpose |+| --- | --- |+| `GET /` | Service status, deployment mode, and timestamp |+| `GET /api/health` | Authenticated API health check |+| `/api/prompts` | Prompt sets, prompts, and prompt results |+| `/api/tracking` | Tracking jobs and visibility monitoring |+| `/api/volumes` | Keyword volume lookups and volume-related data |+| `/api/content` | Content opportunities and content brief generation |+| `/api/competitors` | Competitor records and comparison helpers |+| `/api/topics` | Topic grouping and topic-level prompt organization |+| `/api/internal/daily-tracking` | Internal daily tracking trigger protected by `CRON_SECRET` |+| `/api/internal/content/:id/brief` | Internal content brief trigger protected by `CRON_SECRET` |+| `/api/internal/trigger-tracking` | Internal immediate tracking trigger protected by `CRON_SECRET` |+| `POST /cloro/callback` | Public Cloro scraper webhook callback |+| `GET /t.js` | Public AI traffic tracking script |+| `POST /track/:trackingCode` | Public AI traffic pixel ingestion endpoint |++Routes mounted under `/api` are token-authenticated unless they are explicitly listed as internal endpoints protected by `CRON_SECRET`.