Research workflows

# 1. Resolve the place to a canonical filter (NATIVE name — see note)
resolve_location(query="Bayern")
#   → state "Bayern" · filter {"state": ["Bayern"]} · 324,463 orgs

# 2. Size the sector in that region (exact, deterministic)
aggregate_organizations(
    country=["Germany"], state=["Bayern"],
    nace_code=["NACE C: Manufacturing"], group_by="organization_size",
)
#   → Small 14,462 · Micro 12,457 · Medium 2,932 · Large 1,692  (~31.5k manufacturers)

# 3. Pull the actual players (niche-finder pattern, scoped to the region)
search_organizations(
    query="manufacturer of battery cells, modules and packs for EVs and energy storage",
    keywords_must_all=["battery"], state=["Bayern"],
    nace_code=["NACE C: Manufacturing"], size=10,
)
#   → Smart Battery Solutions, LION Smart, A² Battery Solutions, CATL (Bavaria), BMZ Group

# 4. Drill into one for a full profile
get_organization_details(domains=["lionsmart.com"])
#   → LION Smart GmbH · Garching b. München · NACE C · battery/BMS/e-mobility keywords

# 1. Find lookalikes by embedding similarity
find_similar_organizations(
    domains=["celonis.com"], exclude_domains=["celonis.com", "celonis.de"],
    min_score=0.6, size=15,
)
#   → Mimica, mindzie, iGrafx, ARIS, Wang Fan Xin … (the process-mining cluster)

# 2. (optional) Size the cluster by geography or scope it
#    aggregate_organizations(nace_code=[...], group_by="country")

# 3. Hydrate the shortlist for outreach / analysis
get_organization_details(domains=["mimica.ai", "mindzie.com", "igrafx.com"])