b2b-lead-hunter

B2B Lead Hunter

Purpose

Research foreign-trade B2B prospects and contact channels for physical-product export, distributor discovery, importer discovery, and outreach preparation.

Hermes owns judgment, evidence review, search iteration, language choice, and approval decisions. Scripts own deterministic normalization, page reading, contact extraction, dedupe, validation, template rendering, draft evaluation, export, and SMTP plumbing.

Default objective: produce a traceable lead file where every company, contact channel, decision maker, score, and outreach draft is tied to source URLs and structured artifacts. Quality gates override target count.

User Workflow Preference

User prefers continuous-cycle execution: mine leads → find decision makers → generate emails → send, all in one loop. Do not pause between stages unless the user explicitly asks to stop. After sending one batch, immediately resume mining the next. The cycle is:

search new leads → get contact emails → send generic emails
    → search decision makers → infer/find DM emails → send DM emails
    → search new leads (next country/niche) → repeat

Do not ask "continue or pause?" after each batch — just keep going until the user says stop.

Non-Negotiable Rules

• Use scripts/read_jina.py as the primary reader for every website or URL: seller site, candidate website, contact page, product page, directory profile, or source article. Use browser tools only when Jina fails or interaction is required.
• Use Hermes native web search for search queries. Do not open Google, Bing, or other search engines in a browser.
• Keep lead discovery, outreach drafting, human approval, and SMTP sending as separate stages with separate files.
• Do not send email unless the user explicitly requests sending, SMTP config exists, approved records exist, suppression checks run, and send_smtp.py receives matching passing evaluations.
• Never auto-send to inferred emails, free-mail addresses, low/reject leads, directory-only leads, records without source URLs, or records without buyer-role evidence.
• A lead cannot enter strict leads.csv unless company reality, buyer-role evidence, contactability, and source URLs are present.
• Do not relax gates to satisfy target_count.
• Directories and B2B platforms are discovery sources, not final truth. Confirm with official or strong independent evidence before accepting.
• Customs/trade evidence is useful buying intent, but absence of customs data is not a rejection reason.
• Every outreach message must include truthful sender identity, source-backed personalization, a low-pressure CTA, and a clear opt-out line.