SNAKE EYES // ZOMBIE TRACKER

"SScammers are buying inactive accounts and fake engagement to bypass filters."

A Metal Gear Solid-themed web application that analyzes X/Twitter accounts for signs of being zombie accounts — dormant profiles that have been compromised and repurposed for spam, scams, or coordinated inauthentic behavior.

---

Features

Core Analysis

• Zombie Detection — Dormancy scoring and activity spike detection to identify compromised accounts
• Fake Engagement Analysis — Detects paid reply networks, bot coordination, and artificial engagement patterns
• AI Authorship Detection — Determines whether account content is human-typed or AI-generated
• Grok AI-Powered — Uses xAI's Grok model (via OpenRouter) for deep behavioral analysis
• Live Profile Intel — Fetches real profile data from X via FxTwitter API and Nitter fallback

Interface

• MGS Codec Aesthetic — Retro Metal Gear Solid-inspired codec screen UI with CRT scanline effects
• Animated 3D Particle System — GPU-accelerated background particle animation
• Horizontal Swipeable Card Carousel — 5 result cards: Overview, Activity, Engagement, AI Check, Verdict
• Mobile Pop-Out Bubble Overlays — Tap any card on mobile to expand it into a full-detail overlay with spring animation
• Typewriter Dialogue System — Codec-style animated text for status messages
• Connect / Disconnect Functionality — Dramatic codec connection/disconnection sequence

Audio

• Background Music — Looping ambient audio (mutable, with volume control)
• Silenced Pistol Sound Effects — Tactical sound cues on interactions
• Audio Controls — Play/pause, mute, volume slider

Mobile Optimized

• Snap-based carousel with hardware-accelerated swipe (Embla Carousel)
• Full-screen expanded card overlays with backdrop blur
• Touch-friendly tap targets (minimum 40×40px)
• iOS and Android compatible

---

Tech Stack

Layer	Technology
Frontend	React 18, TypeScript, Vite
Styling	Tailwind CSS v4, Framer Motion
UI Components	Shadcn/ui, Radix UI
Routing	Wouter
Carousel	Embla Carousel
Backend	Express.js, TypeScript
AI	OpenRouter → xAI Grok
ORM	Drizzle ORM (PostgreSQL-ready)
Icons	Lucide React
Font	Share Tech Mono (Google Fonts)

---

Getting Started

Prerequisites

• Node.js 18+
• An OpenRouter API key with access to x-ai/grok-4.1-fast

Installation

git clone https://github.com/0x404ethsol/SnakeEater_exe.git
cd SnakeEater_exe
npm install

Environment Variables

Create a .env file in the project root (never commit this file):

AI_INTEGRATIONS_OPENROUTER_API_KEY=your_openrouter_api_key_here
AI_INTEGRATIONS_OPENROUTER_BASE_URL=https://openrouter.ai/api/v1

Security note: API keys are only accessed server-side via process.env. They are never exposed to the client/browser.

Running Locally

npm run dev

The app will be available at http://localhost:5000.

---

How It Works

1. Enter an X/Twitter handle in the scan input field
2. The server fetches live profile data from the FxTwitter API (falls back to Nitter)
3. Real profile data + the handle are sent to Grok AI for analysis
4. Grok evaluates the account across 4 dimensions:
   • Dormancy Score (0–100) — How inactive the account has been relative to its age
   • Activity Spike Score (0–100) — Suspicious bursts of activity suggesting account takeover
   • Fake Engagement Score (0–100) — Likelihood of paid replies, bot networks, artificial engagement
   • AI Authorship Score (0–100) — Probability that posts are AI-generated rather than human-written
5. Results are displayed across 5 swipeable cards with a final ZOMBIE / CAUTION / SAFE verdict

---

Project Structure

├── client/
│   └── src/
│       ├── components/
│       │   ├── audio-player.tsx       # Background music + controls
│       │   ├── dialogue-box.tsx       # Typewriter text component
│       │   ├── particle-system.tsx    # 3D animated particle background
│       │   └── results-carousel.tsx   # 5-card swipeable result carousel
│       ├── hooks/
│       │   └── useSoundEffects.ts     # Sound effect management
│       └── pages/
│           └── home.tsx               # Main codec interface
├── server/
│   ├── ai-analyzer.ts                 # Grok AI analysis + profile fetching
│   ├── routes.ts                      # POST /api/scan endpoint
│   ├── storage.ts                     # Storage interface (MemStorage)
│   └── index.ts                       # Express server entry point
└── shared/
    └── schema.ts                      # Drizzle/Zod shared types

---

API

POST /api/scan

Analyzes an X/Twitter account for zombie activity.

Request body:

{
  "username": "elonmusk"
}

Response:

{
  "username": "elonmusk",
  "dormancyScore": 12,
  "activitySpikeScore": 34,
  "isZombie": false,
  "confidence": 85,
  "scanResult": "safe",
  "profileIntel": { ... },
  "fakeEngagement": { ... },
  "aiAuthorship": { ... },
  "grokAnalysis": { ... },
  "scanDate": "Tuesday, March 31, 2026 at 05:45:00 PM"
}

---

Security

• All API keys are stored as server-side environment variables only
• .env files are excluded from version control via .gitignore
• Input is validated with Zod before being passed to the AI
• Helmet.js security headers on all Express responses
• No API credentials are ever bundled into the client-side JavaScript

---

License

MIT — Use freely, fork boldly, track zombies responsibly.

---

"La-Li-Lu-Le-Lo."