io.github.francofuji/cemis-directorio

Busca empresas del directorio CEMIS combinando filtros con AND. Todos son opcionales. - sector: uno de los valores devueltos por listar_sectores(), o un sector de la taxonomía de matching de reformas (ver impacto_de_reforma()) que todavía no tiene ninguna empresa asignada — en ese caso el resultado es una lista vacía con una nota explicativa, no un error. - provincia: una de las 16 provincias cubanas (ver listar_provincias()). - objetivo: coincidencia parcial contra 'que_busca' de la empresa (ej. 'inversión', 'socio estratégico', 'distribuidor', 'exportar'). - verificada: True para empresas con datos de contacto verificados, False para no verificadas, None (default) para no filtrar. - limite: máximo de resultados a devolver (default 50); el total real de matches siempre se informa en 'total_encontrado' aunque exceda el límite. Devuelve una ficha resumida por empresa, no el perfil completo (usá ficha_empresa() para eso).

Dado un id (ej. 'opp-001') o título (exacto o aproximado) de una oportunidad de negocio, devuelve las empresas del directorio CEMIS relacionadas: primero las curadas a mano dentro de la propia oportunidad, luego las encontradas automáticamente porque su sector matchea por palabra clave con el texto de la oportunidad.

Devuelve las empresas cubanas del sector 'TICs y economía digital' (desarrollo de software, soluciones informáticas, TI y telemática) — el mismo dataset que arma el hub público /empresas-tecnologicas-cuba/ de cemis.io. A diferencia de buscar_empresas(sector="TICs y economía digital"), esta tool también cruza el sector con las reformas del Eje 21 (ámbito digital, IA y economía del conocimiento) y las oportunidades de negocio asociadas a esas reformas — el mismo cruce regulatorio que distingue al hub de un directorio plano. limite: máximo de empresas a devolver en 'empresas' (default 50); el total real siempre está en 'total' aunque exceda el límite.

Devuelve el perfil estructurado completo de una empresa del directorio CEMIS, identificada por su slug (o por nombre exacto/aproximado si no sabés el slug), incluyendo sus oportunidades de negocio relacionadas y las transformaciones/reformas que la afectan. Si no se encuentra, devuelve sugerencias aproximadas.

Herramienta principal: dado el número o título (exacto o aproximado) de una transformación/reforma de 2026, devuelve su impacto sobre el directorio CEMIS. El criterio de impacto varía según la naturaleza de la reforma (ver ambito_transformaciones.py, curado a mano transformación por transformación): - Reformas cuyo alcance real es un TIPO de empresa (estatal/no estatal/ inversión extranjera/cooperativa) matchean por tipo, no por sector, y el resultado lo indica con "criterio_de_impacto": "tipo_de_empresa". - Reformas TRANSVERSALES (fiscales/cambiarias/laborales de alcance nacional, o que explícitamente aplican a "todos los actores económicos") devuelven "alcance": "transversal" con la metadata de la reforma, sin enumerar las 252 empresas del directorio (no aporta valor). - Reformas que NO APLICAN a un actor económico del directorio (reforma de aparato de gobierno, política social para personas, deuda soberana) lo dicen explícitamente en vez de devolver un array vacío sin explicación. - El resto matchea por SECTOR de industria vía EMPRESA_SECTOR_KEYWORDS (mismo criterio que cemis.io, con el fix de normalización de acentos de 2026-08-23 — antes "turis" no matcheaba "turística"). En todos los casos incluye oportunidades_directas (vínculo curado transformacion_num) y el estado de implementación regulatoria si está disponible (ver monitor de reformas de cemis.io).

Devuelve las provincias válidas para filtrar empresas, derivadas de los datos reales del directorio. Usalo antes de llamar a buscar_empresas() con un filtro de provincia.

Devuelve los sectores válidos para filtrar empresas, derivados de los datos reales del directorio (no del formulario web, que puede estar desactualizado). Usalo antes de llamar a buscar_empresas() u oportunidades_por_sector() con un filtro de sector.

Dado un sector (ver listar_sectores(), o un sector de la taxonomía de matching de reformas que todavía no tiene empresas asignadas — ver impacto_de_reforma()), devuelve las oportunidades de negocio relevantes: primero las curadas a mano (vinculadas directamente a alguna empresa de ese sector), luego las encontradas automáticamente por coincidencia de palabras clave de sector (mismo criterio que usa cemis.io). Si el sector no tiene empresas asignadas hoy, 'oportunidades_curadas' sale vacía (no puede haber curadas sin empresas) pero las automáticas por keyword sí pueden aparecer, porque esas se buscan directamente en el texto de las oportunidades/transformaciones, no a través de las empresas.