Los 85 tools, uno por uno.

Búsqueda unificada en datos abiertos, trámites, regulaciones, contratos y eventos de riesgo de Ecuador. Úsalo como primer paso para preguntas amplias. Luego profundiza con get_dataset_info, query_resource_data, get_tramite_info, get_regulacion_info, get_contrato_info o search_eventos_riesgo.

Consulta la geografía DPA de Ecuador: provincias, cantones y parroquias (códigos INEC). nivel='provincia' | 'canton' | 'parroquia' | 'auto'. Para parroquias, filtra con canton= y/o provincia= (recomendado).

Busca datasets en el portal de datos abiertos de Ecuador (www.datosabiertos.gob.ec). Es el punto de partida para explorar datos de 98+ instituciones públicas. Usa queries cortos y específicos en español para mejores resultados. Flujo típico: search_datasets → list_dataset_resources → preview_resource_data.

Metadata detallada de un dataset específico del portal de datos abiertos. Devuelve título, descripción, organización, tags, cantidad de recursos, fechas de creación/actualización, licencia, frecuencia de actualización, la URL fuente del publicador (dónde la entidad mantiene el dato original, si existe), y cualquier metadato personalizado que haya agregado.

Lista todos los recursos (archivos) de un dataset con su metadata. Devuelve ID del recurso, título, formato, tamaño, URL de descarga, y fechas de creación/última modificación de cada archivo. Las fechas permiten saber si los archivos de un dataset son snapshots periódicos (comparando last_modified entre recursos para encontrar el más reciente) antes de leer ninguno. También marca grupos de recursos cuyos nombres parecen una serie periódica (ej. archivos semanales) — es solo una pista de que podrían necesitar combinarse o elegir el más reciente; no indica cuál, ya que depende del dataset (algunos archivos periódicos reemplazan a los anteriores, otros los complementan). Siguiente paso: usa preview_resource_data en un recurso CSV para ver su contenido, o get_resource_info para metadata detallada.

Información detallada de un recurso (archivo) específico del portal de datos abiertos. Devuelve formato, tamaño, tipo MIME, URL de descarga, y el dataset al que pertenece. Para archivos CSV, puedes usar después preview_resource_data para ver los datos reales.

Descarga y muestra una vista previa de un recurso del portal de datos abiertos de Ecuador. Soporta CSV/TSV, JSON/GeoJSON, Excel (XLS/XLSX/XLSB), ODS y .zip o .tar.gz que envuelven un CSV/TSV/TXT. Devuelve las primeras N filas como tabla para que el modelo inspeccione los datos sin descargarlos. Las columnas de geometría/WKT se descartan (pueden pesar decenas de KB por celda) y las de notación decimal europea (7.760,2) se normalizan (7760.2). Tamaño máximo de descarga: 5 MB. Para recursos tabulares grandes del DataStore, prefiere query_resource_data.

Descarga los bytes crudos de un recurso del portal de datos abiertos de Ecuador, en base64. Úsalo para formatos que preview_resource_data no puede convertir en tabla (.rar o cualquier formato no reconocido): trae el archivo tal cual en vez de intentar leerlo. Tamaño máximo: 5 MB (el mismo tope que preview_resource_data); los archivos más grandes devuelven un error y la URL directa. Llama con format="json" para obtener el contenido: el default format="text" solo confirma la descarga y nunca incluye content_base64.

Consulta un recurso tabular vía el DataStore de CKAN sin descargar el archivo completo. Preferí esto sobre preview_resource_data cuando el recurso está en el DataStore (la mayoría de los recursos CSV del portal). Soporta búsqueda de texto completo, filtros JSON, orden y paginación.

Cuando un dataset publica un archivo por período (semanal/mensual), no siempre está claro si cada archivo nuevo reemplaza a los anteriores (acumulado, basta con leer el más reciente) o los complementa (incremental, hay que combinarlos todos). Descarga los dos recursos más recientes del grupo de nombre periódico que ya detecta list_dataset_resources, ubica una columna de fecha/período por nombre de encabezado (fecha, mes, año, periodo, semana, ...) y compara qué valores de período aparecen en ambos archivos. Solapamiento alto → acumulado; solapamiento casi nulo → incremental; si no hay columna de período reconocible o el solapamiento es ambiguo, devuelve indeterminado en vez de adivinar. Heurística sobre una muestra de hasta 500 filas por archivo -- confirma con preview_resource_data si el resultado está cerca del umbral.

Busca trámites del gobierno ecuatoriano en el portal oficial gob.ec. Mejor enfoque: da un institution_id para obtener los trámites de esa institución. Agrega un query para filtrar resultados por palabra clave (filtra por nombre y descripción). Cuando se da query junto con institution_id, se recorren TODAS las páginas de trámites de esa institución y se filtran, así que siempre obtienes los resultados más relevantes. IDs de institución comunes: "8" = SRI (impuestos, RUC, facturación), "23" = Registro Civil (cédula, partidas de nacimiento), "48" = ANT (licencias de conducir, matriculación vehicular), "6" = Cancillería (pasaportes, apostilla), "163" = IESS (seguro social, pensiones, fondos de reserva). Usa list_instituciones para encontrar más IDs.

Información detallada de un trámite gubernamental específico. Devuelve nombre, descripción, requisitos, beneficiarios, costo, y la institución responsable. Obtén el tramite_id de search_tramites.

Serie mensual de uso y quejas (atenciones/quejas) de un trámite específico. Distinta de get_tramite_info: aquí está cuántas personas fueron atendidas cada mes y cuántas quejas se presentaron, desde que gob.ec empezó a publicar esto (mediados de 2021). Obtén el tramite_id de search_tramites. No existe un endpoint masivo -- esto trae la serie de un solo trámite a la vez (hoy son unas pocas decenas de meses, sin necesidad de paginación).

Lista o busca instituciones públicas registradas en el portal gob.ec. Si se da un query, busca en todas las instituciones por nombre o siglas. Sin query, devuelve una lista paginada. Instituciones comunes: SRI (ID: 8), Registro Civil (ID: 23), ANT (ID: 48), Cancillería (ID: 6), IESS (ID: 163), Ministerio de Salud, INEC, BCE.

Información detallada de una institución pública registrada en gob.ec. Devuelve nombre, siglas, sector, descripción, sitio web y URL del portal. Obtén el institucion_id de list_instituciones. IDs comunes: SRI=8, IESS=163, Registro Civil=23, ANT=48, Cancillería=6.

Busca en el catálogo ANDA del INEC (anda.inec.gob.ec) de encuestas y censos. ANDA corre sobre NADA (Banco Mundial/IHSN), separado de datosabiertos.gob.ec. Cataloga 437+ encuestas/censos del INEC con metadata (título, año, entidad autora). No todas las entradas tienen microdatos descargables — muchas son publicaciones solo agregadas (ej. índices de precios); cada resultado lo indica. microdatos_disponibles se verifica contra la página de descarga real de cada estudio (verificar_acceso) y tipo_acceso dice cómo se obtienen: directo (archivos en ANDA), enlace_externo (ANDA solo enlaza a otro sitio; p. ej. el Censo 2022 a censoecuador.gob.ec), registro (inicio de sesión en ANDA), solicitud o ninguno. La marca del catálogo por sí sola no es fiable: marca el Censo 2022 como "direct" aunque no tiene archivos adjuntos. Si la verificación falla, el resultado cae a la marca del catálogo con tipo_acceso "desconocido". verificar_acceso="auto" (default) verifica solo los 10 primeros resultados de la página y marca el resto como "desconocido" (con una nota); true los verifica todos (más lento en una página larga: hasta 2 solicitudes por resultado, 8 a la vez); false confía en la marca del catálogo. Las verificaciones se guardan por estudio en disco, así que las búsquedas repetidas son más rápidas. Sigue con get_anda_survey_info(idno) para la metadata completa de una encuesta.

Metadata completa de una encuesta/censo ANDA (INEC) por su idno. Obtén el idno de los resultados de search_anda — es el identificador tipo string (ej. "IDD-ECU-INEC-CGTPE-DECON-ENESEM-2023-v1.3"), no el id numérico. Devuelve alcance/resumen, cantidad de variables, si el microdato es realmente obtenible y cómo (tipo_acceso, verificado en la página de descarga real, con los enlaces externos si los hay; ver download_anda_microdata), términos de confidencialidad, y un email de contacto para pedir datos restringidos cuando no lo son.

Enlaces a los microdatos de una encuesta ANDA y cómo se sirven. Automatiza el paso de términos de uso de un clic de ANDA (uso solo para investigación/estadística, sin reidentificar encuestados, citar la fuente — ver get_anda_survey_info) para revelar la lista. tipo_acceso se lee de la página de descarga real, no de la marca del catálogo: directo (archivos alojados en ANDA, en `archivos`), enlace_externo (ANDA solo enlaza a otro sitio, en `enlaces_externos`; el Censo 2022 apunta a censoecuador.gob.ec), registro (inicio de sesión en ANDA), solicitud (pedido al INEC) o ninguno. Un estudio puede estar marcado "direct" en el catálogo y no tener archivos adjuntos: total_archivos 0 con enlace_externo significa que los datos están en otro sitio; sigue `siguiente_paso` (p. ej. search_archivos(fuente="censo")). Devuelve URLs, no el contenido; los archivos de ANDA suelen ser ZIPs de varios MB.

Busca en el catálogo estadístico del Banco Central del Ecuador (BCE). Cubre estadísticas monetario/financieras, finanzas públicas, sector externo (comercio exterior), y sector real (PIB, empleo/desempleo, confianza del consumidor, producción petrolera, producción de cemento, y más) — cada resultado es un grupo de indicadores (id_grupo) cuya serie de tiempo se obtiene con get_indicador_bce. Algunos grupos tienen una sola serie, otros decenas bajo un título más amplio (ej. "desempleo" es una serie dentro del grupo "mercado laboral", no un grupo propio — también se busca ahí, no solo en títulos de grupo). NO cubre la inflación (IPC) ni las estadísticas de pobreza de Ecuador — esas son del INEC, prueba search_anda. La primera llamada tras expirar el caché (24h) tarda ~10-15s: buscar en nombres de series, no solo en títulos de grupo, implica traer la metadata de cada grupo (~78 grupos) una vez para armar el índice de búsqueda. Se cachea después de eso.

Serie de tiempo de un grupo de indicadores del Banco Central del Ecuador (BCE). Usa primero search_indicadores_bce para encontrar el id_grupo. Frecuencia y unidad varían por grupo (ej. "Mensual"/"Millones de USD" para oferta monetaria, "Trimestral"/"Porcentaje" para crecimiento del PIB) — omitilas para obtener el default del grupo, o revisa el mensaje de error para ver las opciones válidas si te equivocas.

Busca en el directorio de compañías de la Superintendencia de Compañías. Cubre 226k+ compañías con situación legal, fecha de constitución, representante legal, capital suscrito, actividad económica (CIIU) y dirección. La fuente es un export gubernamental que se refresca a diario, cacheado hasta 6h en el servidor — la primera llamada tras expirar el caché puede tardar ~30-40s en descargar y parsear (~35 MB, 226k filas).

Ficha completa del registro de una compañía por RUC (Superintendencia de Compañías). Devuelve situación legal, fecha de constitución, representante legal, capital suscrito, actividad económica (CIIU), dirección y último año de balance. Usa primero search_companias si no tienes el RUC exacto.

Rankea/filtra compañías de Supercías por indicadores financieros de un año fiscal. Filtra por año y/o actividad económica CIIU nivel 1 (una letra, ej. "C" para manufactura), ordenado por cualquier columna de indicador (default: posicion_general, ya precalculado en el dataset). Cada resultado incluye el nombre/RUC de la compañía junto a sus financieros. Cubre todos los años fiscales que publica Supercías, de 2008 al último (metadatos.base_local.anios_disponibles los lista). Los años antiguos traen menos columnas: los ratios financieros empiezan en 2018 y el CIIU en 2009, así que ordenar por un ratio o filtrar por ciiu_n1 en un año sin esos datos devuelve un error que lo explica. 2008-2018 incluyen además compañías sin posición (sin estado financiero ese año), listadas después de las rankeadas. Usa get_financials para el detalle completo de una compañía, o get_compania_info para datos legales/de registro (dirección, representante legal, etc.).

Historial financiero de una compañía a partir de los balances de Supercías. Devuelve ingresos, activos, patrimonio, utilidad, cantidad de empleados y ratios financieros (liquidez, endeudamiento, rentabilidad) por año fiscal, del más reciente al más antiguo. Cubre todos los años fiscales que publica Supercías, de 2008 al último (metadatos.base_local.anios_disponibles los lista; el último puede estar incompleto). Los ratios empiezan en 2018 y el CIIU en 2009; los años anteriores solo traen ingresos, activos, patrimonio, utilidad, impuesto a la renta y empleados. Un año sin estado financiero se marca como tal. Complementa get_compania_info, que tiene datos legales/de registro pero no financieros.

Busca en el registro de auditores externos autorizados (Superintendencia de Compañías). Cubre las 1,447 firmas/personas habilitadas para actuar como auditores externos, con su número/fecha de resolución de autorización y datos de contacto. La fuente es un export gubernamental que se refresca a diario, cacheado hasta 6h en el servidor.

Ficha completa del registro de un auditor externo autorizado por identificación (Superintendencia de Compañías). Devuelve número/fecha de resolución de autorización, nacionalidad, dirección y datos de contacto. Usa primero search_auditores si no tienes la identificación exacta (RUC/cédula).

Busca o lista regulaciones publicadas en el portal gob.ec. Incluye acuerdos, reglamentos y normas relacionadas con referencia al Registro Oficial cuando está disponible. Con un query, recorre varias páginas del lado del cliente (la API no tiene búsqueda nativa). Sin query, devuelve una lista paginada.

Información detallada de una regulación publicada en gob.ec. Devuelve tipo, referencia del Registro Oficial, descripción y URL del PDF/archivo cuando está disponible. Obtén el regulacion_id de search_regulaciones.

Busca procedimientos de contratación pública de Ecuador (SERCOP / datos abiertos OCDS). Útil para periodistas, investigadores y ciudadanos que buscan contratos, licitaciones, compradores o proveedores. Requiere una palabra clave de al menos 3 caracteres. El año por default es el año calendario actual y cae a años anteriores cuando year=0. Los resultados se cachean ~30 minutos; ante un 429 el cliente hace cooldown.

Expediente OCDS completo de un procedimiento de contratación pública (SERCOP). Devuelve comprador, licitación, adjudicaciones, contratos y enlaces útiles cuando están disponibles. Obtén el ocid de search_contratos.

Resume las compras públicas de un comprador (institución) en un año, desde los datos abiertos OCDS del SERCOP. Recorre la misma búsqueda que search_contratos, filtrada por comprador, y totaliza lo leído: número de procesos, monto total (el amount OCDS, valor adjudicado o estimado) y presupuesto, por tipo de procedimiento, por mes y por proveedor, con primera y última fecha. Como comprador es una palabra clave, pueden coincidir varias instituciones ("agua" trae todas las empresas de agua): cada una se resume por separado, de mayor a menor monto, las 10 primeras. Lee hasta 300 procesos (30 páginas); si hay más, el resumen sale marcado parcial con total_en_fuente. Los procesos sin monto se cuentan pero no suman (procesos_con_monto) y una página que falla se lista en paginas_fallidas. Para el expediente de un proceso usa get_contrato_info.

Busca eventos de emergencia/riesgo del COE de la SGR (Gestión de Riesgos). Devuelve eventos recientes registrados como deslizamientos, inundaciones, daños estructurales, con provincia/cantón, estado (Seguimiento/Cierre), impactos y descripción. Los datos vienen del servicio público ArcGIS COE2 (cacheado ~5 minutos).

Lista las estaciones SAT de alerta temprana por tsunami publicadas por la SGR (Gestión de Riesgos). Devuelve códigos de estación y coordenadas del MapServer SAT público.

Busca sismos recientes en Ecuador del Instituto Geofísico (IG-EPN). Devuelve el feed del catálogo sísmico del IG-EPN: magnitud, profundidad, coordenadas, hora local/UTC, estado de revisión y descripción del lugar más cercano, con enlace a la página de cada evento. Los datos se cachean ~2 minutos.

Lista el archivo de dosieres de eventos adversos SITREP ("Informes de Situación") de la Secretaría de Gestión de Riesgos, 2016-2026. Es una fuente distinta de search_eventos_riesgo, que lee el snapshot en vivo de ArcGIS (solo eventos actuales, sin historia). Lista cerca de 54 dosieres multianuales — terremotos, temporadas de incendios forestales, temporadas de lluvia, deslizamientos, actividad volcánica —, cada uno con un estado y su propia página. Continúa con get_sgr_sitrep_archivos(url) sobre la "url" de un evento.

Lista los enlaces a los reportes SITREP en PDF publicados en la página de un evento adverso de la SGR. Devuelve, por reporte, el grupo (el encabezado de sección de la propia página, ej. nacional/provincial/cantonal), el título y la URL directa del PDF. Un evento prolongado puede tener más de 700 PDF; uno cerrado y puntual suele tener muchos menos.

Busca instituciones públicas que publican datos en el portal de datos abiertos de Ecuador. Hay 98+ organizaciones incluyendo INEC, SRI, Ministerio de Salud, BCE, etc.

Información detallada de una institución pública y sus datasets publicados — la forma principal de navegar el catálogo completo de una organización CKAN, incluyendo organizaciones grandes sin tool propia (ej. "sri-servicio-de-rentas-internas" —127 paquetes—, "ministerio-de-economia-y-finanzas" —97—, "ieps" —106—, "cosede" —88—, "ipaip" —70—, "mag" —69—; consigue el slug exacto con search_organizations si no lo conoces). format=json siempre devuelve todos los datasets; format=text limita lo mostrado e indica cuántos más hay — usa query para acotar una organización grande en vez de depender del tope.

Lista todas las categorías temáticas del portal de datos abiertos de Ecuador. Incluye: Salud, Educación, Economía y Finanzas, Seguridad y Defensa, Anticorrupción, Ambiente y Agua, Transporte, Turismo, y más. Cada categoría muestra la cantidad de datasets que contiene. Usa el campo 'name' de la categoría como parámetro 'category' en search_datasets para filtrar resultados por tema.

Detalle de una categoría temática (grupo de CKAN) del portal de datos abiertos. Usa primero list_categories para descubrir IDs de categoría válidos (el campo 'name', ej. 'salud', 'educacion', 'economia-y-finanzas').

Inspecciona una tabla XLSX oficial del boletín IEM más reciente del BCE. Obtén table_id desde search_bce_iem. Las tablas con el diseño común del BCE (períodos en columnas y variables en filas) devuelven series estructuradas y filtrables por fecha. Otros diseños devuelven una vista previa fiel en vez de adivinar columnas silenciosamente. Siempre incluye las URLs del archivo y del boletín del BCE para verificación. Pasa boletin_numero para obtener una versión histórica de las que devuelve search_bce_iem(historico=true).

Obtiene la serie temporal de un indicador diario/mensual del BCE (ej. Riesgo País), acotada a una ventana — nunca la serie completa (algunas superan las 7,000 observaciones). Obtén archivo/codigo primero desde list_catalogo(fuente='bce_diarios') — un codigo solo tiene sentido dentro de su propio archivo. Sin desde/hasta, devuelve las ultimos_n observaciones más recientes (tope 366). Con desde/hasta (YYYY-MM-DD, inclusive), devuelve ese rango en su lugar, también con tope de 366 filas (las más recientes dentro del rango si este es mayor). La respuesta siempre incluye rango_completo (el rango de fechas real y el número de filas de la serie completa) para que la ventana devuelta nunca se confunda con la serie entera. Cada punto en "datos" trae "valor" (un solo número) para casi todos los indicadores, excepto Inflación (datos_ipc.json), que no tiene un valor único — sus puntos traen "valores": {"Mensual":..., "Anual":..., "Acumulada":...} en su lugar.

Busca tablas individuales de Excel en el último boletín IEM del BCE. Úsalo para tablas detalladas del BCE que no están disponibles fácilmente vía search_indicadores_bce/BCEData: comercio por país, deuda, finanzas públicas por nivel de gobierno, petróleo, desagregaciones del PIB, y más. Lista las tablas del boletín mensual vigente; usa get_bce_iem_table con un table_id devuelto para inspeccionar un archivo XLSX oficial. Usa historico=true (o indica desde_anio/hasta_anio) para buscar en todas las páginas de boletines mensuales que coincidan; esto es más lento en la primera llamada porque hay que leer las páginas del archivo histórico. Usa guardar_catalogo=true para persistir el catálogo completo armado por esta búsqueda en IEM_CATALOG_DIR (o data/iem_catalog_snapshots por defecto). La paginación sigue acotando la respuesta del MCP. Usa hash_archivos=true para una auditoría SHA-256 tipo operador de los archivos XLSX descubiertos. Esto descarga los archivos completos, así que es deliberadamente opt-in y está acotado por max_hash_archivos.

Busca en el calendario propio de publicaciones estadísticas del BCE — fechas programadas de publicación del IEM, Cuentas Nacionales, IMAEC, balanza de pagos y más, cada una con categoría, periodicidad, período de referencia y un link directo a su página. Distinto de search_archivos(fuente='bce_publicaciones') (una ventana rodante de ~30 publicaciones ya salidas, sin fechas futuras): este es el calendario propio del BCE, hacia adelante, para todo el año.

Lista las páginas de publicaciones del BCE de un catálogo: indices (boletines sectoriales, índices de precios y de confianza, tipo de cambio, balanza de pagos; algunos desde 2004) o cuentas_nacionales (anuales, trimestrales, regionales, insumo-producto, IMAEC). Siguiente paso: get_bce_pagina_archivos(pagina_id).

Lee la lista de archivos de una página del BCE (pagina_id de search_bce_paginas): título, URL y formato. Para índices también trae año y período (trimestre, mes o semana). Devuelve enlaces, no contenido.

Lista los enlaces directos a archivos publicados en una página de tema estadístico del INEC. Obtén la url desde search_inec_estadisticas. Devuelve boletines técnicos, metodología y series históricas como enlaces directos PDF/XLSX/CSV/ZIP — no el contenido de los archivos. Usa read_pdf en un enlace .pdf, o descárgalo tú mismo para los formatos tabulares. Si la página no lista archivos propios (p. ej. ENDI), se incorporan los de las páginas de ronda enlazadas y se indican en paginas_relacionadas.

Lista los enlaces directos a archivos (PDF/XLSX/CSV/ZIP) incrustados en una publicación del INEC encontrada vía search_inec_publicaciones.

Revisa el BIINEC ("Banco de Datos Abiertos") del INEC en busca de datos que no aparecen en search_anda ni en search_inec_estadisticas. Último recurso para consultas de INEC: BIINEC (aplicaciones3.ecuadorencifras.gob.ec) en su mayoría duplica ANDA y Ecuador en Cifras, así que este tool NO scrapea ni busca en BIINEC en vivo — es una lista pequeña y verificada a mano de los pocos registros confirmados que existen solo ahí (módulos ambientales/administrativos, ej. desechos peligrosos en establecimientos de salud, módulos ambientales de ENEMDU/ECV). Si tu búsqueda no coincide con nada aquí, eso NO significa que BIINEC no tenga nada — significa que no valía la pena automatizarlo; busca directamente en el buscador propio del sitio.

Busca en las páginas de temas estadísticos del INEC (ecuadorencifras.gob.ec). Cubre ~75 temas que publica el INEC (IPC, ENEMDU, ENSANUT, pobreza, comercio exterior, cuentas nacionales, construcción, censos...), separado tanto de search_datasets (CKAN) como de search_anda (el archivo de microdatos del INEC). Aquí es donde viven las series agregadas realmente publicadas — boletines técnicos, metodología y series históricas completas en Excel/CSV — para operaciones que ANDA solo cataloga como metadata sin microdatos descargables (ej. índices de precios). Continúa con get_inec_estadistica_files(url) para los enlaces de un tema.

Busca en todas las publicaciones del INEC en Ecuador en Cifras, vía su API REST pública de WordPress -- siempre actualizada, más recientes primero. Complementa a search_inec_estadisticas: las páginas de tema de ese tool son landing pages curadas que pueden quedar desactualizadas por meses o años aunque el INEC siga publicando la misma operación (confirmado en vivo: la vieja página de tema "Empleo" de ENEMDU se detuvo en abril de 2023 mientras el INEC seguía publicándola mensualmente en posts con fecha que este tool sí encuentra). Usa este tool para preguntas de "cuál es el último boletín/publicación de X". Usa search_inec_estadisticas/get_inec_estadistica_files en cambio cuando quieras la página general fija de una operación en vez de una publicación con fecha específica. Continúa con get_inec_publicacion_archivos(id) para los enlaces de una publicación.

Consultar la información pública de un contribuyente por RUC en el SRI. Devuelve razón social, estado, tipo, actividad económica, fechas de registro y establecimientos públicos registrados. No devuelve declaraciones ni montos tributarios individuales.

Buscar contribuyentes en el RUC del SRI por razón social o nombre comercial (texto parcial), sin necesitar el RUC exacto de antemano. Complementa get_sri_ruc_info (que requiere el RUC exacto) para el caso "conozco el nombre de la empresa, no su RUC". Cada resultado incluye estado, tipo de contribuyente, régimen, actividad económica, representantes legales, y si es agente de retención/contribuyente especial/fantasma — no declaraciones ni montos tributarios individuales. El SRI limita esta búsqueda a 100 coincidencias por consulta; si total_reportado sale en 100, puede haber más contribuyentes de los que realmente se están devolviendo — usa un texto más específico para acotar.

Descarga y previsualiza un documento de la Contraloría (Datos Abiertos o Plan Anual de Control). Obtén informe_id desde list_catalogo(fuente='contraloria'). Los documentos trimestrales "Datos Abiertos" devuelven una fila por cada informe de auditoría aprobado ese trimestre, para cualquier institución pública del país. Los documentos "Plan Anual de Control" son PDFs (uno por año); esto devuelve su metadata y te dirige a read_pdf en vez de una tabla.

Lista los enlaces directos a los PDF mensuales del "Resumen de Indicadores" de SIPA para un año dado, alcanzado desde el tablero dinámico de "Indicadores Sectoriales" (sipa.agricultura.gob.ec). Confirmado en vivo 2018-2026; cada año es una página separada y las convenciones de nombre de archivo cambian entre años. Otros elementos del mismo tablero son incrustaciones de Tableau Server o flipbooks en JS sin archivo directo — ninguno de esos está cubierto por este tool.

Obtiene un tablero del snapshot en vivo de la operación de la red eléctrica de CENACE (el operador nacional de Ecuador) — mezcla de generación y demanda, siempre al instante. Tableros: - produccion_tiempo_real: instante actual. - demanda_tiempo_real: instante actual, más el desglose en MW por distribuidora (empresa eléctrica/CNEL). - operativa_diaria: total del día completo de ayer. - acumulada_mensual: total del mes a la fecha (MWh). - acumulada_anual: total del año a la fecha (GWh). Cada uno devuelve un "resumen" (producción total/exportación/importación/hidráulica/térmica/renovable no convencional, o el equivalente de demanda). No hay consulta histórica aquí — la página de CENACE no tiene selector de fecha, solo estas 5 vistas al instante.

Lee el "Boletín y Estadística Mensual de Transacciones Comerciales" de CENACE, el informe mensual del mercado eléctrico ecuatoriano (enero 2019 en adelante, con un mes de rezago aproximado). Cada número cubre el mes y el acumulado del año: producción por recurso (hidráulica, térmica por combustible, renovables no convencionales, importaciones), demanda comercial por distribuidora (unidades de CNEL y empresas eléctricas), autogeneradores, precios medios en USD¢/kWh y las transacciones internacionales con Colombia y Perú. Nada de esto está en los datasets CKAN de CENACE. CENACE publica los números solo como flipbooks de FlipHTML5; el tool lee el índice de texto del flipbook, así que las tablas llegan como filas de texto ("CNEL GUAYAQUIL 3 036.06 39.1%", miles separados por espacio) y no como columnas, y los gráficos solo traen sus etiquetas.

Descarga y extrae el texto de un informe del IG-EPN encontrado vía search_informes_igepn. El IG-EPN no tiene una URL estable por informe (cada descarga es un envío de formulario atado a una sesión), así que este tool vuelve a ubicar el informe por nombre/año/grupo exactos y transmite su PDF directamente -- pasa `volcan` para desambiguar cuando dos informes comparten el mismo nombre el mismo día (pasa con los informes diarios volcánicos).

Lista las columnas/medidas/niveles de fecha consultables de un tablero Power BI del SUT, descubiertos desde la definición propia del reporte (la consulta subyacente de cada visual), no por adivinanza. Un campo como "public contratos.nombre_padre_activ_econ_empresa" es una columna plana usable en campos o filtros de query_sut_indicador; uno que termina en "[medida]" es una medida agregada (válida solo en campos, nunca en filtros); uno que termina en "[Año]"/"[Mes]" es un nivel de jerarquía de fecha. denuncias_publico y encuentra_empleo usan un formato de reporte más antiguo donde los visuales no exponen su consulta de esta manera — sus campos vienen de un conjunto pequeño capturado a mano (recuperado navegando el tablero en vivo y leyendo las consultas que realmente envía), no de este descubrimiento automático, pero aparecen aquí igual que cualquier otro campo. Los tableros de la Judicatura (fuente="judicatura") exponen agregados como "[suma]"/"[promedio]" (ej. "CUB EST_CUB_AUDIENCIAS.Contador [suma]"), válidos solo en campos, como los "[medida]".

Ejecuta una consulta en vivo contra el modelo de datos subyacente de un tablero Power BI del SUT — cualquier combinación de sus campos, ej. mes E industria juntos para "contratos" (una serie temporal mensual real desde 2015 por industria CIIU, provincia, género, estado del contrato — nada de esto está en los datasets CKAN de ministerio-del-trabajo, que son un solo conteo de stock actual sin dimensión de tiempo). Obtén los campos válidos desde get_sut_indicador_schema(indicador) primero — un nombre de campo no reconocido levanta un error que indica qué tool llamar en vez de adivinar. filtros solo acepta campos de columna plana (no campos "[medida]"/de jerarquía) y compara igualdad de texto exacta, ej. {"public contratos.Estado contrato": "Vigente"}. Las filas pueden llegar a los miles para un desglose amplio (ej. cada mes x cada industria) — acota con filtros o menos campos en vez de subir limite más de lo necesario; el formato "json" es exacto pero sigue sujeto al mismo tope de limite. fuente="judicatura" consulta los tableros del Consejo de la Judicatura (ej. audiencias por año y provincia: campos "CUB EST_CUB_AUDIENCIAS.Periodo [Año]" y "CUB EST_CUB_AUDIENCIAS.Contador [suma]"). Con fuente cfn consulta el tablero de la CFN, p. ej. garantías por provincia con los campos "Garantias FNG.nombre_provincia" y "Medidas FNG.Monto Garantizado (USD) [medida]".

Busca en el archivo de informes PDF del IG-EPN (Instituto Geofísico): boletines sísmicos diarios/semanales/mensuales/especiales, alertas volcánicas "IG Al Instante", informes de campo/anuales, etc. A diferencia de search_sismos, que lee el feed crudo del catálogo sísmico, este busca en el archivo narrativo de informes PDF. Usa get_informe_igepn después para descargar y leer el texto de un informe.

Lista los cortes programados de una distribuidora: los PDF de las crisis de eeq (Quito, 2023-2024) y centrosur (Azuay, Cañar, Morona Santiago, desde 2023), o los avisos vigentes de mantenimiento de emelnorte (Imbabura, Carchi, norte de Pichincha, los 100 más recientes), elecgalapagos (por isla, los 100 más recientes) y eeasa (Tungurahua y Pastaza, los próximos días, sin archivo histórico). Es regional, no nacional. Siguiente paso: get_cortes_horarios con el `archivo`.

Convierte un cronograma o aviso de cortes (`archivo` de search_cortes) en filas con fecha, horario sin energía, sectores y la ubicación que publica la empresa (EEQ: subestación; CentroSur: provincia/cantón/zona; ElecGalápagos: isla). Los avisos de mantenimiento agregan `motivo`; los de Emelnorte publicados solo como imagen devuelven los enlaces en `imagenes`. El parámetro query filtra por lugar.

Ejecuta un reporte del generador de ARCONEL y devuelve sus filas, p. ej. «Balance Energía» 2023: energía recibida, vendida y perdida por mes y distribuidora, con porcentajes de pérdida técnica y no técnica. Es lento (unas 50 filas por página): max_paginas limita el trabajo y `completo` indica si se leyó todo.

Atajo de investigación en un solo paso: busca un dataset, lista sus recursos, y previsualiza los datos reales del más prometedor -- el flujo search_datasets -> list_dataset_resources -> preview_resource_data en una sola llamada, para el caso común de "encuéntrame datos sobre X y muéstrame qué hay dentro". Elige el resultado de búsqueda mejor rankeado y, entre sus recursos, el primero en un formato que este servidor puede parsear a una tabla (CSV/JSON/XLS/XLSX/XLSB/ODS/ZIP/TARGZ), saltando los ilegibles (.rar, formatos no reconocidos) en vez de previsualizar el que aparezca primero en la lista. No reemplaza a los tools individuales: si el resultado top no es el dataset correcto, o necesitas un recurso específico dentro de él, usa search_datasets/list_dataset_resources/preview_resource_data directamente en vez de repetir esta llamada.

Lista los archivos miembro (nombre, tamaño) de un .zip desde una URL directa, sin descargar el archivo completo. Lee solo el registro End Of Central Directory y el directorio central vía peticiones HTTP Range, así que funciona para archivos mucho más grandes que el tope de 5 MB de preview_resource_data/download_resource -- ej. ZIPs de microdatos de INEC o del censo de varios cientos de MB. Requiere que el servidor respete peticiones Range; falla con un error claro si no. Soporta ZIP64 (más de 4 GB o de 65535 archivos). Listar los nombres es barato de esta forma, pero previsualizar las filas de un miembro específico no lo es (igual hay que descomprimir desde el offset de ese miembro en adelante) -- este tool solo lista metadata; para leer las filas de un miembro usa read_zip_member, que baja solo los bytes de ese archivo.

Lee las filas de UN archivo dentro de un .zip remoto sin descargar el .zip. Primero usa list_zip_contents para obtener el nombre exacto del miembro. Lee el directorio central del .zip y luego baja solo la cabecera local y los bytes comprimidos de ese miembro vía peticiones HTTP Range, así que funciona dentro de archivos mucho más grandes que el tope de 5 MB de preview_resource_data/download_resource -- ej. los 90 tabulados CSV de la ENDI R3 del INEC. Límites: el servidor debe respetar HTTP Range (responder 206); el miembro debe pesar como máximo 5 MB comprimido; los CSV/TSV/TXT se cortan a 5 MB descomprimidos (marcado como truncado) y las hojas de cálculo deben caber en 20 MB descomprimidas porque no se pueden abrir incompletas; solo miembros sin comprimir o deflate, sin cifrado; ZIP64 soportado. Formatos: .csv, .tsv, .txt, .xlsx, .xls, .xlsb, .ods (primera hoja). Verifica el CRC32 cuando el miembro se lee completo. Busca el nombre exacto, luego una coincidencia única sin distinguir mayúsculas o por nombre base; si no encuentra, el error sugiere nombres parecidos. En tabulados con un bloque de título arriba (INEC, BCE) detecta la fila de encabezado real (la primera al menos la mitad de llena que la más llena de las primeras 30), devuelve las filas de título en preamble y elimina las columnas vacías; skip_rows=0 conserva la fila 1 y skip_rows=n salta n filas.

Extrae texto de un documento PDF en una URL directa. Útil para PDFs enlazados desde el resultado de otros tools, ej. el archivo del Registro Oficial de get_regulacion_info, o un recurso de dataset que resultó ser un boletín PDF en vez de un archivo tabular. Sin OCR: un PDF escaneado sin capa de texto embebida vendrá vacío. Tamaño máximo de descarga: 5 MB (los archivos más grandes devuelven un error explícito en vez de una lectura parcial -- los PDF no se pueden parsear desde una descarga truncada); máximo 20 páginas extraídas por llamada (vuelve a llamar con un rango de `pages` distinto para el resto).

Lista los documentos reales de una colección del IESS, cada uno resuelto a su URL de descarga directa, título y formato. Llama primero a list_catalogo(fuente='iess') para ver qué años y cantidades tiene disponible cada colección.

Consulta el Certificado de Cumplimiento de Obligaciones Patronales público del IESS (sin login) e indica si el empleador registra obligaciones en mora. Si el texto del certificado no se puede interpretar, el estado se reporta como NO DETERMINADO. No devuelve número de empleados: el IESS no publica esa cifra por empresa; usa el campo n_empleados de get_financials/search_ranking (autorreportado a Supercías).

Consulta el sitio IFIS de la DGAC (ais.aviacioncivil.gob.ec), público y sin login. metar: reportes METAR/SPECI más recientes de un aeródromo (tipo, hora UTC, texto OACI crudo; normalmente cada hora). notam: NOTAM activos de un aeródromo con su serie (p. ej. A1784/26), el texto Q)/A)/B)/C)/D)/E) y los campos que decodifica la DGAC; para la ficha fija usa get_aip_aerodromo. sigmet: SIGMET activos (ceniza volcánica, turbulencia, engelamiento, tormentas) de la única FIR de Ecuador (SEFG); cero resultados significa que no hay ninguno activo. Un designador desconocido devuelve un resultado vacío, no un error.

Lista los designadores ICAO y nombres de todos los aeródromos y helipuertos con una página AIP AD 2.x publicada, tomada del eAIP público de la DGAC (ais.aviacioncivil.gob.ec/ifis3), sin necesidad de login. Usa get_aip_aerodromo con uno de estos designadores para obtener la ficha completa (coordenadas, pista, horarios, tarifas, frecuencias ATS, etc.).

Obtiene la ficha AIP AD 2.x publicada para un aeródromo o helipuerto ecuatoriano, desde el eAIP público de la DGAC. Devuelve los campos numerados que publica el AIP, agrupados por las subsecciones del Anexo 15 de la OACI: ubicación y datos administrativos (coordenadas ARP, elevación, variación magnética, contactos del operador), horarios de operación, servicios de extinción de incendios y rescate, datos de plataforma y calles de rodaje, ayudas de radionavegación, características físicas de pista, distancias declaradas, iluminación, procedimientos de vuelo e información suplementaria. Usa list_aip_aerodromos para ver qué designadores están publicados.

Lista las bases de datos mensuales de infoMIES (info.desarrollohumano.gob.ec, portal de estadísticas del antiguo MIES) para un programa: "anc" o "is". Es más detallado que la cobertura CKAN existente de este proyecto para los mismos programas, que solo tiene cortes trimestrales. Confirmado en vivo: solo el año en curso tiene un archivo por mes hasta la fecha; cada año cerrado (2019-2025) tiene exactamente un archivo, el corte de diciembre. Los archivos son .rar (fuera del soporte de formatos de este proyecto por riesgo de subprocess/CVE) — se devuelven metadatos y la URL directa, no el contenido.

Lista los archivos de boletines zonales de infoMIES. Hay dos series distintas bajo este nombre: "zonal" (default), la serie original "Boletín Zonal" (un .rar por zona y mes), DESCONTINUADA (2017-2021, nada desde entonces); "consolidado", el sucesor "Reporte Boletines Zonales" (un XLSX consolidado por año, 2021-2026, sigue actualizándose). Ambas series devuelven metadatos y URLs directas, nunca contenido — los .rar quedan además fuera del soporte de formatos de este proyecto.

Busca datos de siniestros de tránsito en Ecuador. ant.gob.ec no es accesible, así que combina las publicaciones trimestrales y anuales del INEC (tabulados XLSX y microdatos, construidas con registros de la ANT) con datasets CKAN (fallecidos SPPAT, ANT). Si una fuente falla, la otra responde y el fallo aparece en `avisos`.

Busca en el catálogo completo de indicadores de CEPALSTAT (la API pública de estadísticas de CEPAL, api-cepalstat.cepal.org) por nombre — 2.059 indicadores en Demográficos y sociales, Económicos, Ambientales y Temas transversales (incluye los ODS). NO es una fuente exclusiva de Ecuador: CEPALSTAT es el catálogo regional de CEPAL para toda América Latina y el Caribe. Úsalo para encontrar el indicator_id, y luego get_cepalstat_indicador para obtener las observaciones de Ecuador específicamente.

Obtiene las observaciones de un indicador de CEPALSTAT, filtradas a un país (Ecuador por defecto) para mantener la respuesta chica — la API cruda de CEPAL devuelve todos los países de la región (y a menudo del mundo) por indicador si no se filtra, confirmado en vivo en ~2.5 MB sin filtro vs. ~85 KB filtrado a un país. Consigue el indicator_id con search_cepalstat_indicadores. Cada registro devuelto decodifica los ids de dimensión crudos de CEPALSTAT a etiquetas legibles (ej. "Sexo": "Mujeres", "Años": "1975") usando el propio catálogo de dimensiones de ese indicador — no todos los indicadores tienen las mismas dimensiones (algunos son solo país × año, otros agregan sexo, grupo de edad, etc.).

Trae una serie de una fuente internacional filtrada a Ecuador. wdi: World Development Indicators del Banco Mundial (más de 1.400 series anuales); con indicador (p. ej. EG.ELC.ACCS.ZS acceso a electricidad) devuelve la serie, con solo query (en inglés) busca en el catálogo; los años sin valor se omiten y se cuentan. irena: capacidad instalada (MW) y generación (GWh) por tecnología de IRENASTAT, desde 2000, conectada o no a la red. xm: energía horaria en la interconexión Colombia-Ecuador según XM, sumada por día o mes desde 2003; requiere desde y hasta (máximo 366 días); los días sin flujo aparecen con 0 GWh, así que la suspensión de octubre de 2024 se ve como ceros. comtrade: comercio de mercancías de Ecuador con un socio en USD (UN Comtrade, vista previa pública sin clave): un solo período por llamada (periodo), tope de 500 filas, un límite de ~1 llamada cada 2 s que se reintenta solo, y solo códigos (sin nombres); socio 0 = Mundo, cmd = TOTAL o código HS. imf: estadísticas del FMI vía SDMX (190 flujos: precios, balanza de pagos, tipo de cambio, finanzas públicas, dinero y banca); indicador es el id del flujo (vacío con query lista los flujos) y clave la clave SDMX, cuyo orden de dimensiones cambia por flujo y viene en la respuesta; sin clave trae todo el país, con las últimas observaciones. who: Global Health Observatory de la OMS (~3.000 indicadores anuales por sexo y edad, p. ej. WHOSIS_000001 esperanza de vida al nacer); vacío con query busca indicadores. ilo: estadísticas laborales de ILOSTAT (>1.200 flujos, p. ej. UNE_DEAP_SEX_AGE_RT desempleo por sexo y edad); las claves cortas se completan con comodines. unhcr: población refugiada y solicitante de asilo en Ecuador por año, desde desde/hasta; socio = país de origen (VEN) o 'todos' para una fila por origen. Fuente ember: datos eléctricos de Ember vía Our World in Data (CC BY 4.0), anuales o mensuales desde 2019: generación y participación por fuente, per cápita, demanda, importaciones netas e intensidad de carbono; indicador = métrica/fuente (generation/hydro, by_source/total, carbon_intensity).

Busca en el catálogo de archivos de una institución y devuelve enlaces directos (título, URL, formato), no el contenido. Fuentes: sri_datasets, sri_recaudacion, mef, senae, censo, minedec, senescyt, msp, cnig, trabajo_boletin, salarios, arcotel_boletines y arcotel_mensuales. Fuente censo (censoecuador.gob.ec): ~100 archivos con `tipo` tabulado, microdatos, diccionario o documento; los tabulados de resultados por tema (población, vivienda, hogar) en XLSX o CSV en ZIP — el de TIC en hogares (celular, internet, computadora, tablet por provincia y cantón) sale con query "internet" o "tic" —, las bases de microdatos por cantón, sector y manzana (CSV, SPSS, REDATAM) y los diccionarios. Descarga con download_resource o read_pdf (tope de 5 MB). Fuente turismo: boletines mensuales del Boletín de Cifras del Sector Turismo (noviembre 2025 en adelante), ahora publicados por el Ministerio de Producción; solo PDF, read_pdf extrae las tablas. Fuente fedexpor: el Reporte Estadístico Expordata de FEDEXPOR, comercio exterior mensual desde enero 2026, en Google Drive (~30 MB, sobre el tope de read_pdf; descarga_directa es el enlace directo). Fuente aeade: boletines mensuales de ventas de vehículos de AEADE (tipo boletin_ventas) y anuarios del sector (tipo anuario). Fuentes nuevas: arcotel_series (el XLSX más reciente de cada una de 25 series estadísticas de ARCOTEL, cada uno con historia completa), msp_precios (precios techo de medicamentos, cada revisión desde 2016), mit_vias (informe diario de la Red Vial Estatal del MIT) y minedec_bases (registros AMIE por año lectivo 2009-2010 a 2024-2025, Inicio y Fin, en XLSX y CSV, más archivos temáticos).

Lista las secciones del archivo documental de una institución: registro sanitario de ARCSA, estadísticas de Superbancos y SEPS, bases de INEVAL, bibliotecas de la SGR, de Educación Superior y de CENACE, estadísticas agropecuarias del SIPA, Cifras Institucionales de EP Petroecuador, estadísticas de hidrocarburos y minería del Ministerio de Ambiente y Energía, bases electorales del CNE, o estadísticas de las bolsas de valores de Guayaquil y Quito. Siguiente paso: get_archivo_seccion(fuente, seccion).

Lista los archivos de una sección obtenida con list_archivo_secciones. Cada archivo trae título, URL y formato, más contexto propio de la fuente (grupo, período, subgrupo, descripción). Devuelve enlaces, no contenido; descarga los archivos grandes directamente (los tools de vista previa y descarga tienen un tope de 5 MB).

Lista el catálogo de una fuente que no tiene filtros, el paso previo a su tool get. arconel: tipos de reporte del sector eléctrico por sección, años (desde 1998) y grupos de empresas; sigue con get_arconel_reporte. bce_diarios: widgets de indicadores diarios/mensuales del BCE fuera de BCEData (riesgo país diario desde 2004, oro, WTI, bonos, pagos, reservas, series fiscales y externas); un codigo solo tiene sentido dentro de su archivo; sigue con get_bce_indicador_diario(archivo, codigo). contraloria: CSV trimestrales de informes de auditoría aprobados y planes anuales de control; sigue con get_contraloria_informe. iess: colecciones de documentos del IESS (boletines estadísticos, estudios actuariales, informes de auditoría) con años y conteos; sigue con get_iess_archivos(coleccion, anio). sut: tableros Power BI del Ministerio del Trabajo (contratos desde 2015, demanda laboral, política de género); sigue con get_sut_indicador_schema y query_sut_indicador. judicatura: tableros Power BI del Portal de Estadística Judicial del Consejo de la Judicatura (audiencias, boletas, capacitaciones, destituciones, escritos, mediación, notarial, productividad de jueces, remates judiciales, SUPA pensiones alimenticias); sigue con get_sut_indicador_schema(indicador, fuente="judicatura") y query_sut_indicador. Fuente cfn: el tablero Power BI de estadísticas de la Corporación Financiera Nacional (líneas de crédito, desembolsos y operaciones por provincia, inclusión financiera, estados financieros mensuales, inversiones, garantías del Fondo Nacional de Garantías).

Busca en el catálogo de capas de un geoportal: inamhi (normales de precipitación, anomalías, grillas WRF, cuencas), mag (zonificación agroecológica, cobertura, censos agropecuarios, catastro rural), arconel (balance de energía y pérdidas por distribuidora y mes 1999-abr 2024, facturación, recaudación, subsidios y clientes 1999-2025, centrales, líneas, subestaciones, áreas de servicio) o celec (centrales de CELEC y red de transmisión SNT de marzo 2025; las capas de Survey123 se excluyen a propósito). Cada capa trae `capa`, el id que recibe get_capa_geo_datos. Fuente igm: 737 capas WFS de cartografía oficial del Instituto Geográfico Militar (68 nacionales 1:1M de 2024, 505 a 1:50.000 y 164 a 1:25.000; el espacio reservado igm_reservada queda fuera); categoria elige la escala (nacional, 50k o 25k). Fuente msp: 9 capas ArcGIS Online del Ministerio de Salud Pública (6.411 establecimientos de la red pública, establecimientos MSP, 18 indicadores de salud sexual y reproductiva por cantón 2018-2026, atenciones y egresos por establecimiento desde 2019, fecundidad, vacunación COVID cantonal, áreas EAIS, distritos).

Trae los atributos de una capa de search_capas_geo, sin coordenadas de geometría. En inamhi y mag es una muestra por WFS GetFeature, sin filtros; las capas sin WFS devuelven error. En arconel y celec es una consulta ArcGIS REST: `filtro` es una cláusula SQL sobre los campos de la capa (listados en `campos`), p. ej. "Anio = 2024 AND IdMes = 4" o "Empresa LIKE 'CNEL%'"; `total_features_en_capa` cuenta las filas que cumplen el filtro y `hay_mas` indica si seguir con `offset`. Las fechas llegan como fechas ISO. Para igm la muestra trae solo atributos (DescribeFeatureType y GetFeature con propertyName), sin geometría: una provincia pesa ~1,5 MB.