mcpField
C
classify-leads

classify-leads

github.com/aiagentwithdhruvMarketing & growth2046 installsUpdated 15w ago
Repository

About classify-leads

classify-leads uses Claude to classify leads where keyword matching cannot capture complex distinctions. It reads lead records from JSON and writes classifications to a JSON output file.

Key features

  1. 01Classifies leads with Claude
  2. 02Supports the product_saas type
  3. 03Allows custom classification types
  4. 04Writes results to JSON

Use cases

  1. 01Distinguishing SaaS product firms from consultancies
  2. 02Separating high- and low-ticket businesses
  3. 03Identifying subscription versus one-time payment models

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/aiagentwithdhruv/skills --skill classify-leads

After installing, type/classify-leadsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

scripts/
classify_leads_llm.py
read_sheet.py
update_sheet.py

Details

From the project README

LLM Lead Classification

Goal

Classify leads using Claude for complex distinctions that keyword matching can't handle.

When to Use

  • Product SaaS vs IT consulting agencies
  • High-ticket vs low-ticket businesses
  • Subscription vs one-time payment models
  • NOT for simple categories (dentists, realtors)

Scripts

  • ./scripts/classify_leads_llm.py - Main classification script
  • ./scripts/update_sheet.py - Update sheets
  • ./scripts/read_sheet.py - Read from sheets

Usage

python3 ./scripts/classify_leads_llm.py .tmp/leads.json \
  --classification_type product_saas \
  --output .tmp/classified_leads.json

Performance

  • ~2 minutes for 3,000 leads
  • ~$0.30 per 1,000 leads
  • Default: includes "unclear" classifications (medium confidence)

Classification Types

  • product_saas: Product companies vs service/consulting
  • Custom types can be added

Output

JSON file with classification added to each lead record.

Schema

Inputs
NameTypeRequiredDescription
leads_filefile_pathYesJSON file with lead data
classification_typestringYesClassification type (e.g., 'product_saas')
outputfile_pathNoOutput JSON file path
Outputs
NameTypeDescription
classified_filefile_pathJSON file with classification added to each lead
Credentials
NameSource
ANTHROPIC_API_KEY.env
Composable With

Skills that chain well with this one: scrape-leads, gmaps-leads, instantly-campaigns

Cost

$0.30 per 1,000 leads

Comments

Markdown supported