Every brand, product, or entity leaves behind a digital footprint 🌐 a complex web of mentions, rankings, connections, and conversations spread across the internet. Meta Scan cuts through that noise ✂️, transforming raw search signals into clear, actionable SEO intelligence 📈.Instead of guessing what works, you gain a precise understanding of why certain pages rank, where visibility is won or lost, and how to turn insights into measurable growth all in one unified view.
It's about understanding your presence in the digital landscape, about seeing 👀 what search engines reveal about you, your competitors, and your opportunities 🔍. Meta Scan delivers a complete SERP analysis 📊, keyword intelligence 🎯, competitor mapping 🏆, and AI-powered recommendations 🤖 all in seconds.
- ⚡ Next.js 16 — Production-grade React framework for fast, scalable web applications
- ⚛️ React 19 — Latest React features with concurrent rendering
- 🧠 TypeScript — Type-safe development for reliability and maintainability
- 🎨 Tailwind CSS v4 — Utility-first styling with modern design primitives
- 📊 Recharts — Composable, responsive data visualizations
- 🤖 Vercel AI SDK — Streaming, AI-first interfaces and model integration
- 🔄 Convex — Real-time backend with automatic APIs and reactive data
- 🔐 Clerk — Secure, full-featured authentication and user management
- 🧠 Google Gemini AI — Advanced AI analysis and reasoning engine
- 🌍 Bright Data — Enterprise-grade web data collection and scraping
- 🛡 Sentry — Application monitoring, performance tracking, and error reporting
- ⚡ Speed to Insight — Generate comprehensive SEO reports in seconds, not hours
- 🤖 AI-Native Architecture — Gemini analyzes and explains data like a human expert
- 📊 Full-Stack Analysis — SERP, keywords, competitors, backlinks, and social signals in one place
- 💬 Interactive Intelligence — Chat with reports and ask follow-up questions (Pro)
- 🎨 Designed for Decision Makers — Clear visuals that drive confident action
- 🔒 Enterprise-Ready — Secure data access powered by Clerk authentication
meta-scan/
├── app/ # Next.js App Router
│ ├── (auth)/ # Authentication routes
│ │ ├── sign-in/
│ │ └── sign-up/
│ ├── (root)/ # Main application routes
│ │ ├── dashboard/ # Dashboard and reports
│ │ ├── pricing/ # Pricing page
│ │ └── page.tsx # Home page
│ ├── api/ # API routes
│ └── layout.tsx # Root layout
├── components/ # React components
│ ├── ui/ # Reusable UI components
│ ├── Summary/ # Report summary components
│ └── Table/ # Data table components
├── convex/ # Convex backend
│ ├── analysis.ts # AI analysis functions
│ ├── scraping.ts # Web scraping functions
│ ├── schema.ts # Database schema
│ └── users.ts # User management
├── lib/ # Utility functions and helpers
│ ├── actions/ # Server actions
│ ├── prompts/ # AI prompts
│ └── schema/ # TypeScript schemas
├── providers/ # React context providers
├── public/ # Static assets
└── types/ # TypeScript type definitions
1️⃣ Clone the Repository
git clone https://github.com/kh-mahmoud/Meta-Scan.git
cd Meta-Scan2️⃣ Install Dependencies
npm install3️⃣ Set Up Environment Variables
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
NEXT_PUBLIC_CLERK_SIGN_IN_FALLBACK_REDIRECT_URL=/
NEXT_PUBLIC_CLERK_SIGN_UP_FALLBACK_REDIRECT_URL=/
CONVEX_DEPLOYMENT=
NEXT_PUBLIC_CONVEX_URL=
CLERK_JWT_ISSUER_DOMAIN=
CONVEX_URL_WEBHOOK=
NEXT_PUBLIC_APP_URL=
SENTRY_AUTH_TOKEN=
BRIGHTDATA_API_kEY=
CLERK_WEBHOOK_SECRET=
DATASET_ID=
GOOGLE_GENERATIVE_AI_API_KEY=4️⃣ Run the Development Server
npm run devEvery signal matters. Every ranking tells a story if you know how to read it. Meta Scan transforms search data into clarity 📊 and confidence 🎯, helping you move faster and smarter.
From insight to strategy. From strategy to momentum.
Give it a ⭐ and join us in building smarter search intelligence.