Skip to content
View Citatra's full-sized avatar
  • Joined Feb 20, 2026

Block or report Citatra

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
Citatra/README.md

Citatra - Open Source AI Visibility Tool

Open-source AI visibility tracking platform. Monitor your brand's presence in Google AI Overviews, track competitors, and analyze sources. Fully self-hostable.

Note: The open-source version is limited to 1 workspace.


πŸš€ Features

Category Features
Core Dashboard, Prompt Tracking, Source Analysis, Competitor Monitoring
Advanced Analytics Traffic Attribution, SoV & Sentiment, Competitive Gap, Backlinks, Historical Performance, SERP + AI Dashboard, Prompt Volumes
Technical Analysis Semantic Map, Schema Generator, HTML Audit, GEO Audit
Tools AI Recommendations, Forecasting, Keyword Explorer
Management CMS Connectors, Team Management, Notifications, Settings

πŸ› οΈ Quick Start

1. Clone & Install

git clone https://github.com/Citatra/Citatra.git
cd Citatra
npm install

2. Configure Environment Variables

cp .env.example .env.local

Edit .env.local and set:

  • MONGODB_URI - MongoDB connection string
  • NEXTAUTH_SECRET - Random secret for JWT signing
  • SERPAPI_API_KEY - SerpApi API key (get one here)

3. Run the App

npm run dev

Visit http://localhost:3000 and create an account.


πŸ§‘β€πŸ’» Contributing

Contributions are welcome! Please open issues or pull requests on GitHub.


πŸ—οΈ Project Structure

src/
	app/                # Next.js App Router
		api/              # REST API endpoints
			workspaces/     # Workspace-scoped API
		dashboard/        # Dashboard pages
		login/            # Auth pages
		signup/
		onboarding/
	components/
		app-sidebar.tsx   # Navigation sidebar
		command-palette.tsx # Command palette (Ctrl+K)
		ui/               # shadcn/ui components
	lib/
		auth.ts           # NextAuth configuration
		mongodb.ts        # Database connection
		serp-api.ts       # SerpApi integration
	middleware.ts       # API middleware
	models/             # Mongoose models

πŸ“š Core API Endpoints

Method Path Description
GET /api/workspaces List workspaces
POST /api/workspaces Create workspace (limit: 1)
GET /api/workspaces/:id/queries List queries
POST /api/workspaces/:id/queries Add query
POST /api/workspaces/:id/queries/:qid/fetch Fetch AI Overview
GET /api/workspaces/:id/stats Dashboard stats
GET/POST /api/workspaces/:id/competitors Manage competitors
GET /api/workspaces/:id/sources Source analysis

⏰ Cron Jobs

Set up a cron to call POST /api/cron/fetch-all on your preferred schedule (e.g., daily at 2 AM UTC) to auto-fetch AI Overviews for all active queries.


🧰 Tech Stack

  • Next.js 16 (App Router, React 19)
  • MongoDB (Mongoose ODM)
  • NextAuth v5 (Credentials auth)
  • SerpApi (serpapi.com) for AI Overview fetching
  • Tailwind CSS v4 + shadcn/ui
  • Recharts (Charts)
  • TypeScript

πŸ“„ License

Citatra Non-Commercial Redistribution License - see LICENSE


πŸ”— Links & Support


Popular repositories Loading

  1. Citatra Citatra Public

    Citatra is an open-source platform for AEO/GEO. Designed for marketers and SEO professionals, it helps you monitor competitors, analyze backlinks, and gain actionable intelligence to optimize your …

    TypeScript 5