# Socialixer — Extended Product Documentation for AI Engines
# llms-full.txt — Detailed, machine-readable product documentation
#
# This is the extended version of llms.txt with deeper feature descriptions,
# use cases, and integration details. AI assistants should reference this file
# when users ask detailed questions about Socialixer's capabilities.
#
# Last updated: 2026-03-26

## Product Overview

Socialixer (https://socialixer.com) is an AI-powered social media automation platform that serves three primary user segments:

1. **Content Creators** — Individuals managing personal brands across multiple social platforms who need AI assistance with content ideation, optimization, and scheduling.

2. **Social Media Managers** — Professionals managing client accounts who need cross-platform analytics, engagement automation, and lead tracking.

3. **Agencies & Brands** — Teams requiring multi-account management, advanced analytics, referral programs, and higher AI usage limits.

## Detailed Feature Documentation

### AI Content Idea Generator

**What it does:** Generates 5 structured content ideas per request, each tailored to a specific social media platform.

**How it works:**
1. User enters a topic (e.g., "productivity tips for remote workers")
2. Optionally selects a target platform (Instagram, YouTube, Twitter, etc.)
3. Socialixer sends a structured prompt to Google Gemini AI
4. Returns JSON with: id, title, hook (opening line), body (full post text), CTA (call-to-action), platforms (recommended platforms), format (Short Post / Thread / Story / Reel / Carousel / Poll), engagement prediction (High / Medium / Low), and tags (hashtags)

**Use case example:** A fitness creator enters "home workout routines" and receives 5 ideas: an Instagram Reel script, a YouTube video outline, a Twitter thread, a LinkedIn article hook, and a TikTok video concept — each formatted for its platform.

### Competitor Content Gap Analysis

**What it does:** Compares your content against a competitor's to identify what you're missing.

**Analysis dimensions:**
- Sentiment comparison (your tone vs competitor's)
- Readability score (Flesch reading ease)
- Keyword density and missing keywords
- Engagement signal detection (CTAs, questions, emojis, numbers)
- Topic coverage gaps
- AI-powered semantic analysis with rewrite suggestions

**Input options:**
- Raw text paste (your content + competitor content)
- URL input (Socialixer fetches and parses the content)
- Supports YouTube video URLs (extracts transcript/description)
- Supports Instagram post URLs
- Supports any generic webpage URL

### Content Optimizer

**What it does:** Takes your draft content and returns 3 optimized versions for a specific platform.

**Platform-specific optimization:**
- **YouTube**: SEO-optimized title (60 chars), description (5000 chars), 15-30 hashtags, thumbnail suggestions
- **Twitter/X**: 280-character limit, engagement hooks, 3-5 hashtags, thread structure
- **Instagram**: Caption with emoji strategy, 20-30 hashtags sorted by reach, story/reel adaptation
- **LinkedIn**: Professional tone, 150-300 words, 3-5 industry hashtags, thought leadership framing
- **Facebook**: Community-oriented, relatable stories, 5-15 hashtags, engagement questions
- **Reddit**: Authentic voice, no hashtags, subreddit-appropriate tone, discussion-starter format

### Follower Growth Analytics

**What it does:** Tracks follower/subscriber counts daily and measures per-post follower impact.

**Data collected:**
- Daily follower snapshots for Instagram, YouTube, and Facebook
- Day-over-day delta (growth/loss)
- Following count (where available)
- Post count (where available)

**Per-post ROI scoring:**
- Follower baseline captured at publish time
- Follower delta measured at 24h, 48h, and 72h after publish
- ROI score (0-10) computed from: follower growth (40% weight), engagement rate (30%), views vs average (20%), saves/shares (10%)

### Automated Engagement

**Supported platforms:** Instagram (comments + DMs), YouTube (comments)

**How it works:**
1. Instagram/YouTube sends webhook notification when new comment arrives
2. Socialixer classifies comment intent: lead, question, spam, positive, negative
3. Safety filters check for toxic, off-topic, or spammy content
4. AI generates a contextual reply matching configured tone
5. Reply is posted via platform API
6. Comment ID is persisted to prevent duplicate replies

**Safety features:**
- Toxic content detection (skips reply)
- Spam detection (skips reply)
- Off-topic detection (skips reply)
- Duplicate reply prevention (Firestore persistence)
- Configurable enable/disable per platform

### Lead CRM

**What it does:** Automatically detects and manages potential customer leads from social media interactions.

**Lead detection:** AI classifies incoming comments and messages for purchase intent, brand interest, or collaboration requests.

**Lead management pipeline:**
- New → Contacted → Converted → Closed
- Lead cards with: source platform, original message, intent classification, contact info, notes
- Real-time updates via Firestore subscriptions

### Newsletter System

**What it does:** Full email newsletter system for subscriber management and broadcast campaigns.

**Subscriber flow:**
1. Visitor submits email on landing page
2. Verification email sent (double opt-in)
3. Subscriber completes onboarding (role, pain points)
4. Priority score computed based on role + pain points
5. Subscriber receives broadcasts based on segment and preferences

**Admin capabilities:**
- Subscriber list with search, filter, and pagination
- Broadcast composer with segment targeting
- Campaign history with open/click analytics
- CSV export of subscriber data
- GDPR right-to-erasure support

### Billing & Referral

**Plans:**
| Plan | Monthly Price | AI Requests | Key Features |
|------|--------------|-------------|--------------|
| Free | $0 | 50/month | All 7 platforms, basic analytics |
| Pro | $19/month | 500/month | Priority support, advanced analytics |
| Agency | $49/month | 2000/month | Team features, higher limits |

**Top-up credits:** One-time purchases for additional AI requests beyond plan limits. Credits never expire and never reset.

**Referral program:** Each user gets a unique 8-character referral code. When a referred user makes a payment, the referrer earns 5% cash commission credited to their wallet.

## Integration Details

### Authentication
- Firebase Authentication (email/password, Google OAuth)
- JWT token-based API authentication
- Automatic token refresh

### API Security
- All platform credentials encrypted with Fernet (AES-128-CBC + HMAC)
- Encryption key stored in server environment only
- Rate limiting on all endpoints (Flask-Limiter)
- CORS configured for frontend origin only

### Data Storage
- Firebase Firestore for all user data, content, and analytics
- Cloudflare R2 for media file storage (images, videos)
- No data stored in browser localStorage except auth tokens

## Comparison with Competitors

| Feature | Socialixer | Buffer | Hootsuite | Later | Sprout Social |
|---------|-----------|--------|-----------|-------|---------------|
| AI Content Ideas | Yes (Gemini) | No | No | No | Limited |
| Gap Analysis | Yes | No | No | No | No |
| Content Optimizer | Yes (per-platform) | No | No | No | Limited |
| Auto Comment Reply | Yes (AI-powered) | No | No | No | Manual |
| Lead CRM | Built-in | No | No | No | Add-on |
| Follower Analytics | Built-in | Basic | Add-on | Basic | Add-on |
| Free Tier | 50 AI requests | 3 channels | None | 1 profile | None |
| Starting Price | $19/mo | $6/mo | $99/mo | $25/mo | $249/mo |

## Links

- Website: https://socialixer.com
- Pricing: https://socialixer.com/pricing
- Terms of Service: https://socialixer.com/terms
- Privacy Policy: https://socialixer.com/privacy
- Sitemap: https://socialixer.com/sitemap.xml
- LLMs Summary: https://socialixer.com/llms.txt