B2B Lead Hunter

What B2B Lead Hunter does

B2B Lead Hunter splits work between the AI and Python. The agent handles strategy, judgment and language choice, while 18 Python scripts totalling 4,872 lines do the deterministic work of reading, extracting, validating and sending, with schema validation at each stage through contracts.py. The pipeline runs from a product brief through multi-lane search, website reading, contact extraction, scoring, decision-maker discovery and customs signals to outreach templates, personalized drafts, evaluation, approval and SMTP sending.

Every company, contact, score and draft is tied to source URLs, and hard quality gates override target counts, so a lead cannot enter strict output without evidence of the company, a buyer role, contactability and source URLs. Sending is compliance-first, with hash-locked gates, suppression lists, opt-out enforcement and no auto-send to inferred emails. It comes from the team behind b2binsights.io, and the README is available in English and Chinese.

Key features

• Runs as a skill inside Claude Code, Cursor, Cline or Hermes
• 18 Python scripts with schema validation at every stage
• Companies, contacts and drafts tied to source URLs
• Quality gates that override target lead counts
• Hash-locked sending gates, suppression lists and opt-out enforcement
• Customs and import signal checks

When to use it

• Finding overseas buyers and their decision makers for an export business
• Drafting personalized outreach emails with an approval step before sending
• Running a demo pilot with run_hunt.py to see pipeline statistics

Who it is for: Export sales teams, founders and B2B sellers who need traceable, verifiable leads rather than bulk lists.

How it fits with Hermes Agent

Hermes is one of four supported agent platforms, with platform-specific files that adapt the same pipeline to each agent.

Requirements: One of Claude Code, Cursor, Cline or Hermes; Python with the packages in requirements.txt; an SMTP config for sending

Note: The README's quick-start clone command uses the placeholder your-username/b2b-lead-hunter instead of this repository's address.

FAQ