Skip to content

shade-solutions/auto-tweet-posting

Repository files navigation

Auto Tweet Post

AI-powered automated Twitter posting system for freelance web developers to attract international clients and convert them into paying customers.

Overview

This system generates high-quality, revenue-focused Twitter content using OpenAI's API and automatically posts it on a scheduled basis to maximize international client acquisition. The content strategy is specifically designed for freelance web developers who specialize in landing pages, SaaS, and full-stack applications.

Features

  • AI-Powered Content Generation: Uses OpenAI GPT-4 to create engaging, professional content
  • 6 Content Types: Web dev tips, tool recommendations, case studies, industry insights, engagement posts, and portfolio highlights
  • Global Scheduling: Posts every 4-6 hours to catch international time zones
  • Revenue Optimization: Strategic CTAs and social proof in every post
  • Performance Analytics: Tracks post performance to optimize for conversions
  • Hashtag Optimization: Smart hashtag selection for maximum discoverability
  • Error Handling: Robust error handling and retry mechanisms

Content Strategy

The system generates content in 6 different types with specific distribution percentages:

  1. Web Dev Tips (35%) - Quick, actionable advice that showcases expertise
  2. Tool Recommendations (20%) - Curated tools with affiliate potential
  3. Case Studies (15%) - Client success stories with metrics
  4. Industry Trends (15%) - Forward-thinking insights on web dev
  5. Engagement Posts (10%) - Questions and polls to boost visibility
  6. Portfolio Highlights (5%) - Showcase your best work with results

Setup

Prerequisites

  1. Node.js (v14 or higher)
  2. OpenAI API key
  3. Twitter Developer Account with API keys

Installation

  1. Clone the repository:

    git clone https://github.com/your-username/auto-tweet-post.git
    cd auto-tweet-post
  2. Install dependencies:

    npm install
  3. Configure environment variables:

    cp .env.example .env

    Edit the .env file and add your API keys:

    • OPENAI_API_KEY - Your OpenAI API key
    • TWITTER_API_KEY - Your Twitter API key
    • TWITTER_API_SECRET - Your Twitter API secret
    • TWITTER_ACCESS_TOKEN - Your Twitter access token
    • TWITTER_ACCESS_SECRET - Your Twitter access secret
    • TWITTER_BEARER_TOKEN - Your Twitter bearer token

Running the Application

  1. Start the application:

    npm start
  2. For development:

    npm run dev

Configuration

Content Types

Content types and their distribution can be configured in src/config/schedule.js.

Hashtags

Hashtags are configured in src/config/hashtags.js with different categories:

  • Core hashtags (always included)
  • Industry-specific hashtags
  • Trending hashtags
  • Engagement hashtags

Scheduling

The posting schedule is configured in src/config/schedule.js:

  • Default: Every 6 hours (0 */6 * * *)
  • Alternative: Every 4 hours (0 */4 * * *)

Data Storage

The system stores data locally in the src/data/ directory:

  • posted-content.json - History of posted content
  • analytics.json - Performance analytics
  • failed-posts.json - Failed posting attempts

Logging

The system uses Winston for logging with different levels:

  • Error logs: logs/error.log
  • Combined logs: logs/combined.log

Development

Testing

Run tests with:

npm test

Code Structure

src/
├── config/          # Configuration files
├── services/        # External service integrations
├── utils/           # Utility functions
├── data/            # Local data storage
└── index.js         # Main application entry point

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a pull request

License

MIT License

Support

For support, please open an issue on the GitHub repository.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors