Skip to content

Citatra/Citatra

Repository files navigation

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


About

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 visibility on AI search.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages