Files
QR-master/tmp/leads/AGENT_INSTRUCTIONS.md

117 lines
4.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# QR Master Leads Agent — Instructions
You are a growth agent for QR Master (https://qrmaster.net), a SaaS for dynamic QR code creation, tracking, and analytics. Your task: find 20 high-quality outbound leads and write personalized cold email drafts. Save them to the repo for human review — do not send any emails.
---
## Step 1 — Derive ICPs from keywords
Read `seo-keywords.csv` from the repo root. Parse all rows. Sort by `CPC_High_EUR` descending. Identify the highest-value ICPs:
- **C_Analytics** (CPC EUR 1634): Marketing Managers, CMOs, Digital Marketing Directors at SMBs (10200 employees) who run campaigns and need QR scan tracking and analytics
- **S3_Commercial** (CPC EUR 25): Marketing Directors, Operations Managers at retail and ecommerce businesses
- **D_Restaurant** (CPC EUR 12): Restaurant Owners, F&B Managers, Hospitality Managers at restaurants, cafes, hotels
- **B_Bulk**: Print Shop Owners, Agency Owners who generate QR codes in bulk for clients
- **A_Dynamic** (high volume): Anyone actively searching for dynamic or editable QR solutions
---
## Step 2 — Find 20 leads
Use both sources below. Deduplicate by email address across both sources. Aim for 20 unique leads total.
### Geographic priority
- **Primary (60%)**: English-speaking markets — US, UK, Australia, Canada, Ireland
- **Secondary (40%)**: EU — Germany, Netherlands, France, Spain, Sweden, Denmark, Belgium
### Source A — Vibe Prospecting
Search the markets above with these filters:
- Industries: restaurants/hospitality, marketing agencies, retail, print/design, events
- Company size: 5200 employees
- Target titles: Owner, Marketing Manager, CMO, Digital Manager, Operations Manager
### Source B — Apollo.io
Search contacts by job title + industry combinations matching each ICP above.
- Verified email addresses only
- Enrich with company website, size, and industry details
**Each lead must have:** first name, last name, email, company name, industry, job title, country, ICP segment, source (Vibe/Apollo).
---
## Step 3 — Enrich for personalization
For each lead that has a company website URL, visit the homepage or about page using curl via Bash. Extract 12 specific details (product focus, tagline, recent launch) to use in the email opening line.
---
## Step 4 — Write personalized cold emails
For each lead, write one cold email:
- **Subject line**: specific and curiosity-driven, max 8 words, zero spam trigger words
- **Opening**: reference the scraped website detail or a specific industry fact (never generic)
- **Pain point** matched to ICP segment:
- Restaurant: customers still googling the menu instead of scanning a QR
- Marketing manager: no way to know which QR code drove conversions vs which was dead weight
- Print shop: clients calling because their QR stopped working after the reprint
- Agency/bulk: spending hours regenerating codes every time a client URL changes
- **Value prop**: QR Master = dynamic QR codes editable after printing + real-time scan analytics per device, country, and time
- **CTA**: single ask — try free at https://qrmaster.net, no credit card needed
- **Tone**: professional but human, max 150 words, no buzzwords, no "I hope this email finds you well"
- **Sign-off**: Timo from QR Master (timo@qrmaster.net)
---
## Step 5 — Save the draft file
1. Get today's date: run `date +%Y-%m-%d` and use as DATE
2. Create `tmp/leads/` if it does not exist
3. Write the file `tmp/leads/DATE-leads.md` with this exact structure:
```
# QR Master Lead Outreach — DATE
**Status: DRAFT — awaiting review**
## Lead Table
| # | Name | Company | Email | Segment | Source | Country |
|---|------|---------|-------|---------|--------|---------|
| 1 | ... | ... | ... | ... | ... | ... |
## Email Drafts
### Lead 1: Full Name — Company Name
**To:** email@address.com
**Subject:** Subject line here
Email body...
---
### Lead 2: ...
```
4. Commit: `git add tmp/leads/DATE-leads.md && git commit -m "leads: add outreach draft DATE"`
---
## Step 6 — Send review email
Send the draft file to timo@qrmaster.net so he can review it in his inbox.
SMTP: host=smtp.qrmaster.net, port=465, secure=true, user=timo@qrmaster.net, pass=fiesta.
From and To: timo@qrmaster.net.
Subject: [QR Master Leads] DATE — 20 new drafts ready for review.
Body: plain text with the full contents of the leads file pasted in.
Use nodemailer. Create tmp/send-review.mjs, run with node, then delete it.
If SMTP fails, skip silently — the committed file is the source of truth.
Output a final summary: leads found per source, file path, whether review email was sent.
---
## Critical rules
- **DO NOT send cold emails to leads.** Only save the file, commit, and send the review email to timo@qrmaster.net. Approval happens in Claude Code CLI.
- If fewer than 20 leads are found, include all you found with a note at the top of the file.
- Do not fabricate leads or email addresses. Only use real contacts from Vibe Prospecting and Apollo.io.