Sociantra - AI-Powered LinkedIn Content Automation Platform

Inspiration

As content creators and entrepreneurs, we've experienced firsthand the pain points of LinkedIn content creation. Spending hours crafting a single post, struggling with writer's block, and juggling multiple tools just to maintain a consistent social media presence - these challenges inspired us to build Sociantra.

The MNEE Hackathon's focus on "Programmable Money for Agents, Commerce, and Automated Finance" perfectly aligned with our vision. We saw an opportunity to combine:

  • AI-powered automation to solve content creation bottlenecks
  • Blockchain micropayments to enable frictionless, low-cost transactions
  • Agent-based architecture to create autonomous services that verify payments before execution

The idea was simple: What if creators could generate LinkedIn content 10x faster, pay just 0.01 MNEE per service, and have everything automated? This vision became Sociantra.

What it does

Sociantra is a comprehensive AI-powered platform that automates LinkedIn content creation and management. Here's what it does:

Core Features

🤖 AI-Powered Content Generation

  • Generate engaging LinkedIn posts from topics using Google Gemini AI with LangChain agents
  • Real-time web search integration for up-to-date, factual content
  • Multi-language support (7 languages: English, French, Spanish, Italian, German, Portuguese, Dutch)
  • Optional AI-generated images for visual appeal

💰 Blockchain Micropayments

  • All services cost just 0.01 MNEE per use (except Post Ideas, which is FREE)
  • Instant blockchain verification via Bitcoin SV network
  • Encrypted wallet storage with WIF key encryption
  • Transparent transaction history

📅 Smart Scheduling

  • One-time and recurring schedules using cron expressions
  • Calendar view with scheduled dates
  • Team approval workflow with email verification
  • Timezone support (IST/UTC)

🔗 LinkedIn Integration

  • Direct posting to LinkedIn via OAuth 2.0
  • Image upload support
  • Post status tracking
  • LinkedIn post embedding

📝 Content Management

  • URL-to-Post conversion (extract and convert articles to LinkedIn posts)
  • Post templates library for reusable content
  • Post ideas generator (FREE)
  • Analytics dashboard with spending and usage metrics

How It Works

  1. User signs up and connects their LinkedIn account
  2. Connects MNEE wallet with encrypted WIF key storage
  3. Requests a service (e.g., AI Post Generation)
  4. Pays 0.01 MNEE - payment verified on blockchain instantly
  5. Service executes - AI generates content, posts to LinkedIn, or schedules as requested
  6. Analytics tracked - all activity recorded for insights

How we built it

Frontend Architecture

Tech Stack:

  • Next.js 16.0.10 with App Router for server-side rendering
  • React 19.2.0 for interactive UI components
  • TypeScript for type-safe development
  • Tailwind CSS for responsive, mobile-first design
  • Framer Motion for smooth animations
  • shadcn/ui for accessible UI components

Key Components:

  • Context API for state management (Auth, LinkedIn, MNEE, Payment)
  • Responsive sidebar with mobile menu
  • Payment modal with real-time status updates
  • Protected routes with authentication checks

Backend Architecture

Tech Stack:

  • Python 3.10+ with uAgents framework
  • LangChain for AI agent orchestration with tool calling
  • FastAPI/Pydantic for API models and validation
  • Supabase for PostgreSQL database and authentication
  • Azure Container Apps for cloud deployment

Service Architecture:

  • Auth Service - JWT token management, user authentication
  • Payment Service - MNEE payment verification on blockchain
  • LinkedIn Service - OAuth 2.0 flow, post publishing, image upload
  • AI Service - Google Gemini AI integration with LangChain agents
  • Scheduler Service - Cron job management, scheduled post execution
  • Analytics Service - Data aggregation and metrics calculation

Blockchain Integration

MNEE Stablecoin:

  • MNEE SDK (@mnee/ts-sdk) for TypeScript integration
  • 1Sat Ordinals protocol on Bitcoin SV network
  • WIF Keys encrypted with Fernet (symmetric encryption)
  • Transaction verification on blockchain before service execution

Payment Flow:

  1. Frontend creates transaction using MNEE SDK
  2. Transaction submitted to MNEE API
  3. Returns ticket ID for tracking
  4. Frontend polls transaction status (every 2 seconds)
  5. Backend verifies transaction on blockchain
  6. Payment recorded in database
  7. Service access granted

Database Design

Supabase PostgreSQL:

  • users - User accounts and authentication
  • linkedin_connections - LinkedIn OAuth tokens (encrypted)
  • generated_posts - AI-generated content
  • scheduled_posts - Schedule configurations with cron expressions
  • payments - Transaction records with blockchain verification
  • user_wallets - Encrypted WIF keys (Fernet encryption)
  • templates - Reusable post templates

Security:

  • Row Level Security (RLS) enabled on all tables
  • User data isolated by user ID
  • Encrypted sensitive fields (tokens, WIF keys)
  • JWT token-based authentication

AI Integration

Google Gemini 2.0 Flash:

  • LangChain agent with web search tool calling
  • Real-time web search for factual, current information
  • Multi-language content generation
  • LinkedIn-optimized formatting
  • Content summarization for URL-to-Post conversion

Image Generation:

  • AI-powered image generation agent
  • Unique, varied image prompts
  • Professional LinkedIn-optimized designs

Challenges we ran into

1. Payment Verification in Real-Time

Challenge: Verifying blockchain transactions instantly while maintaining security.

Solution: Implemented a polling mechanism with ticket IDs. Frontend polls transaction status every 2 seconds, and backend verifies on blockchain before granting service access. This ensures real-time updates without compromising security.

2. Mixed Content (HTTP/HTTPS)

Challenge: Frontend deployed on HTTPS (Vercel) calling backend on HTTP caused Mixed Content errors.

Solution: Created Next.js API proxy route (/api/proxy/[...path]) that forwards requests to backend. In production, all requests go through the proxy, while development uses direct connection.

3. Wallet Security

Challenge: Securely storing WIF keys without exposing them to frontend.

Solution: Implemented Fernet symmetric encryption on backend. WIF keys are encrypted before storage in Supabase, and encryption keys are stored as environment variables. Keys are never exposed to frontend.

4. LinkedIn OAuth Flow

Challenge: Handling OAuth redirects, token refresh, and maintaining session state.

Solution: Backend manages entire OAuth flow. Stores access tokens and refresh tokens securely, handles automatic token refresh, and provides status endpoints for frontend to check connection state.

5. AI Content Quality

Challenge: Generating high-quality, LinkedIn-optimized content that sounds natural and engaging.

Solution: Used LangChain agents with Google Gemini AI, integrated real-time web search for factual content, implemented multi-language support with language-specific prompts, and added LinkedIn formatting guidelines.

6. Responsive Mobile Design

Challenge: Creating a mobile-first responsive design that works seamlessly across all devices.

Solution: Used Tailwind CSS breakpoints, created mobile-optimized components with touch-friendly buttons (min 44px height), implemented collapsible sidebar with mobile menu, and ensured all layouts stack properly on mobile.

7. Payment Status Polling

Challenge: Providing real-time payment status updates without overwhelming the system.

Solution: Implemented smart polling with 2-second intervals, automatic cleanup on component unmount, status tracking to prevent duplicate requests, and automatic service execution on successful payment.

Accomplishments that we're proud of

🏆 Technical Achievements

  1. Complete End-to-End Integration

    • Successfully integrated MNEE stablecoin with instant blockchain verification
    • Seamless payment flow from frontend to blockchain to backend
    • Real-time payment status updates
  2. AI-Powered Content Generation

    • LangChain agent with web search tool calling
    • Multi-language support (7 languages)
    • Real-time web search for factual, current content
    • LinkedIn-optimized formatting
  3. Secure Wallet Integration

    • Fernet encryption for WIF keys
    • Encrypted storage in Supabase
    • Keys never exposed to frontend
    • Secure payment processing
  4. Responsive Mobile Design

    • Fully responsive across all screen sizes
    • Mobile-first approach
    • Touch-friendly UI
    • Optimized performance
  5. Smart Scheduling System

    • Cron expression support for recurring schedules
    • Team approval workflow
    • Calendar view
    • Automatic post generation and publishing

🎯 Feature Completeness

  • ✅ AI Post Generation with LangChain
  • ✅ LinkedIn Integration (OAuth 2.0)
  • ✅ Blockchain Micropayments (MNEE)
  • ✅ Smart Scheduling (Cron-based)
  • ✅ URL-to-Post Conversion
  • ✅ Analytics Dashboard
  • ✅ Template Library
  • ✅ Multi-language Support
  • ✅ Team Collaboration
  • ✅ Mobile Responsive Design

📊 Project Metrics

  • Frontend: 15,000+ lines of code, 50+ React components, 15+ pages
  • Backend: 6 main services, 30+ API endpoints, 7+ database tables
  • Technologies: 15+ frontend technologies, 8+ backend technologies, 5+ blockchain technologies
  • Features: 8+ core features fully implemented

What we learned

Technical Learnings

  1. Blockchain Micropayments

    • Learned about MNEE stablecoin and 1Sat Ordinals protocol
    • Understood Bitcoin SV network for transactions
    • Implemented secure WIF key management
    • Gained experience with blockchain transaction verification
  2. AI Agent Architecture

    • Explored LangChain framework for AI agents
    • Implemented tool calling for web search
    • Learned about prompt engineering for LinkedIn content
    • Understood multi-language AI content generation
  3. Agent-Based Backend

    • Worked with uAgents framework
    • Implemented agent-to-agent communication
    • Learned async/await patterns for concurrent operations
    • Understood RESTful API design with agent architecture
  4. Security Best Practices

    • Implemented Fernet encryption for sensitive data
    • Learned about Row Level Security (RLS) in Supabase
    • Understood JWT token management
    • Gained experience with secure wallet storage
  5. Responsive Design

    • Mastered Tailwind CSS breakpoints
    • Learned mobile-first design principles
    • Implemented touch-friendly UI components
    • Gained experience with responsive grid layouts

Product Learnings

  1. User Experience

    • Understood the importance of real-time feedback
    • Learned about payment flow optimization
    • Gained insights into content creator workflows
    • Understood the value of automation
  2. Blockchain Payments

    • Learned about micropayment use cases
    • Understood the benefits of instant verification
    • Gained experience with stablecoin integration
    • Learned about transparent transaction history
  3. AI Content Generation

    • Understood the importance of factual, current content
    • Learned about LinkedIn content optimization
    • Gained insights into multi-language content creation
    • Understood the balance between automation and quality

What's next for Sociantra

Short-Term (Next 3 Months)

  1. Tip Jar System

    • Users can tip posts with MNEE tokens
    • Creator earnings tracking
    • Revenue sharing mechanism
    • Payment distribution system
  2. Enhanced Analytics

    • LinkedIn engagement metrics integration
    • Post performance analysis
    • Audience insights
    • Content optimization suggestions
  3. Advanced Scheduling

    • Best time to post recommendations
    • A/B testing for post variations
    • Bulk scheduling for multiple posts
    • Schedule templates

Medium-Term (3-6 Months)

  1. Multi-Platform Support

    • Twitter/X integration
    • Facebook integration
    • Instagram integration
    • Cross-platform content repurposing
  2. AI Improvements

    • Custom AI model training
    • Brand voice learning
    • Content style customization
    • Advanced content optimization
  3. Team Collaboration

    • Team workspaces
    • Role-based access control
    • Content approval workflows
    • Team analytics dashboard

Long-Term (6-12 Months)

  1. Enterprise Features

    • White-label solutions
    • API access for enterprise clients
    • Custom integrations
    • Advanced reporting
  2. Content Library

    • Media asset management
    • Image library with AI search
    • Video content support
    • Content versioning
  3. Marketplace

    • Content creator marketplace
    • Template marketplace
    • AI model marketplace
    • Service integrations
  4. Advanced AI

    • Video content generation
    • Podcast script generation
    • Email campaign automation
    • Content strategy recommendations

Technical Roadmap

  1. Performance Optimization

    • Caching strategies
    • Database query optimization
    • CDN integration
    • Image optimization
  2. Scalability

    • Horizontal scaling
    • Load balancing
    • Database sharding
    • Microservices architecture
  3. Developer Experience

    • Public API documentation
    • SDK development
    • Webhook support
    • Developer portal
  4. Security Enhancements

    • Two-factor authentication
    • Advanced encryption options
    • Security audit logging
    • Compliance certifications

Built with ❤️ for the MNEE Hackathon

Track: AI & Agent Payments and Creators and businesses to accept stablecoin payments
Contract: 0x8ccedbAe4916b79da7F3F612EfB2EB93A2bFD6cF
GitHub: Frontend | Backend
Live Demo: https://mnee-ai-social.vercel.app

Built With

  • ai
  • aiagent
  • azure
  • langchain
  • mnee
  • next.js
  • restapi
  • superbase
  • web3
Share this project:

Updates