Referencia

Los 90 tools, uno por uno.

Encuentra un tool por nombre, fuente o tarea. Abre solo el grupo y el detalle que necesitas.

90 tools · abre un grupo para ver sus detalles.

Entrada unificada2 Mostrar
search_ecuador Busca a la vez en datasets, orgs, trámites, regulaciones, contratos y riesgos.

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.

ParámetroTipoDefaultDescripción
querystrrequeridoTérminos de búsqueda en español (ej. "salud", "RUC", "medicinas")
limitint5Máximo de resultados por sección (default 5, máx. 10)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
lookup_ubicacion Provincias, cantones y parroquias (código INEC, región, población).

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).

ParámetroTipoDefaultDescripción
querystrvacíoNombre o código (ej. "Pichincha", "Cuenca", "Tumbaco", "170150")
regionstrvacíoRegión natural opcional para provincias/cantones
provinciastrvacíoFiltro opcional por provincia
cantonstrvacíoFiltro opcional por cantón (útil para parroquias)
nivelLiteral['auto', 'provincia', 'canton', 'parroquia']autoauto | provincia | canton | parroquia
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
Datos Abiertos8 Mostrar
search_datasets Buscar datasets por palabras clave. Soporta filtro por categoría.

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.

ParámetroTipoDefaultDescripción
querystrvacíoPalabras clave (ej. "empleo", "salud", "presupuesto", "SRI recaudación")
pageint1Número de página (base 1, default: 1)
page_sizeint20Resultados por página (default: 20, máx. 100)
categorystrvacíoFiltro opcional por categoría (ej. "sal" para Salud, "edu" para Educación). Usa list_categories para ver todas las categorías disponibles.
sortLiteral['relevance', 'recent']relevance`relevance` (default, ranking propio de CKAN) o `recent` (más recientes primero por metadata_modified; sirve sin query para descubrir datasets nuevos o actualizados).
sourceckan_client.CkanSourcenacional"nacional" (default, www.datosabiertos.gob.ec), "cuenca" (cuencaendatos.cuenca.gob.ec, portal municipal independiente), "latacunga" (datosabiertos.latacunga.gob.ec, portal municipal independiente) o "iadb" (data.iadb.org, portal de datos abiertos del BID — NO es exclusivo de Ecuador, es un catálogo regional/global: Latin Macro Watch e indicadores del Banco Mundial/BID)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_dataset_info Metadata detallada de un dataset: título, descripción, organización, tags, licencia, fechas.

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.

ParámetroTipoDefaultDescripción
dataset_idstrrequeridoEl ID o slug del dataset (ej. "registro-estadistico-de-recursos-y-actividades-de-salud-2019")
sourceckan_client.CkanSourcenacional"nacional" (default, www.datosabiertos.gob.ec), "cuenca" (cuencaendatos.cuenca.gob.ec, portal municipal independiente), "latacunga" (datosabiertos.latacunga.gob.ec, portal municipal independiente) o "iadb" (data.iadb.org, portal de datos abiertos del BID — NO es exclusivo de Ecuador, es un catálogo regional/global: Latin Macro Watch e indicadores del Banco Mundial/BID)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
list_dataset_resources Listar todos los archivos (recursos) de un dataset con formato, tamaño, URL y fechas de creación/modificación.

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.

ParámetroTipoDefaultDescripción
dataset_idstrrequeridoEl ID o slug del dataset
sourceckan_client.CkanSourcenacional"nacional" (default, www.datosabiertos.gob.ec), "cuenca" (cuencaendatos.cuenca.gob.ec, portal municipal independiente), "latacunga" (datosabiertos.latacunga.gob.ec, portal municipal independiente) o "iadb" (data.iadb.org, portal de datos abiertos del BID — NO es exclusivo de Ecuador, es un catálogo regional/global: Latin Macro Watch e indicadores del Banco Mundial/BID)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_resource_info Información detallada de un archivo específico.

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.

ParámetroTipoDefaultDescripción
resource_idstrrequeridoEl UUID del recurso
sourceckan_client.CkanSourcenacional"nacional" (default, www.datosabiertos.gob.ec), "cuenca" (cuencaendatos.cuenca.gob.ec, portal municipal independiente), "latacunga" (datosabiertos.latacunga.gob.ec, portal municipal independiente) o "iadb" (data.iadb.org, portal de datos abiertos del BID — NO es exclusivo de Ecuador, es un catálogo regional/global: Latin Macro Watch e indicadores del Banco Mundial/BID)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
preview_resource_data Vista previa de CSV/TSV, JSON/GeoJSON, Excel (XLS/XLSX/XLSB), ODS o ZIP/tar.gz con un CSV, como tabla (máx. 5 MB).

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.

ParámetroTipoDefaultDescripción
resource_idstrrequeridoEl UUID del recurso (obtenlo de list_dataset_resources)
rowsint20Cantidad de filas a previsualizar (default: 20, máx. 100)
sourceckan_client.CkanSourcenacional"nacional" (default, www.datosabiertos.gob.ec), "cuenca" (cuencaendatos.cuenca.gob.ec, portal municipal independiente), "latacunga" (datosabiertos.latacunga.gob.ec, portal municipal independiente) o "iadb" (data.iadb.org, portal de datos abiertos del BID — NO es exclusivo de Ecuador, es un catálogo regional/global: Latin Macro Watch e indicadores del Banco Mundial/BID)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
download_resource Bytes crudos en base64 (máx. 5 MB) para formatos que preview_resource_data no puede leer (.rar o no reconocidos).

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.

ParámetroTipoDefaultDescripción
resource_idstrrequeridoEl UUID del recurso (obtenlo de list_dataset_resources)
sourceckan_client.CkanSourcenacional"nacional" (default, www.datosabiertos.gob.ec), "cuenca" (cuencaendatos.cuenca.gob.ec, portal municipal independiente), "latacunga" (datosabiertos.latacunga.gob.ec, portal municipal independiente) o "iadb" (data.iadb.org, portal de datos abiertos del BID — NO es exclusivo de Ecuador, es un catálogo regional/global: Latin Macro Watch e indicadores del Banco Mundial/BID)
formatLiteral['text', 'json']texttext | json (json incluye content_base64; úsalo para obtener el archivo real)
query_resource_data Consulta tabular vía CKAN DataStore (filtros, texto, paginación) sin descargar el archivo.

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.

ParámetroTipoDefaultDescripción
resource_idstrrequeridoUUID del recurso (de list_dataset_resources)
querystrvacíoBúsqueda de texto completo opcional sobre los campos del datastore
filters_jsonstrvacíoObjeto JSON opcional de filtros exactos por campo, ej. '{"provincia":"Pichincha"}'
rowsint20Cantidad de registros a devolver (default 20, máx. 100)
offsetint0Offset de paginación (default 0)
sortstrvacíoExpresión de orden opcional, ej. "anio desc"
sourceckan_client.CkanSourcenacional"nacional" (default, www.datosabiertos.gob.ec), "cuenca" (cuencaendatos.cuenca.gob.ec, portal municipal independiente), "latacunga" (datosabiertos.latacunga.gob.ec, portal municipal independiente) o "iadb" (data.iadb.org, portal de datos abiertos del BID — NO es exclusivo de Ecuador, es un catálogo regional/global: Latin Macro Watch e indicadores del Banco Mundial/BID)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
detect_series_pattern Para datasets con un archivo por período: determina si cada archivo nuevo reemplaza a los anteriores (acumulado) o los complementa (incremental).

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.

ParámetroTipoDefaultDescripción
dataset_idstrrequeridoEl ID o slug del dataset
resource_id_newstr | NoneningunoOpcional -- ID del recurso más reciente a comparar (auto-detectado del grupo de nombre periódico del dataset si se omite)
resource_id_oldstr | NoneningunoOpcional -- ID del recurso más antiguo a comparar (auto-detectado si se omite). resource_id_new/resource_id_old deben pasarse juntos, o ninguno de los dos.
sourceckan_client.CkanSourcenacional"nacional" (default, www.datosabiertos.gob.ec), "cuenca" (cuencaendatos.cuenca.gob.ec, portal municipal independiente), "latacunga" (datosabiertos.latacunga.gob.ec, portal municipal independiente) o "iadb" (data.iadb.org, portal de datos abiertos del BID — NO es exclusivo de Ecuador, es un catálogo regional/global: Latin Macro Watch e indicadores del Banco Mundial/BID)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
Trámites Gubernamentales5 Mostrar
search_tramites Buscar trámites del gobierno ecuatoriano (cédula, pasaporte, RUC, licencia, etc.).

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), "62" = ANT (licencias de conducir, matriculación vehicular), "16" = Cancillería (pasaportes, apostilla), "5" = IESS (seguro social, pensiones, fondos de reserva). Usa list_instituciones para encontrar más IDs.

ParámetroTipoDefaultDescripción
querystrvacíoPalabras clave para filtrar resultados (ej. "RUC", "inscripción RUC persona natural"). Cada palabra debe aparecer en el nombre o la descripción del trámite.
institution_idstrvacíoID de institución (muy recomendado para resultados relevantes)
pageint1Número de página (base 1, default: 1). Se ignora cuando se da query (se buscan todas las páginas automáticamente).
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_tramite_info Requisitos, beneficiarios, costo e institución responsable de un trámite.

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.

ParámetroTipoDefaultDescripción
tramite_idstrrequeridoEl ID del trámite (ej. "18009")
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_tramite_estadisticas Serie mensual de atenciones/quejas de transparencia de un trámite, desde 2021.

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).

ParámetroTipoDefaultDescripción
tramite_idstrrequeridoEl ID del trámite (ej. "11752")
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
list_instituciones Listar instituciones públicas del Ecuador.

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: 62), Cancillería (ID: 16), IESS (ID: 5), Ministerio de Salud, INEC, BCE.

ParámetroTipoDefaultDescripción
querystrvacíoTérmino de búsqueda opcional (ej. "SRI", "salud", "rentas")
pageint1Número de página (base 1, default: 1, solo se usa sin query)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_institucion_info Detalle de una institución (sector, web, descripción).

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=5, Registro Civil=23, ANT=62, Cancillería=16.

ParámetroTipoDefaultDescripción
institucion_idstrrequeridoID de institución (ej. "8")
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
ANDA (INEC)3 Mostrar
search_anda Buscar encuestas y censos en el catálogo ANDA del INEC (NADA/IHSN). Indica si cada encuesta tiene microdatos descargables.

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. Sigue con get_anda_survey_info(idno) para la metadata completa de una encuesta.

ParámetroTipoDefaultDescripción
querystrvacíoPalabras clave (ej. "empleo", "REEM", "censo agropecuario")
limitint10Máximo de resultados (default: 10, máx. 50)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_anda_survey_info Metadata completa de una encuesta ANDA: resumen, variables, confidencialidad y contacto.

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 descargable, términos de confidencialidad, y un email de contacto para pedir datos restringidos cuando no lo son.

ParámetroTipoDefaultDescripción
idnostrrequeridoIdentificador de la encuesta de search_anda (el campo "idno")
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
download_anda_microdata Links directos de descarga de los archivos de microdatos de una encuesta ANDA.

Enlaces directos de descarga de los archivos de microdatos de una encuesta ANDA. 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 el texto completo) para revelar la lista de archivos. Revisa primero get_anda_survey_info: las encuestas solo-agregadas (microdatos_disponibles false) no tienen archivos aquí. Devuelve URLs directas, no el contenido del archivo — los archivos suelen ser ZIPs de varios MB (SPSS .sav adentro), demasiado grandes para incluir en un resultado de tool. Descárgalos con la URL devuelta.

ParámetroTipoDefaultDescripción
idnostrrequeridoIdentificador de la encuesta de search_anda (el campo "idno")
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
Macroeconomía (BCE)2 Mostrar
search_indicadores_bce Buscar en el catálogo estadístico del Banco Central del Ecuador (monetario/financiero, finanzas públicas, sector externo, sector real).

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.

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre contra la descripción del grupo, su sección/subsección, y las etiquetas de sus series individuales (sin distinguir tildes)
limitint20Máximo de resultados (default 20, máx. 100)
offsetint0Offset de paginación sobre el conjunto encontrado
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_indicador_bce Serie de tiempo de un indicador por id_grupo: período, frecuencia y unidad configurables (defaults según el grupo).

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.

ParámetroTipoDefaultDescripción
id_grupointrequeridoEl id del grupo, de search_indicadores_bce.
desdestrvacíoPeríodo de inicio en formato YYYY-MM. Por default, el período más antiguo disponible para la frecuencia elegida.
hastastrvacíoPeríodo de fin en formato YYYY-MM. Por default, el período más reciente disponible para la frecuencia elegida.
frecuenciaLiteral['', 'Semanal', 'Mensual', 'Trimestral', 'Anual']vacíoSemanal | Mensual | Trimestral | Anual. Por default, la primera frecuencia disponible del grupo.
unidadstrvacíoVaría según el grupo (ej. "Millones de USD", "Indice", "Porcentaje"). Por default, la primera disponible para la frecuencia elegida.
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
Compañías (Supercías)6 Mostrar
search_companias Buscar en el directorio de compañías de la Superintendencia de Compañías (226k+, por nombre/RUC, provincia, situación legal).

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).

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre contra el nombre de la compañía o RUC (sin distinguir tildes)
provinciastrvacíoFiltro opcional por provincia, ej. "PICHINCHA" (coincidencia de substring)
situacion_legalstrvacíoFiltro opcional por situación legal, ej. "ACTIVA", "DISOLUCIÓN"
limitint20Máximo de resultados (default 20, máx. 100)
offsetint0Offset de paginación sobre el conjunto encontrado
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_compania_info Ficha completa de una compañía por RUC: representante legal, capital suscrito, CIIU, dirección.

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.

ParámetroTipoDefaultDescripción
rucstrrequeridoEl RUC de 13 dígitos de la compañía
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
search_ranking Rankear/filtrar compañías por indicadores financieros (año, CIIU, cualquier columna); requiere el build local de la base financiera.

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 los últimos cinco años fiscales de la base local, no el historial completo. 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.).

ParámetroTipoDefaultDescripción
anioint | NoneningunoFiltro opcional de año fiscal.
ciiu_n1strvacíoFiltro opcional de CIIU nivel 1, ej. "C", "G", "I".
order_bystrposicion_generalColumna para ordenar ascendente (ej. "posicion_general", "activos", "roe"). Vuelve a posicion_general si no se reconoce.
descendingboolFalseOrden descendente si es true (default false = ascendente); úsalo para «top N» por una columna como roe. posicion_general ya viene ascendente (1 = mejor), déjalo en false al ordenar por ella.
limitint20Máximo de resultados (default 20, máx. 100).
offsetint0Offset de paginación.
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_financials Historial financiero de una compañía por expediente o RUC: ingresos, activos, patrimonio, ~38 ratios (liquidez, endeudamiento, rentabilidad).

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. Cubre los últimos cinco años fiscales de la base local (ver metadatos.base_local para su fecha de construcción y rango de años), no el historial completo desde 2008. Complementa get_compania_info, que tiene datos legales/de registro pero no financieros.

ParámetroTipoDefaultDescripción
expediente_or_rucstrrequeridoEl número de "expediente" de Supercías de la compañía (de search_companias/get_compania_info) o su RUC de 13 dígitos.
anioint | NoneningunoFiltro opcional de un solo año fiscal.
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
search_auditores Buscar en el registro de auditores externos autorizados (1,447 firmas/personas, por nombre o identificación, provincia).

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.

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre contra el nombre del auditor o identificación (RUC/cédula), sin distinguir tildes
provinciastrvacíoFiltro opcional por provincia, ej. "PICHINCHA" (coincidencia de substring)
limitint20Máximo de resultados (default 20, máx. 100)
offsetint0Offset de paginación sobre el conjunto encontrado
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_auditor_info Ficha completa de un auditor externo por identificación: resolución de autorización, nacionalidad, dirección, contacto.

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).

ParámetroTipoDefaultDescripción
identificacionstrrequeridoEl RUC o cédula del auditor
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
Regulaciones y contratos4 Mostrar
search_regulaciones Buscar/listar regulaciones en gob.ec (con referencia al Registro Oficial).

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.

ParámetroTipoDefaultDescripción
querystrvacíoPalabras clave (ej. "datos personales", "tránsito", "LOTAIP")
pageint1Número de página cuando query está vacío (base 1)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_regulacion_info Detalle de una regulación + enlace al PDF.

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.

ParámetroTipoDefaultDescripción
regulacion_idstrrequeridoID de la regulación (ej. "5051")
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
search_contratos Buscar procedimientos de contratación pública (SERCOP/OCDS).

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.

ParámetroTipoDefaultDescripción
querystrrequeridoPalabra clave (mín. 3 caracteres), ej. "medicinas", "vialidad", "software"
yearint0Año del contrato (2015-actual). 0 = año actual + fallback
pageint1Página de resultados (base 1)
buyerstrvacíoPalabra clave opcional de comprador/institución (mín. 3 caracteres)
supplierstrvacíoPalabra clave opcional de proveedor (mín. 3 caracteres)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_contrato_info Expediente OCDS: comprador, licitación, adjudicaciones, contratos.

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.

ParámetroTipoDefaultDescripción
ocidstrrequeridoOpen Contracting ID, ej. "ocds-5wno2w-001-LICO-GPLR-2020-2805"
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
Riesgos y sismos5 Mostrar
search_eventos_riesgo Eventos de emergencia/riesgo del COE (deslizamientos, inundaciones, etc.).

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).

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre (sector, causa, palabras clave de la descripción)
provinciastrvacíoFiltro de provincia (ej. "Pichincha")
cantonstrvacíoFiltro de cantón (ej. "Quito")
eventostrvacíoFiltro de tipo de evento (ej. "Deslizamiento", "Inundación", "Aluvión")
estadostrvacíoFiltro de estado (ej. "Seguimiento", "Cierre")
limitint15Máximo de eventos a devolver (default 15, máx. 100)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
list_sat_tsunami Estaciones SAT de alerta temprana por tsunami.

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.

ParámetroTipoDefaultDescripción
limitint30Máximo de estaciones a incluir en la respuesta (default 30)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
search_sismos Sismos recientes del catálogo del Instituto Geofísico (IG-EPN): magnitud, profundidad, ubicación y estado de revisión.

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.

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre sobre ubicación/id (ej. "Quito", "Esmeraldas")
magnitud_minimafloat0.0Magnitud mínima (ej. 4.0)
diasint0Solo eventos de los últimos N días (0 = todos los disponibles)
limitint15Máximo de eventos a devolver (default 15, máx. 100)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
search_sgr_sitreps Archivo histórico de eventos adversos de la SGR (2016-2026).

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.

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre contra el título, estado o descripción del evento (ignora tildes), ej. "terremoto", "en curso", "manabi". Vacío devuelve todos los eventos.
formatLiteral['text', 'json']texttext | json
get_sgr_sitrep_archivos Reportes SITREP en PDF de un evento adverso de la SGR.

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.

ParámetroTipoDefaultDescripción
evento_urlstrrequeridoUna URL de evento tomada del campo "url" de search_sgr_sitreps (debe ser de gestionderiesgos.gob.ec).
formatLiteral['text', 'json']texttext | json
Exploración4 Mostrar
search_organizations Buscar entre 98+ instituciones que publican datos (INEC, SRI, BCE, MSP, etc.).

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.

ParámetroTipoDefaultDescripción
querystrvacíoTérmino de búsqueda opcional (ej. "salud", "SRI", "INEC")
pageint1Número de página (base 1, default: 1)
page_sizeint20Resultados por página (default: 20, máx. 100)
sourceckan_client.CkanSourcenacional"nacional" (default, www.datosabiertos.gob.ec), "cuenca" (cuencaendatos.cuenca.gob.ec, portal municipal independiente), "latacunga" (datosabiertos.latacunga.gob.ec, portal municipal independiente) o "iadb" (data.iadb.org, portal de datos abiertos del BID — NO es exclusivo de Ecuador, es un catálogo regional/global: Latin Macro Watch e indicadores del Banco Mundial/BID)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_organization_info Info de una organización, con datasets filtrables por texto.

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.

ParámetroTipoDefaultDescripción
organization_idstrrequeridoEl slug de la organización (ej. "sri-servicio-de-rentas-internas")
querystrvacíoTexto libre contra el título de cada dataset (ignora tildes). Vacío devuelve todos los datasets.
sourceckan_client.CkanSourcenacional"nacional" (default, www.datosabiertos.gob.ec) o "cuenca" (cuencaendatos.cuenca.gob.ec, portal municipal independiente)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
list_categories Categorías temáticas con conteo de datasets.

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.

ParámetroTipoDefaultDescripción
sourceckan_client.CkanSourcenacional"nacional" (default, www.datosabiertos.gob.ec), "cuenca" (cuencaendatos.cuenca.gob.ec, portal municipal independiente), "latacunga" (datosabiertos.latacunga.gob.ec, portal municipal independiente) o "iadb" (data.iadb.org, portal de datos abiertos del BID — NO es exclusivo de Ecuador, es un catálogo regional/global: Latin Macro Watch e indicadores del Banco Mundial/BID)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_category_info Detalle de una categoría y datasets de ejemplo.

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').

ParámetroTipoDefaultDescripción
categorystrrequeridoSlug/nombre de categoría de list_categories
include_datasetsboolTrueIncluir datasets de ejemplo en la categoría (default True)
sourceckan_client.CkanSourcenacional"nacional" (default, www.datosabiertos.gob.ec), "cuenca" (cuencaendatos.cuenca.gob.ec, portal municipal independiente), "latacunga" (datosabiertos.latacunga.gob.ec, portal municipal independiente) o "iadb" (data.iadb.org, portal de datos abiertos del BID — NO es exclusivo de Ecuador, es un catálogo regional/global: Latin Macro Watch e indicadores del Banco Mundial/BID)
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
BCE y series especializadas10 Mostrar
get_bce_iem_table Inspecciona una tabla XLSX oficial del boletín IEM más reciente del BCE.

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).

ParámetroTipoDefaultDescripción
table_idstrrequeridoUn table_id de search_bce_iem.
desdestrvacíoPrimer período a incluir: YYYY, YYYY-MM o etiqueta mes-año.
hastastrvacíoÚltimo período a incluir; mismos formatos que desde.
boletin_numeroint0Número de un boletín pasado de search_bce_iem(historico=true); 0 = el último.
rowsint20Máximo de filas devueltas (1-100, default 20).
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_bce_indicador_diario Obtiene la serie temporal de un indicador diario/mensual del BCE (ej. Riesgo País).

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_bce_indicadores_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.

ParámetroTipoDefaultDescripción
archivostrrequeridoUn nombre de archivo devuelto por list_bce_indicadores_diarios.
codigostrrequeridoUn "Código Variable Dinámica" de ese mismo archivo.
ultimos_nint30Las N observaciones más recientes cuando no se indica un rango de fechas.
desdestrvacíoFecha de inicio opcional, YYYY-MM-DD.
hastastrvacíoFecha de fin opcional, YYYY-MM-DD.
formatLiteral['text', 'json']texttext | json
list_bce_indicadores_diarios Lista la familia de widgets "indicador" diarios/mensuales del BCE, publicados fuera de BCEData e IEM (páginas de widgets Highcharts de contenido.bce.fin.ec) — incluye Riesgo País (EMBI) como serie genuinamente diaria desde 2004, que BCEData solo expone como agregado mensual de fin de período.

Lista la familia de widgets "indicador" diarios/mensuales del BCE, publicados fuera de BCEData e IEM (páginas de widgets Highcharts de contenido.bce.fin.ec) — incluye Riesgo País (EMBI) como serie genuinamente diaria desde 2004, que BCEData solo expone como agregado mensual de fin de período. También cubre: Precio del Oro, Petróleo WTI, Índice Dow Jones, Tasa SOFR/LIBOR, precios de bonos soberanos de Ecuador (todos diarios); Sistema de Pagos/Cobros Interbancarios, Sistema de Pagos en Línea, Cámara de Compensación de Cheques (mensual); Producción Petrolera Nacional (diaria); inflación, desempleo, confianza del consumidor, PIB (mensual/trimestral/anual, probablemente duplican BCEData). El catálogo se descubre en vivo desde los datos de cada archivo, no está hardcodeado — un "codigo" solo tiene sentido dentro de su propio "archivo", no entre archivos distintos. Continúa con get_bce_indicador_diario(archivo, codigo) para una serie.

ParámetroTipoDefaultDescripción
formatLiteral['text', 'json']texttext | json
search_bce_iem Busca tablas individuales de Excel en el último boletín IEM del BCE.

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.

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre que se busca, sin distinguir tildes, en títulos y secciones de las tablas. Vacío lista todas.
limitint20Máximo de tablas devueltas (default 20).
offsetint0Desplazamiento de paginación sobre las tablas encontradas.
historicoboolFalseBusca también en boletines mensuales pasados, no solo en el último.
desde_anioint0Primer año de boletín a buscar (implica historico).
hasta_anioint0Último año de boletín a buscar (implica historico).
guardar_catalogoboolFalseGuarda el catálogo completo en IEM_CATALOG_DIR.
hash_archivosboolFalseDescarga cada XLSX descubierto e informa su SHA-256 (auditoría de operador; lento).
max_hash_archivosint5000Tope de archivos a los que se calcula el hash cuando hash_archivos está activo.
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
search_bce_remesas Lista los enlaces directos a archivos de Remesas de Trabajadores del BCE.

Lista los enlaces directos a archivos de Remesas de Trabajadores del BCE. Una serie separada de BCEData/IEM (search_indicadores_bce, search_bce_iem): la serie agregada de flujos, la serie histórica completa, una nota metodológica para el usuario, y — desde un cambio a recolección basada en microdatos en julio de 2025 — bases de datos (BDD) agregadas mensuales y por entidad. Trata los archivos "histórica" (previo al cambio) y "BDD" (posterior al cambio) como series metodológicamente distintas, no como una sola continua — revisa la nota al usuario (Nota_al_usuario) para el detalle de comparabilidad. Devuelve URLs directas, no el contenido de los archivos — descárgalos tú mismo o vía download_resource.

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre que se busca, sin distinguir tildes, en la etiqueta o URL del archivo, p. ej. "historica", "entidad", "bdd". Vacío devuelve todos.
formatLiteral['text', 'json']texttext | json
search_bce_publicaciones Publicaciones recientes del BCE (boletines, reportes, avisos).

Lista las publicaciones recientes del Banco Central del Ecuador desde su sección "Últimas Publicaciones": boletines monetarios, reportes de tasas de interés, boletines sectoriales, avisos del IEM, entre otros, cada uno con fecha, título, URL directa y formato. Es un catálogo distinto de BCEData/IEM (search_indicadores_bce, search_bce_iem): la mayoría de lo que aparece aquí no tiene una serie numérica equivalente. Solo muestra la ventana reciente que exhibe la propia página (unas 30 publicaciones más recientes) — no hay paginación ni filtro de rango de fechas.

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre contra el título de la publicación (ignora tildes). Vacío devuelve todas.
formatoLiteral['', 'PDF', 'XLSX', 'XLS', 'CSV', 'ZIP', 'HTML']vacíoCoincidencia exacta con el formato derivado — PDF, XLSX, XLS, CSV, ZIP, HTML. Vacío devuelve todos los formatos.
formatLiteral['text', 'json']texttext | json
search_bce_precios_comex Índices de precios de comercio exterior del BCE, desagregados.

Lista los enlaces a los archivos desagregados de índices de precios de comercio exterior del BCE — precios de importación por categoría de uso económico y precios de exportación por producto individual (petróleo crudo, camarón, banano, cacao, cobre, oro, rosas), cada uno con hojas separadas de precio/valor/volumen y variaciones. Es una fuente distinta del catálogo BCEData de search_indicadores_bce (que solo tiene las tres series *agregadas*) y de search_bce_paginas (que no cubre precios de comercio exterior). Devuelve URLs directas, no el contenido de los archivos.

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre contra la etiqueta del archivo, el título de la página o el id de página (ignora tildes), ej. "importacion", "exportacion". Vacío devuelve todos los archivos.
formatLiteral['text', 'json']texttext | json
search_bce_calendario Calendario de publicaciones estadísticas programadas del BCE.

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_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.

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre contra el nombre de la publicación o su nota de observaciones (ignora tildes). Vacío coincide con todas.
categoriastrvacíoFiltro exacto de categoría (ignora tildes), ej. "cuentas nacionales", "balanza de pagos y comercio exterior".
periodicidadstrvacíoFiltro exacto de periodicidad, ej. "Mensual", "Anual", "Trimestral", "Semanal".
desdestrvacíoRestringe a fecha de publicación >= esta fecha (AAAA-MM-DD).
hastastrvacíoRestringe a fecha de publicación <= esta fecha (AAAA-MM-DD).
solo_proximasboolFalseSi es verdadero, solo publicaciones programadas para hoy o después.
limitint50Máximo de resultados (1-200, default 50).
offsetint0Desplazamiento de paginación sobre el conjunto filtrado.
formatLiteral['text', 'json']texttext | json
search_bce_paginas Páginas de publicaciones del BCE con archivos: índices o cuentas nacionales.

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).

ParámetroTipoDefaultDescripción
catalogoCatalogorequeridoindices o cuentas_nacionales.
querystrvacíoTexto libre que se busca, sin distinguir tildes, en el título, la categoría o el id de la página. Vacío devuelve todas.
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_bce_pagina_archivos Archivos de una página de publicación del BCE, del más reciente al más antiguo.

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.

ParámetroTipoDefaultDescripción
catalogoCatalogorequeridoindices o cuentas_nacionales.
pagina_idstrrequeridoEl `pagina_id` de la página, de search_bce_paginas.
anioint0Solo para catalogo="indices": limita a un año (0 = todos).
max_archivosint30Tope de archivos devueltos, 1-200 (los más recientes primero); usa anio para ir más atrás.
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
INEC: estadísticas, BIINEC y censo5 Mostrar
get_inec_estadistica_files Lista los enlaces directos a archivos publicados en una página de tema estadístico del INEC.

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.

ParámetroTipoDefaultDescripción
urlstrrequeridoA topic URL from search_inec_estadisticas's "url" field (must be on ecuadorencifras.gob.ec)
formatLiteral['text', 'json']texttext | json
get_inec_publicacion_archivos Lista los enlaces directos a archivos (PDF/XLSX/CSV/ZIP) incrustados en una publicación del INEC encontrada vía search_inec_publicaciones.

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

ParámetroTipoDefaultDescripción
poststrrequeridoEl "id" numérico de search_inec_publicaciones, o la URL completa de la publicación en ecuadorencifras.gob.ec.
formatLiteral['text', 'json']texttext | json
search_biinec_extras Revisa el BIINEC ("Banco de Datos Abiertos") del INEC en busca de datos que no aparecen en search_anda ni en search_inec_estadisticas.

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.

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre que se busca, sin distinguir tildes, en el nombre o descripción del registro. Vacío devuelve la lista curada completa.
formatLiteral['text', 'json']texttext | json
search_inec_estadisticas Busca en las páginas de temas estadísticos del INEC (ecuadorencifras.gob.ec).

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.

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre (sin distinguir tildes) contra el nombre del tema, ej. "precios", "empleo", "pobreza". Vacío devuelve todos los temas.
limitint30Máximo de resultados (default 30, máx. 100)
offsetint0Desplazamiento de paginación sobre el conjunto encontrado
formatLiteral['text', 'json']texttext | json
search_inec_publicaciones 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.

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.

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre contra título/contenido (ej. "ENEMDU anual 2025", "inflación julio", "censo"). Vacío devuelve las publicaciones más recientes sin importar el tema.
limitint20Máximo de resultados (default 20, máx. 100).
offsetint0Desplazamiento de paginación sobre el conjunto encontrado.
formatLiteral['text', 'json']texttext | json
SRI: RUC y recaudación2 Mostrar
get_sri_ruc_info Consultar la información pública de un contribuyente por RUC en el SRI.

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.

ParámetroTipoDefaultDescripción
rucstrrequeridoRUC ecuatoriano exacto de 13 dígitos
include_establecimientosboolTrueincluir establecimientos registrados
formatLiteral['text', 'json']texttext | json
search_sri_ruc Buscar contribuyentes en el RUC del SRI por razón social o nombre comercial (texto parcial), sin necesitar el RUC exacto de antemano.

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.

ParámetroTipoDefaultDescripción
razon_socialstrrequeridoTexto a buscar (mínimo 4 caracteres), ej. "BANANERA"
max_resultadosint25Cuántos resultados con detalle completo devolver (máx 100)
formatLiteral['text', 'json']texttext | json
SIPA, Contraloría y Superbancos3 Mostrar
get_contraloria_informe Descarga y previsualiza un documento de la Contraloría (Datos Abiertos o Plan Anual de Control).

Descarga y previsualiza un documento de la Contraloría (Datos Abiertos o Plan Anual de Control). Obtén informe_id desde list_contraloria_informes. 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.

ParámetroTipoDefaultDescripción
informe_idstrrequeridoAn id from list_contraloria_informes
rowsint50Número de filas de datos a mostrar (default 50, máx. 200).
formatLiteral['text', 'json']texttext | json
list_contraloria_informes Lista los documentos "Datos Abiertos" y "Plan Anual de Control" de la Contraloría General del Estado.

Lista los documentos "Datos Abiertos" y "Plan Anual de Control" de la Contraloría General del Estado. "Datos Abiertos" son exportaciones CSV trimestrales de informes de auditoría aprobados para CUALQUIER institución pública del país (Unidad de Control, Entidad, Diligencia, periodo, tipo de informe, N° de informe, fecha de aprobación) — mucho más amplio que cualquier archivo de auditoría de una sola institución ya cubierto en otra parte de este MCP. Se agregan trimestres nuevos aproximadamente cada tres meses. Los documentos "Plan Anual de Control" son un PDF por año (el plan anual de control aprobado). Continúa con get_contraloria_informe(informe_id) para las filas parseadas de un documento (CSV) o su metadata + puntero a read_pdf (PDF).

ParámetroTipoDefaultDescripción
formatLiteral['text', 'json']texttext | json
get_sipa_resumen_indicadores PDF mensuales del "Resumen de Indicadores" de SIPA (Ministerio de Agricultura), por año.

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.

ParámetroTipoDefaultDescripción
aniointrequeridoAño, ej. 2025. El más antiguo confirmado en vivo es 2018.
formatLiteral['text', 'json']texttext | json
CENACE, SUT, IG-EPN y cortes de luz11 Mostrar
get_cenace_tablero 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.

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.

ParámetroTipoDefaultDescripción
tableroLiteral['produccion_tiempo_real', 'demanda_tiempo_real', 'operativa_diaria', 'acumulada_mensual', 'acumulada_anual']requeridoUno de los 5 nombres indicados arriba.
formatLiteral['text', 'json']texttext | json
get_informe_igepn Descarga y extrae el texto de un informe del IG-EPN encontrado vía search_informes_igepn.

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).

ParámetroTipoDefaultDescripción
nombrestrrequeridoNombre exacto del informe según search_informes_igepn (ej. "Informe Diario 2022-071")
volcanstrvacíoNombre del volcán, solo necesario para desambiguar un nombre duplicado
grupoLiteral['sismico', 'volcanico', '']vacío"sismico" | "volcanico" | "" (ambos) -- el mismo valor usado para encontrarlo
anioint0Año del informe (0 = año actual) -- el mismo valor usado para encontrarlo
pagesstrvacíoRango de páginas, indexado desde 1 (ej. "3", "1-5"). Vacío = documento completo, con tope de 20 páginas por llamada
formatLiteral['text', 'json']texttext | json
get_sut_indicador_schema 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.

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.

ParámetroTipoDefaultDescripción
indicadorstrrequeridoUna clave de list_sut_indicadores.
formatLiteral['text', 'json']texttext | json
list_sut_indicadores Lista los tableros públicos de Power BI "Indicadores" del Ministerio del Trabajo/SUT (sut.trabajo.gob.ec/mrl/contenido/indicadores/*.xhtml).

Lista los tableros públicos de Power BI "Indicadores" del Ministerio del Trabajo/SUT (sut.trabajo.gob.ec/mrl/contenido/indicadores/*.xhtml). Son modelos semánticos consultables en vivo, no archivos estáticos — cubren registro mensual de contratos por industria/provincia/género desde 2015 (contratos), demanda laboral y brechas de habilidades reportadas por empleadores, estadísticas de capacitación/certificación, indicadores provinciales de brecha de empleo, y un tablero de cumplimiento de políticas de género/lugar de trabajo (PEA, brechas salariales, salas de lactancia, cuidado infantil, teletrabajo). Nada de esto se solapa con lo que ya cubren los datasets CKAN de ministerio-del-trabajo, que son solo una foto del stock actual. Continúa con get_sut_indicador_schema(indicador) para ver los campos consultables de un tablero, y luego query_sut_indicador para extraer datos reales — cualquier combinación de campos, no solo lo que ya muestra un gráfico.

ParámetroTipoDefaultDescripción
formatLiteral['text', 'json']texttext | json
query_sut_indicador 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 y provincia juntos.

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.

ParámetroTipoDefaultDescripción
indicadorstrrequeridoUna clave de list_sut_indicadores.
camposlist[str]requeridoEtiquetas de campo exactamente como las devuelve get_sut_indicador_schema.
filtrosdict[str, str] | NoneningunoFiltros opcionales de igualdad {campo: valor}, solo columnas planas.
limiteint500Tope de filas aplicado del lado del servidor por la propia consulta.
formatLiteral['text', 'json']texttext | json
search_informes_igepn 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.

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.

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre sobre nombre del informe/volcán (ej. "cotopaxi", "trimestral")
grupoLiteral['sismico', 'volcanico', '']vacío"sismico" | "volcanico" | "" (ambos)
anioint0Año del informe (0 = año actual)
limitint15Máximo de informes a devolver (default 15, máx. 30)
formatLiteral['text', 'json']texttext | json
get_energia_ecuador_snapshot Horarios de racionamiento de 2024 de energia-ecuador.com, recuperados del Wayback Machine.

Recupera, vía Wayback Machine, el agregador nacional de horarios de racionamiento que el Ministerio de Energía publicó durante la crisis de 2024 (dominio hoy muerto). Solo la página de la Empresa Eléctrica Quito quedó archivada: una foto fija del 24 de abril de 2024 con la rotación por provincia, cantón y sector de Pichincha. No es una serie viva.

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre contra cantón o sectores, sin tildes. Vacío devuelve todas las filas.
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
search_cortes PDF de cortes de luz programados de una empresa eléctrica (EEQ o CentroSur).

Lista el archivo de PDF de cortes programados de una distribuidora: eeq (Quito, crisis de apagones 2023-2024) o centrosur (Azuay, Cañar, Morona Santiago, desde 2023). Es regional, no nacional. Siguiente paso: get_cortes_horarios con el `archivo` de un PDF.

ParámetroTipoDefaultDescripción
distribuidoraDistribuidorarequeridoeeq o centrosur.
querystrvacíoTexto libre que se busca, sin distinguir tildes, en el período, fecha, título o URL del archivo, p. ej. "noviembre", "2024-10". Vacío devuelve todos.
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_cortes_horarios Lee un PDF de cortes de luz y lo convierte en filas: fecha, horario, ubicación y sectores.

Convierte un PDF de cortes programados (`archivo` de search_cortes) en filas con página, fecha, horario sin energía, sectores y los campos de ubicación de la empresa (EEQ: subestación; CentroSur: provincia/cantón/zona). El parámetro query filtra por lugar.

ParámetroTipoDefaultDescripción
distribuidoraDistribuidorarequeridoeeq o centrosur.
archivostrrequeridoEl `archivo` de search_cortes (EEQ: slug o URL; CentroSur: URL del PDF).
querystrvacíoTexto libre que se busca, sin distinguir tildes, en la ubicación y los sectores, p. ej. "La Floresta", "Gualaceo". Vacío devuelve todas las filas.
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
list_arconel_reportes Tipos de reporte, años (desde 1998) y grupos de empresas del generador de estadísticas de ARCONEL.

Lista los reportes del generador público de estadísticas de ARCONEL (regulador eléctrico), por sección: datos por parroquia (medidores, facturación, subsidio Tarifa Dignidad), infraestructura, transacciones y más. Siguiente paso: get_arconel_reporte.

ParámetroTipoDefaultDescripción
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_arconel_reporte Ejecuta un reporte de ARCONEL (p. ej. «Balance Energía» de un año) y devuelve sus filas.

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.

ParámetroTipoDefaultDescripción
tipostrrequeridoNombre del reporte según list_arconel_reportes (sin distinguir tildes ni mayúsculas), p. ej. "Balance Energía", "Pérdidas".
aniointrequeridoAño, desde 1998 hasta el actual.
grupoLiteral['todos', 'cnel', 'empresas_electricas']todostodos | cnel | empresas_electricas.
mesint | Noneninguno1-12, solo para reportes con filtro de mes; los demás ya desglosan por mes.
max_paginasint10Máximo de páginas a leer (1-40).
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
Utilidades de investigación3 Mostrar
investigate_dataset 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"

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.

ParámetroTipoDefaultDescripción
querystrrequeridoPalabras clave de búsqueda (ej. "empleo", "SRI recaudación")
sourceckan_client.CkanSourcenacional"nacional" (default), "cuenca" (portal municipal de Cuenca), "latacunga" (portal municipal de Latacunga) o "iadb" (portal del BID, no exclusivo de Ecuador)
preview_rowsint10Filas de datos a previsualizar del recurso elegido (default: 10, máx.: 50)
formatLiteral['text', 'json']texttext | json
list_zip_contents Lista los archivos miembro (nombre, tamaño) de un .zip desde una URL directa, sin descargar el archivo completo.

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. No soporta archivos ZIP64. 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.

ParámetroTipoDefaultDescripción
urlstrrequeridoURL directa a un archivo .zip (del resultado de otro tool, ej. get_inec_publicacion_archivos, search_archivos).
limitint200Máximo de miembros devueltos (default 200, máx. 1000).
offsetint0Desplazamiento de paginación sobre la lista de miembros.
formatLiteral['text', 'json']texttext | json
read_pdf Extrae texto de un documento PDF en una URL directa.

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).

ParámetroTipoDefaultDescripción
urlstrrequeridoURL directa al archivo PDF
pagesstrvacíoRango de páginas, indexado desde 1 (ej. "3", "1-5", "1,4,9"). Vacío significa el documento completo, con tope de 20 páginas por llamada.
formatLiteral['text', 'json']texttext | json
IESS: documentos y cumplimiento patronal3 Mostrar
list_iess_colecciones Colecciones documentales del IESS (boletines, estudios actuariales, auditorías).

Lista las tres colecciones documentales del IESS (Instituto Ecuatoriano de Seguridad Social) — Boletines Estadísticos, Estudios Actuariales e Informes de Auditoría —, con los años y cantidades que tiene publicados cada una. Continúa con get_iess_archivos(coleccion, anio=...) para obtener los documentos reales de una colección.

ParámetroTipoDefaultDescripción
formatLiteral['text', 'json']texttext | json
get_iess_archivos Documentos de una colección del IESS.

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_iess_colecciones para ver qué años y cantidades tiene disponible cada colección.

ParámetroTipoDefaultDescripción
coleccionLiteral['boletines', 'estudios_actuariales', 'informes_auditoria']requerido"boletines" (anuales, 1978-2024 confirmados), "estudios_actuariales" (por fondo, solo algunos años) o "informes_auditoria" (2007-2026 confirmados, por año).
anioint | NoneningunoFiltra a un año. Obligatorio para "informes_auditoria". Opcional para las otras dos colecciones.
querystrvacíoTexto libre contra el título (y descripción/grupo cuando la colección lo tiene), ignora tildes.
formatLiteral['text', 'json']texttext | json
get_certificado_cumplimiento_patronal Verifica si un empleador está al día con el IESS (mora patronal).

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).

ParámetroTipoDefaultDescripción
identificacionstrrequeridoCédula (10 dígitos) o RUC (13 dígitos).
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
Aviación civil (DGAC)5 Mostrar
get_metar Reportes METAR/SPECI recientes de un aeródromo ecuatoriano.

Consulta los reportes meteorológicos METAR/SPECI más recientes de un aeródromo o helipuerto ecuatoriano, desde el sitio IFIS de la DGAC (ais.aviacioncivil.gob.ec), de acceso público sin login. Devuelve el tipo de reporte, la marca de tiempo UTC de observación y el texto crudo en codificación ICAO (ej. "SEQM 030100Z 30004KT 9999 FEW030 17/08 Q1026 NOSIG RMK A3032="). Un designador desconocido devuelve un resultado vacío, no un error.

ParámetroTipoDefaultDescripción
designadorstrrequeridoCódigo ICAO del aeródromo/helipuerto, ej. SEQM (Quito), SEGU (Guayaquil), SECU (Cuenca).
formatLiteral['text', 'json']texttext | json
get_notam NOTAMs activos para un aeródromo ecuatoriano.

Consulta los NOTAM (avisos a aviadores) activos para un aeródromo o helipuerto ecuatoriano, desde el sitio IFIS de la DGAC, también de acceso público sin login. Cada NOTAM incluye su número de serie (ej. "A1784/26"), el texto crudo en formato ICAO y la tabla de campos decodificados que publica el propio sitio (Tipo, FIR, vigencia, horario, etc.). Un designador desconocido devuelve cero NOTAM, no un error.

ParámetroTipoDefaultDescripción
designadorstrrequeridoCódigo ICAO del aeródromo/helipuerto, ej. SEQM (Quito), SEGU (Guayaquil), SECU (Cuenca).
formatLiteral['text', 'json']texttext | json
get_sigmet SIGMET activos para el espacio aéreo ecuatoriano (FIR único).

Consulta los SIGMET (información meteorológica significativa: ceniza volcánica, turbulencia o engelamiento severos, tormentas) actualmente activos para el FIR de Ecuador (SEFG), desde el sitio IFIS de la DGAC. Como el país tiene un único FIR, no existe parámetro por aeródromo. Cero resultados significa que no hay avisos activos, no un error.

ParámetroTipoDefaultDescripción
formatLiteral['text', 'json']texttext | json
list_aip_aerodromos Lista de aeródromos/helipuertos con ficha AIP publicada.

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.).

ParámetroTipoDefaultDescripción
formatLiteral['text', 'json']texttext | json
get_aip_aerodromo Ficha AIP AD 2.x completa de un aeródromo ecuatoriano.

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.

ParámetroTipoDefaultDescripción
designadorstrrequeridoCódigo ICAO del aeródromo/helipuerto, ej. SEQM (Quito), SEGU (Guayaquil), SECU (Cuenca).
formatLiteral['text', 'json']texttext | json
Fuentes sectoriales adicionales2 Mostrar
search_infomies_bases_mensuales Bases de datos mensuales de infoMIES (inclusión económica y social).

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.

ParámetroTipoDefaultDescripción
serieLiteral['anc', 'is']requerido"anc" (Aseguramiento No Contributivo / inclusión económica) o "is" (usuarios del SIIMIES / inclusión social).
anioint | NoneningunoAño específico a traer, ej. 2024. Si se omite, trae todos los años conocidos y los agrega (varias solicitudes en frío).
querystrvacíoTexto libre contra la etiqueta, año o URL del archivo (ignora tildes), ej. "julio", "2023". Vacío devuelve todos los archivos del/los año(s) elegido(s).
formatLiteral['text', 'json']texttext | json
search_infomies_boletines_zonales Boletines zonales de infoMIES, por zona o consolidados por año.

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.

ParámetroTipoDefaultDescripción
modoLiteral['zonal', 'consolidado']zonal"zonal" o "consolidado".
zonastrvacíoObligatorio para modo="zonal": una de "zona-1-bz".."zona-9-bz". Se ignora en modo="consolidado". Déjalo vacío con modo="zonal" para obtener solo la lista de claves de zona válidas.
anioint | NoneningunoAño específico a traer. Para "zonal", si se omite trae todos los años encontrados (típicamente 2017-2021). Para "consolidado", si se omite trae 2021-2026.
querystrvacíoTexto libre contra la etiqueta, año o URL del archivo (ignora tildes).
formatLiteral['text', 'json']texttext | json
Fuentes internacionales2 Mostrar
search_cepalstat_indicadores Busca un indicador en el catálogo regional de CEPALSTAT (CEPAL).

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.

ParámetroTipoDefaultDescripción
querystrvacíoTexto libre contra el nombre del indicador o su ruta temática (ignora tildes), ej. "poblacion", "pobreza", "comercio exterior". Vacío devuelve el catálogo completo (grande — mejor usar un query).
langLiteral['es', 'en']es"es" (default) o "en"
formatLiteral['text', 'json']texttext | json
get_cepalstat_indicador Observaciones de un indicador de CEPALSTAT, filtradas a un país (Ecuador por defecto).

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.).

ParámetroTipoDefaultDescripción
indicator_idintrequeridoUn "indicator_id" de search_cepalstat_indicadores.
paisstrEcuadorPaís al que filtrar (ignora tildes, ej. "Ecuador", "Peru"). String vacío devuelve todos los países del indicador — puede ser de varios MB para un indicador rico.
langLiteral['es', 'en']es"es" (default) o "en"
formatLiteral['text', 'json']texttext | json
Archivos institucionales3 Mostrar
search_archivos Enlaces a archivos publicados por una institución (SRI, MEF, SENAE, INEC, MINEDEC, etc.).

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. Descarga con download_resource o read_pdf (tope de 5 MB).

ParámetroTipoDefaultDescripción
fuenteFuenterequeridoCatálogo a consultar (ver la lista de fuentes).
querystrvacíoTexto libre que se busca, sin distinguir tildes, en el título y los campos de cada archivo. Vacío devuelve todos.
limitint50Máximo de archivos devueltos (1-100, default 50).
offsetint0Desplazamiento de paginación sobre los archivos encontrados.
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
list_archivo_secciones Secciones del archivo documental de una institución (ARCSA, Superbancos, SEPS, INEVAL, SGR, SENESCYT, SIPA).

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 y de Educación Superior, o estadísticas agropecuarias del SIPA. Siguiente paso: get_archivo_seccion(fuente, seccion).

ParámetroTipoDefaultDescripción
fuenteFuenterequeridoUna de arcsa, superbancos, seps, ineval, sgr, senescyt, sipa.
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_archivo_seccion Archivos descargables de una sección de un archivo documental (título, URL, formato).

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 (las tools de vista previa y descarga tienen un tope de 5 MB).

ParámetroTipoDefaultDescripción
fuenteFuenterequeridoUna de arcsa, superbancos, seps, ineval, sgr, senescyt, sipa.
seccionstrrequeridoEl `id` de una sección de list_archivo_secciones.
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
Geoportales (INAMHI y MAG)2 Mostrar
search_capas_geo Capas de los geoportales de INAMHI y MAG (lluvia, cobertura, zonificación agropecuaria).

Busca en el catálogo de capas (WMS/WFS) de un geoportal GeoServer: inamhi (normales de precipitación, anomalías, grillas del modelo WRF, cuencas) o mag (zonificación agroecológica, cobertura, censos agropecuarios, catastro rural, riesgo agroclimático). Con solo_wfs=true deja las capas con datos de atributos.

ParámetroTipoDefaultDescripción
fuenteFuenterequeridoinamhi o mag.
querystrvacíoTexto libre que se busca, sin distinguir tildes, en el id, nombre, título o resumen de la capa. Vacío devuelve todas.
solo_wfsboolFalseDevuelve solo las capas con WFS (datos de atributos).
categoriastrvacíoSolo para fuente="mag": una de sus 8 categorías. Se ignora para inamhi.
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.
get_capa_geo_datos Muestra de atributos (hasta 20 objetos) de una capa con WFS.

Trae una muestra pequeña de atributos de una capa del geoportal (capa de search_capas_geo) mediante WFS GetFeature. Es una vista previa, no una consulta espacial: sin bbox ni filtros, y sin coordenadas de geometría. Las capas sin WFS (rásteres, algunas del MAG) devuelven error.

ParámetroTipoDefaultDescripción
fuenteFuenterequeridoinamhi o mag.
capastrrequeridoEl campo `capa` de search_capas_geo (INAMHI: nombre "geonode:..."; MAG: "categoria/store/nombre").
countint5Número de objetos a traer (1-20, default 5).
formatLiteral['text', 'json']textFormato de salida: `text` (default) o `json`.

¿Falta un tool que necesitas? Proponlo.

Cómo colaborar