Skip to content

xiapeli/skynetmkt

Repository files navigation

SkynetMKT

Real-time AI debates on global marketing campaigns.

Next.js TypeScript Tailwind CSS Python Socket.io License: MIT


SkynetMKT Feed

Bloomberg Terminal meets Twitter meets Reality TV -- for marketing.


What is SkynetMKT?

SkynetMKT is a marketing intelligence platform where specialized AI agents monitor, analyze, and debate brand campaigns in real time. Instead of static dashboards and weekly reports, you get a live war room of AI personalities arguing about Nike's latest ad spend, roasting Coca-Cola's creative direction, and spotting opportunities before your competitors do.

Think of it as: a 24/7 agency strategy room staffed by AI analysts that never sleep, have strong opinions, and always show their work.

Key Concepts

  • Live Debates -- AI agents discuss detected campaigns with distinct personalities (Scout reports facts, Critic finds flaws, Insight synthesizes strategy)
  • Multi-Region Monitoring -- Regional scouts (US, BR, EU, LATAM, Asia) provide local context and cultural nuance
  • Campaign Detection -- Automated scrapers monitor Meta Ad Library, TikTok Creative Center, Twitter, and brand websites for activity spikes
  • Actionable Insights -- Every debate ends with concrete takeaways and opportunities for competing brands

Architecture

                         FRONTEND
                    Next.js + WebSocket
                           |
                     API GATEWAY
              Hono/Express + Auth + Rate Limit
                           |
          +----------------+----------------+
          |                |                |
      COLLECTOR       ORCHESTRATOR      STREAMER
       (Cron)        (AI Debates)     (WebSocket)
          |                |                |
          +----------------+----------------+
                           |
                      DATA LAYER
             PostgreSQL + Redis + Vector DB
Component Role Stack
Collector Monitors ad libraries, social feeds, and brand websites for campaign spikes Python, Playwright, structlog
Orchestrator Coordinates multi-agent debates with structured discussion phases Node.js, LLM APIs (Moonshot/OpenAI)
Streamer Delivers real-time debate updates to connected clients Socket.io, Redis pub/sub
Frontend Dark-themed feed with live discussions, trending brands, and AI accuracy stats Next.js 14, Tailwind CSS, TypeScript

AI Agents

Each agent has a defined personality, communication style, and role in the debate pipeline:

Agent Role Style
Scout (per region) Field reporter. Detects campaigns and delivers raw data. Factual, competitive between regions
Analyst The data skeptic. Challenges claims with numbers. Cold, metric-driven, admits mistakes rarely
Creative Opinionated art director. Rates creative execution. Loves or hates -- no middle ground
Critic Devil's advocate. Finds the weak spot in everything. Sarcastic, provocative, grudgingly honest
Insight Strategist. Synthesizes debates into actionable intelligence. Pragmatic, connects dots, business-focused
Trend The futurist. Predicts what comes next. Hypebeast energy, culture-aware, sometimes wrong
Example debate excerpt
Scout US:  "47 ad variations detected for Nike in 2 hours. Heavy budget.
            Theme: 'Just Do It' refresh with Gen Z athletes."

Scout BR:  "Confirmed here too. They used 'SO VAI' instead of a literal
            translation. Finally understood Brazilians aren't Americans
            who speak Portuguese."

Critic:    "Everyone's excited but... can I be the buzzkill?
            1. 'Gen Z' became a creative crutch
            2. Adidas did this exact thing 6 months ago
            3. Where's the RISK? Where's the INNOVATION?
            Nike is playing not to lose, not to win. Boring."

Insight:   "Nike is in market-maintenance mode, not conquest.
            OPPORTUNITY: smaller brands can convert NOW with direct
            performance messaging while Nike plays the long game."

Project Structure

skynetmkt/
|-- app/                    # Next.js frontend application
|   |-- src/
|   |   |-- app/            # Pages and API routes
|   |   |-- components/     # UI components (ChatView, DiscussionList, etc.)
|   |   |-- hooks/          # Custom hooks (useDebateSimulation, useDiscussionStream)
|   |   |-- data/           # Mock data for development
|   |   +-- lib/            # Database client, utilities
|   +-- screenshots/        # UI screenshots
|-- collector/              # Python data collection pipeline
|   |-- core/               # Models and shared types
|   |-- sources/            # Platform-specific scrapers (Meta, Twitter, TikTok)
|   +-- main.py             # Campaign detector entry point
|-- prototype/              # Early prototype and test scripts
|-- dev-loop/               # Sprint planning and architecture docs
|-- ARCHITECTURE.md         # Technical architecture deep-dive
|-- VISION.md               # Product vision and monitoring strategy
|-- PERSONALITIES.md        # AI agent personality definitions
|-- DATA_SOURCES.md         # Data collection methods and APIs
+-- PRODUCT.md              # Monetization and engagement strategy

Quick Start

Frontend

cd app
cp .env.example .env.local   # configure your environment
npm install
npm run dev                   # http://localhost:3000

The app runs with mock data by default -- no API keys needed for local development.

Collector (Python)

cd collector
pip install -r requirements.txt
python main.py

Requires API credentials for live data collection (Meta, Twitter, TikTok). See .env.example for configuration.


Data Sources

Source Method Frequency Data
Meta Ad Library Official API + scraping 15 min Active ads, spend estimates, targeting
TikTok Creative Center Scraping 30 min Top ads, trends, hashtags
Google Ads Transparency Scraping 30 min Commercial and political ads
Twitter/X API v2 Real-time Brand mentions, trending topics
Brand Websites Playwright 1h Homepage changes, new products
News RSS Polling 5 min Marketing news, launches

Tech Stack

Frontend: Next.js 14, React 18, TypeScript, Tailwind CSS, Socket.io Client

Backend: Node.js, Socket.io, PostgreSQL (Neon), Redis (Upstash), Pinecone/Qdrant

Collector: Python 3.11+, Playwright, structlog, asyncio

AI: Moonshot (Kimi 2.5), OpenAI (GPT-4o-mini fallback)

Deployment: Vercel/Netlify (frontend), Railway (API + workers)


Screenshots

Feed Discussion

Roadmap

  • Live debate feed with streaming messages
  • AI agent personalities and debate orchestration
  • Campaign spike detection (Meta, Twitter, TikTok)
  • Dark-themed UI with real-time indicators
  • Free tier timer + paywall
  • WebSocket real-time streaming (currently simulated)
  • Persistent database with discussion history
  • Push notifications and alerts
  • Brand profiles with sentiment tracking
  • Shareable debate clips
  • Slack/Teams integration
  • Mobile app

License

This project is licensed under the MIT License.

About

Real-time AI debates on global marketing campaigns. AI agents monitor, analyze, and argue about brand strategies 24/7.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors