Twitter Outreach Suite (v1.1.4)

The Ultimate Lead Sourcing & DM Automation System

Twitter Outreach Suite is a terminal-based CLI tool designed for high-growth agencies and founders. It sources high-intent prospects directly from competitor followers, viral tweet engagers, and curated niche communities.

Features

• Lead Sourcing: Find prospects from:
  • Competitor Followers: Target your rivals' audiences.
  • Tweet Engagers: Target users interacting with specific content.
  • List & Community Members: Harvest niche-specific groups.
• Surgical Filtering: Automatically filters for "Sweet Spot" profiles (500-8k followers) with active bios and open DMs.
• AI Personalization: Generates personalized DMs using Claude 3.5 Sonnet or GPT-4.
• Stealth Automation: Uses headful browser sessions and human-like delays to keep your account safe.
• Unified CRM: Terminal dashboard to track leads, drafts, and responses.

Quick Start

Prerequisites

• Node.js 18+
• Twitter (X) Account (use a secondary, not your main)
• AI API Key (Anthropic, OpenRouter, or OpenAI)
• License Key (provided by seller)

Installation

# Extract the folder
cd Suite

# Install dependencies
npm install

# Install Playwright browser (one-time)
npx playwright install chromium

First Run

# Run the tool
npm start

The tool will guide you through:

1. Entering your license key
2. Entering your AI provider key and Twitter credentials
3. Configuring your target roles and industries

Documentation

| Guide | What it covers | |-------|----------------| | GUIDE.md | Complete user manual | | TROUBLESHOOTING.md | Error fixes & edge cases |

Daily Workflow

1. Find Prospects: Select Find new prospects and choose your source.
2. AI Scrutiny: Tool visits each profile, verifies data, and scores them.
3. Review & Draft: Use the CRM to review leads and generate AI drafts.
4. Send DMs: Manual-send flow ensures account safety.

Testing

# Run all tests
npm test

# Run quick verification
node tests/quick-dm-test.js
node tests/quick-scoring-test.js

Seller Admin (License Management)

If you're selling this tool, manage customer licenses:

# Revoke a license (blocks access)
npm run license:revoke -- customer-key-123

# List all revoked licenses
npm run license:list

# Restore a revoked license
npm run license:restore -- customer-key-123

Safety Limits

• Daily Cap: 50 DMs per day (configurable)
• Human-in-the-Loop: Manual send step prevents bot detection
• Stealth Profile: Browser session persists locally

⚠️ Disclaimer

This tool automates interactions with X.com (Twitter). Use responsibly.

• Twitter/X may restrict or ban accounts that violate their Terms of Service
• Use secondary accounts, not your primary/main account
• The seller is not responsible for account suspensions or bans
• Use at your own risk - this is an arms race and Twitter updates frequently

Configuration

Edit your .env file:

LICENSE_KEY=your_key_here
ANTHROPIC_API_KEY=sk-ant-...
TWITTER_USERNAME=your_username
TWITTER_PASSWORD=your_password

Project Structure

src/
├── index.js           # Main entry point
├── config.js          # Configuration & constants
├── ui/                # Terminal interface
├── scraper/           # Twitter scraping
├── generator/         # AI DM generation
├── auth/              # Twitter authentication
└── utils/             # Helpers (scoring, data, etc.)

License

Proprietary. Contact seller for licensing details.