A comprehensive automation pipeline that transforms your Notion content into engaging social media posts across multiple platforms using AI-powered content optimization.

ProleVibeSummer is an AI experiment by Toilville: one week running a business entirely on AI tools to test hype vs. reality.

Goal: Answer "Is AI collaboration actually better work?" through documented business scenarios, iteration counts, and real-world results.

This social media automation system is a key deliverable from the ProleVibeSummer experiment, demonstrating practical AI collaboration in content creation and business automation.

• 🤖 AI Content Processing: Uses Claude 3.5 Sonnet to transform basic content into engaging social media posts
• 📅 Smart Scheduling: GitHub Actions automation with optimal posting times
• 🔄 Multi-Platform Publishing: Supports Bluesky, LinkedIn, and WordPress
• 📊 Notion Integration: Complete workflow management in your Notion workspace
• 🛠️ Debugging Tools: Comprehensive setup and troubleshooting utilities
• 📈 Analytics Ready: Framework for Phase 2 performance tracking

• Python 3.9+
• Notion workspace with integration access
• Anthropic Claude API key
• Social media platform credentials

1. Clone and setup:

   git clone https://github.com/yourusername/social-media-automation
   cd social-media-automation
   pip install -r requirements.txt

2. Configure environment:

   cp .env.example .env
   # Edit .env with your actual API credentials

3. Verify setup:

   python tools/setup_checker.py

Create a Notion database with these properties:

1. Create integration at https://developers.notion.com/
2. Share your database with the integration
3. Add NOTION_TOKEN and NOTION_DATABASE_ID to .env

1. Get API key from https://console.anthropic.com/
2. Add ANTHROPIC_API_KEY to .env

Bluesky: Add handles and app passwords
LinkedIn: Configure access token
WordPress: Set up REST API credentials

# Process content with AI
python ai_content_processor.py

# Post to social media
python social_media_poster.py

# Run comprehensive tests
python testing_framework.py

The system runs automatically:

• AI Processing: Daily at 9 AM UTC
• Publishing: 3x daily at optimal engagement times
• Testing: Manual trigger available

# Validate your setup
python tools/setup_checker.py

# Find suitable Notion databases
python tools/notion_database_explorer.py

# Debug database structure
python tools/debug_database.py

1. Create content in Notion with publish date and platforms
2. AI processing transforms Draft → Ready with engaging copy
3. Automated publishing at optimal times across platforms
4. URLs tracked back to Notion automatically

• Environment variables protected by .gitignore
• No hardcoded credentials in source code
• Test mode available for safe development
• Comprehensive error handling and logging

We welcome contributions! Please see our Contributing Guide and Code of Conduct.

1. Fork the repository
2. Create a feature branch
3. Install dependencies: pip install -r requirements.txt
4. Make your changes
5. Test thoroughly
6. Submit a pull request

• AI content processing with Claude
• Multi-platform publishing
• Notion workflow management

• Performance tracking across platforms
• Content optimization recommendations
• Umami analytics integration
• Weekly automated reports

• Custom AI prompts per platform
• Content scheduling optimization
• Advanced analytics dashboard
• Community management tools

The project includes comprehensive testing tools:

# Run all connection tests
python testing_framework.py

# Test specific components
python ai_content_processor.py  # AI processing
python social_media_poster.py   # Publishing

This project is licensed under the MIT License - see the LICENSE file for details.

• Anthropic for Claude AI
• Notion for workspace integration
• Bluesky for social platform support
• The open source community for inspiration and tools

• 🐛 Bug Reports: Create an issue
• 💡 Feature Requests: Start a discussion
• 📧 Security Issues: See SECURITY.md

Made with ❤️ for the creator economy. Share your automation success stories!