business_diagnose

Expert business diagnosis for any company across 11 dimensions.

Send what you know — tools they use, team size, revenue, pain points, location, industry, leadership situation, cash flow, talent gaps, physical operations, anything. Returns Revenue Leak Score + actionable recommendations comparing paid software, open source alternatives, and professional implementation services.

Works for ANY industry. The more context you provide, the more accurate and specific the diagnosis. Even minimal input (just company_name + industry) produces useful results.

11 dimensions analyzed: finanzas, comercial, operaciones, equipo, tecnologia, marketing, clientes, proveedores, legal, estrategia, marketing_digital.

Args: company_name: Name of the company being diagnosed (required). industry: Industry or sector (e.g. 'construction', 'healthcare', 'ecommerce'). Use list_industries to see calibrated benchmarks. team_size: Number of employees (0 if unknown). location_city: City where the company is based. location_country: Country where the company is based. revenue_estimate: ANNUAL revenue range (e.g. '200k-1m', '1m-5m', 'over_10m'). Used to scale the monthly leak estimate. Accept also revenue_range as alias. software_detected: Comma-separated tools/software the company uses (e.g. 'Excel, WhatsApp, QuickBooks, no CRM'). pain_points: Comma-separated problems described by the company (e.g. 'quotes get lost, manual reporting, slow hiring'). physical_operations: Notes on physical/operational challenges (e.g. 'material waste, rework, production delays'). supply_chain_notes: Notes on supply chain or vendor issues (e.g. 'unreliable suppliers, delivery delays'). hiring_challenges: Notes on hiring difficulties (e.g. "can't find skilled workers, high turnover"). skill_gaps: Notes on skill gaps in the team (e.g. 'no data analyst, no digital marketing'). cash_flow_concerns: Notes on cash flow or payment issues (e.g. 'clients pay late, 60+ day invoices'). ar_aging: Accounts receivable aging notes (e.g. '30%% of invoices over 90 days'). decision_maker_role: Role of the person requesting the diagnosis (e.g. 'CEO', 'COO', 'VP Operations'). stress_indicators: Signs of leadership stress or burnout (e.g. 'working weekends, micromanaging, decision fatigue'). growth_stage: Current business stage (e.g. 'growing', 'stagnant', 'declining', 'startup', 'scaling'). niche: Hyper-specific niche/sub-vertical in free text (e.g. 'B2B SaaS for dental clinics', 'modular construction for retail'). Captured for niche targeting and trend analysis. additional_context: Any other relevant information as free text or JSON. contact_email: Email for follow-up (optional, for lead capture). contact_name: Contact name (optional). lang: Language for the diagnosis ('es' for Spanish, 'en' for English).

Returns: dict: Complete diagnosis containing: - company_name (str): Company analyzed - icp_id (str): Detected industry profile - health_score (float): 0-100 Business Health Score — HIGHER = HEALTHIER. A low score marks the worst area / biggest opportunity. (Also mirrored as revenue_leak_score for backward compatibility, same value.) - score_meaning (str): How to read the score (incl. the "100% = new leagues" idea) - growth_mode (bool): True when most areas are strong — keep the conversation going - guidance (str): What to do next (ask more vs. present + 3 options) - estimated_monthly_leak (str): Estimated monthly revenue leak in weak areas - dimensions (list): Per-dimension scores and findings - actions (list): Prioritized recommendations with triple option - validation_questions (list): Questions to refine the diagnosis - summary (str): Executive summary - leadership_insight (str): Leadership-specific observation

On rate limit:
    - error (str): 'rate_limit_exceeded'
    - message_es / message_en (str): Localized error message
    - upgrade_url (str): Registration URL