Outreach & Sending #

Send tailored outreach emails from your draft CSV via Gmail or Outlook. Form-application rows are handled in the browser — not via email.

Pages in this section #

Workflow

Outreach workflow #

End-to-end flow from discovery to sent email.

1. Discover #

raven discover --q "backend engineer" --loc Remote --since 7

Results save to data/jobs.json.

2. Draft #

raven draft --max 25

Creates:

File	Purpose
`drafts/outreach-YYYY-MM-DD.csv`	Spreadsheet with all columns
`drafts/outreach-YYYY-MM-DD.md`	Human-readable review

Optional: --xlsx for Excel, --gemini for AI polish.

3. Review #

Open the markdown file:

open drafts/outreach-*.md   # macOS

Check each entry:

email rows — subject, body, disclaimer
form rows — follow form_steps in browser (skip send)

Edit CSV directly if needed before sending.

When to use `raven send` #

`application_type`	Action
email	Fill `contact_email` in CSV → dry-run → send
form	Follow `form_steps` in CSV or `.md` and submit in the ATS

Prerequisites #

# .env
SENDER_NAME=Your Name
SENDER_EMAIL=you@example.com

./raven auth-gmail    # or auth-outlook

Safe send workflow #

# 1. Review drafts
open drafts/outreach-*.md

# 2. Fill contact_email for email rows in CSV

# 3. Preview
./raven send --input drafts/outreach-2026-07-04.csv --dry-run

# 4. Send with rate limiting
./raven send --input drafts/outreach-2026-07-04.csv --delay 60 --limit 20

Always run --dry-run first. Use --delay 60 or higher to avoid provider rate limits.

Start with Email workflow →