Firmographics

What kind of company is it? How big? Who owns it?

1.B2B or B2C — classify_b2b_b2c

Classifies whether a company is B2B, B2C, BOTH, or unknown from website signals. Uses scraping and LLM classification.

Inputs

Field	Required	Description
website	✅	Company website URL
llm	—	Model override

Outputs

Field	What you get
model_type	B2B, B2C, BOTH, or null
errors	Any issues that came up

🔗 Chain it: clean_website_url → classify_b2b_b2c → enrich_company_firmographics

2.Industry Classification — classify_industry

Classifies company industry in broad or sub-industry mode. Uses company context plus web evidence.

Inputs

Field	Required	Description
company	✅	Company name
mode	—	industry or sub_industry
website	—	Company website
address	—	Location hint
llm	—	Model override

Outputs

Field	What you get
classification	Industry or sub-industry label
errors	Any issues that came up

🔗 Chain it: find_business_website → classify_industry → icp_score

3.Technician Count — count_technicians

Estimates technician headcount using enrichment and search with fallback extraction. Returns count and provenance.

Inputs

Field	Required	Description
website	✅	Company website URL
company	✅	Company name
llm	—	Model override

Outputs

Field	What you get
technicians_count	Estimated technician count
source	Provenance metadata
errors	Any issues that came up

🔗 Chain it: find_business_website → count_technicians → icp_score

4.Company Profile — enrich_company_firmographics

Returns a structured company profile from a website — industry, headcount, revenue, HQ, socials, tech usage, and more.

Inputs

Field	Required	Description
website	✅	Company website URL

Outputs

Field	What you get
company_name	Normalized company name
employees_count	Employee estimate
revenue_annual	Annual revenue estimate
technologies_used	Detected technologies
raw	Full provider payload
errors	Any issues that came up

🔗 Chain it: clean_website_url → enrich_company_firmographics → icp_formula_builder

5.Number of Locations — find_business_location_count

Estimates number of physical locations and returns extracted location list and source URLs.

Inputs

Field	Required	Description
website	✅	Company website URL
llm	—	Model override

Outputs

Field	What you get
location_count	Estimated physical location count
locations	Parsed location objects
source_urls	URLs used for extraction
errors	Any issues that came up

🔗 Chain it: find_business_website → find_business_location_count → get_franchise_status

6.Parent Company / PE — find_parent_company_pe

Finds either a parent company or PE owner using iterative web research.

Inputs

Field	Required	Description
company	✅	Company name
mode	—	parent_company or pe_firm
website	—	Website hint
llm	—	Model override
max_iterations	—	ReAct loop limit

Outputs

Field	What you get
result	Parent company or PE firm
errors	Any issues that came up

🔗 Chain it: find_business_website → find_parent_company_pe → icp_score

7.Primary Market — find_primary_market

Classifies primary customer market (residential, commercial, or industrial) from website evidence.

Inputs

Field	Required	Description
website	✅	Company website URL
llm	—	Model override

Outputs

Field	What you get
market	Primary market label
confidence	Confidence (0–100)
reasoning	Why this classification was chosen
errors	Any issues that came up

🔗 Chain it: find_business_website → find_primary_market → icp_score

8.Franchise Status — get_franchise_status

Classifies a business as franchise, corporate-owned, or independent — with reasoning and optional parent brand.

Inputs

Field	Required	Description
company_name	✅	Business name
website	—	Website hint
llm	—	Model override

Outputs

Field	What you get
status	Franchise status class
confidence	Confidence (0–100)
reasoning	Supporting rationale
parent_company	Parent or brand if found
errors	Any issues that came up

🔗 Chain it: find_business_website → get_franchise_status → find_franchise_contacts