🚀 Twitter Outreach Suite

The Ultimate Production-Grade Twitter DM Automation System

Twitter Outreach Suite is a powerful, terminal-based CLI tool designed for founders, agencies, and sales teams. It combines Native X Search, Intelligent Lead Scoring, and AI-Powered Personalization to help you start high-value conversations without the risk of account bans.

✨ Features

• 🔍 Native Discovery: Finds prospects directly via the Twitter "People" search tab—no API limits.
• 🧠 Claude AI Personalization: Generates hyper-personalized DMs using Claude 3.5 Sonnet based on bios and recent activity.
• 🛡️ Stealth Automation: Uses headful browser sessions and human-like delays to remain untraceable.
• 📩 Response Tracking: Automatically syncs your inbox and marks replied prospects in the CRM.
• 📦 NPM Ready: Install and run as a global package for instant outreach.
• 🎨 Modern CLI: A beautiful, intuitive terminal dashboard for managing your entire pipeline.

🚀 Quick Start

1. Prerequisites

• Node.js 18+
• Twitter (X) Account
• Anthropic API Key (or OpenRouter)

2. Installation

# Install globally from npm (once published)
npm install -g twitter-outreach

# Or install locally for development
git clone https://github.com/your-repo/twitter-outreach.git
cd twitter-outreach
npm install
npm link

3. Usage

Type the command from anywhere:

twitter-outreach

On first run, the tool will guide you through:

1. API Config: Entering your Anthropic key and Twitter credentials.
2. Setup Wizard: Defining your target ICP, service, and value proposition.

📅 Daily Workflow

1. Find Leads: Select 🔍 Find new prospects to hunt for profiles matching your criteria.
2. Review & Draft: Use the 📋 CRM to review leads and generate personalized AI drafts.
3. Send DMs: Select 🚀 Send DMs to open the manual-send flow.
   • The tool opens the DM page for you.
   • Press [O] to copy the AI draft and open the browser.
   • Paste (Ctrl+V) and hit Enter to send manually. This keeps your account 100% safe.

🛡️ Safety & Best Practices

To keep your account healthy:

• Daily Limit: Aim for 30-50 DMs per day (default limit is 50).
• Manual Sending: The "human-in-the-loop" send button is intentional—it prevents automated detection.
• Cool-downs: The tool includes mandatory delays between profile visits and sends.

🔧 Configuration

All settings can be adjusted directly within the CLI under the Settings menu:

• Scraper Settings: Adjust target roles, follower counts, and negative keywords.
• API Credentials: Update your keys or Twitter password anytime.

📂 Project Structure

• src/index.js: Main application entry point.
• src/ui/: Terminal-based user interface.
• src/search/ & src/scraper/: Native Twitter automation logic.
• src/generator/: AI message generation (Claude).
• data/: Local JSON storage for prospects, sent logs, and session data.

📝 License

Proprietary. Built for high-growth teams who value reliability over hacks.