NEXUS Sales Engine

India-Based Software Dev + AI Company · US Startup Outreach System

Strategy: Approach US startups & agencies for white-label resourcing at India pricing. You deliver, they bill their clients at US rates. Everyone wins.

---

🧠 System Architecture

┌──────────────────────────────────────────────────────────────┐
│                    python3 run.py                             │
└──────────────────────┬───────────────────────────────────────┘
                       │
         ┌─────────────┼─────────────┐
         ▼             ▼             ▼
  ┌─────────────┐ ┌──────────┐ ┌──────────────┐
  │lead_scraper │ │pipeline  │ │social_manager│
  │    .py      │ │  .py     │ │    .py       │
  └──────┬──────┘ └────┬─────┘ └──────┬───────┘
         │              │              │
  HackerNews        Claude 3.5    LinkedIn API
  ProductHunt       HubSpot CRM   Facebook API
  YCombinator       Gmail SMTP    Clutch Content
  Hunter.io email   Report CSV    Calendar CSV
         │              │              │
         └──────────────▼──────────────┘
                    leads.csv
               pipeline_report.csv
               content_calendar.csv

---

⚡ Quick Start

Step 1 — Fill in your .env (the ONLY manual step)

Open .env and replace PLACEHOLDER_DO_NOT_RUN values:

Key	Required	Where to Get
ANTHROPIC_API_KEY	✅ Core	console.anthropic.com → API Keys
HUBSPOT_ACCESS_TOKEN	✅ Core	HubSpot → Settings → Private Apps → Create App
SENDER_EMAIL	✅ Core	Your Gmail address
EMAIL_APP_PASSWORD	✅ Core	myaccount.google.com/apppasswords
HUNTER_API_KEY	⭐ Recommended	hunter.io/api-keys (free 25/mo)
PRODUCTHUNT_CLIENT_ID	Optional	producthunt.com/v2/oauth/applications
PRODUCTHUNT_CLIENT_SECRET	Optional	Same as above
LINKEDIN_ACCESS_TOKEN	Optional	LinkedIn Developer App → OAuth token
LINKEDIN_ORGANIZATION_ID	Optional	Your LinkedIn Company Page ID (from URL)
FACEBOOK_PAGE_ACCESS_TOKEN	Optional	graph.facebook.com/me/accounts
FACEBOOK_PAGE_ID	Optional	Your Facebook Business Page ID
COMPANY_NAME	✅ Core	Your company name
SENDER_NAME	✅ Core	Your name
CALENDLY_LINK	✅ Core	Your Calendly booking link

⚠️ Gmail: Enable 2FA → Generate App Password → Use that as EMAIL_APP_PASSWORD (NOT your real password)

---

Step 2 — One-Time HubSpot Setup

In HubSpot: Settings → Properties → Contact Properties → Create Property

• Label: AI Personalized Pitch
• Internal name: ai_personalized_pitch
• Field type: Multi-line text

---

Step 3 — Run Everything

# Full pipeline: scrape → enrich → initial email → social post → follow-up drips
python3 run.py

# Or run individual steps:
python3 run.py --scrape-only      # Just find new US startup leads
python3 run.py --pipeline-only    # Just run email outreach (uses existing leads.csv)
python3 run.py --social-only      # Just publish today's social posts
python3 run.py --followup-only    # Just run pending follow-up email drips (Day 3/7/10/14)
python3 run.py --dry-run          # Preview everything without sending

Step 4 — One-Time Social Setup

# Generate 30-day content calendar (run once, review, then auto-post daily)
python3 run.py --generate

# Generate your Clutch.co profile content + review request templates
python3 run.py --clutch

# Start daily auto-publisher (runs at scheduled times each day)
python3 run.py --schedule

---

📁 File Map

Sales Automation/
├── .env                         ← 🔐 Your credentials (NEVER commit)
├── .gitignore                   ← Keeps .env safe from git
│
├── run.py                       ← 🚀 Master runner (start here)
├── lead_scraper.py              ← 🔭 US startup discovery engine
├── pipeline.py                  ← 📧 AI enrichment + CRM + email
├── social_manager.py            ← 📱 LinkedIn + Facebook + Clutch
├── followup_engine.py           ← 🔁 B2B 5-touch drip follow-up engine
│
├── leads.csv                    ← Auto-generated by scraper
├── content_calendar.csv         ← Auto-generated by --generate
├── pipeline_report.csv          ← Auto-generated after each run
├── followup_tracker.csv         ← Auto-generated tracking database for drips
├── pipeline.log                 ← Detailed email pipeline log
├── scraper.log                  ← Detailed scraper log
├── social.log                   ← Detailed social posting log
├── followup.log                 ← Detailed follow-up campaign log
│
└── content/
    ├── clutch_profile.txt       ← Clutch company description
    └── clutch_review_requests.txt ← Review email templates

---

🎯 Who We Target (ICP)

Company Type	Why We Target	What We Offer
US Product Startups (seed–Series A, 1–50 ppl)	They're building fast, eng team is small, burn rate is high	We are their offshore dev team at 10x lower cost
US Digital Agencies (11–100 ppl)	They win clients but outsource dev work	We are their invisible dev partner — they brand our work
US Service Companies (software studios, SaaS shops)	Capacity overflow, new project types	We extend their team on-demand

Value Proposition (use in cold emails + social):

"We work from India at Indian market rates. You charge your clients at US market rates. The arbitrage is your margin. We're your engineering team — you just manage the client."

---

📊 Lead Sources

Source	Type	Auth Required	Volume
HackerNews "Who Is Hiring"	Active hiring companies	None (free)	50–100/month
ProductHunt	New product launches	Free token	30–50/month
Y Combinator Directory	Latest batch startups	None (public)	20–40/month
Hunter.io Email Finder	Email enrichment	Free 25/month	25 emails/month

---

📱 Social Media Strategy

Platform	Frequency	Content Focus
LinkedIn	5x/week (Mon–Fri 9:30am)	Thought leadership, cost arbitrage education, case studies
Facebook	3x/week (Mon/Wed/Fri 11am)	Behind-the-scenes, client wins, team culture
Clutch	Ongoing	Profile optimization + review requests after deliveries

---

🛡️ Security

• All keys in .env — never in code
• .gitignore blocks .env permanently
• Pipeline hard-stops if any key = PLACEHOLDER
• All API calls wrapped in try/except with 3x retry + backoff

---

Built with Claude 3.5 Sonnet · HubSpot CRM · Gmail SMTP · LinkedIn API · Facebook Graph API · HackerNews API · ProductHunt API · Hunter.io