Facebook Outreach

Playwright-based Facebook Messenger cold outreach. Sends DMs as your personal Facebook account to business pages. Personal accounts can initiate Messenger conversations with any page that has messaging enabled.

What It Does

• Sends Messenger DMs as your personal Facebook account to business pages
• Navigates to each page → clicks "Message" button → types in Messenger overlay → sends
• Also scrapes contact info (email, phone, website) from each page's About section while it's there
• Rate-limited with configurable daily limits, batch sizes, and human-like jittered delays (±30%)
• 3-layer dedup: SQL DISTINCT ON, session Set, post-send duplicate marking
• Detects missing Message button, 404 pages, and navigation errors
• Tracks all sends in facebook_outreach table

Setup

1. Save Your Personal Account Session

Run --headed on first use — log in as your personal Facebook account. Session saves to cookies/facebook-profile/.