Referencia
Los 90 tools, uno por uno.
Encuentra un tool por nombre, fuente o tarea. Abre solo el grupo y el detalle que necesitas.
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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | requerido | Términos de búsqueda en español (ej. "salud", "RUC", "medicinas") |
limit | int | 5 | Máximo de resultados por sección (default 5, máx. 10) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Nombre o código (ej. "Pichincha", "Cuenca", "Tumbaco", "170150") |
region | str | vacío | Región natural opcional para provincias/cantones |
provincia | str | vacío | Filtro opcional por provincia |
canton | str | vacío | Filtro opcional por cantón (útil para parroquias) |
nivel | Literal['auto', 'provincia', 'canton', 'parroquia'] | auto | auto | provincia | canton | parroquia |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Palabras clave (ej. "empleo", "salud", "presupuesto", "SRI recaudación") |
page | int | 1 | Número de página (base 1, default: 1) |
page_size | int | 20 | Resultados por página (default: 20, máx. 100) |
category | str | vacío | Filtro opcional por categoría (ej. "sal" para Salud, "edu" para Educación). Usa list_categories para ver todas las categorías disponibles. |
sort | Literal['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). |
source | ckan_client.CkanSource | nacional | "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) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
dataset_id | str | requerido | El ID o slug del dataset (ej. "registro-estadistico-de-recursos-y-actividades-de-salud-2019") |
source | ckan_client.CkanSource | nacional | "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) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
dataset_id | str | requerido | El ID o slug del dataset |
source | ckan_client.CkanSource | nacional | "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) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
resource_id | str | requerido | El UUID del recurso |
source | ckan_client.CkanSource | nacional | "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) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
resource_id | str | requerido | El UUID del recurso (obtenlo de list_dataset_resources) |
rows | int | 20 | Cantidad de filas a previsualizar (default: 20, máx. 100) |
source | ckan_client.CkanSource | nacional | "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) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
resource_id | str | requerido | El UUID del recurso (obtenlo de list_dataset_resources) |
source | ckan_client.CkanSource | nacional | "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) |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
resource_id | str | requerido | UUID del recurso (de list_dataset_resources) |
query | str | vacío | Búsqueda de texto completo opcional sobre los campos del datastore |
filters_json | str | vacío | Objeto JSON opcional de filtros exactos por campo, ej. '{"provincia":"Pichincha"}' |
rows | int | 20 | Cantidad de registros a devolver (default 20, máx. 100) |
offset | int | 0 | Offset de paginación (default 0) |
sort | str | vacío | Expresión de orden opcional, ej. "anio desc" |
source | ckan_client.CkanSource | nacional | "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) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
dataset_id | str | requerido | El ID o slug del dataset |
resource_id_new | str | None | ninguno | Opcional -- ID del recurso más reciente a comparar (auto-detectado del grupo de nombre periódico del dataset si se omite) |
resource_id_old | str | None | ninguno | Opcional -- 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. |
source | ckan_client.CkanSource | nacional | "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) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Palabras 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_id | str | vacío | ID de institución (muy recomendado para resultados relevantes) |
page | int | 1 | Número de página (base 1, default: 1). Se ignora cuando se da query (se buscan todas las páginas automáticamente). |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
tramite_id | str | requerido | El ID del trámite (ej. "18009") |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
tramite_id | str | requerido | El ID del trámite (ej. "11752") |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Término de búsqueda opcional (ej. "SRI", "salud", "rentas") |
page | int | 1 | Número de página (base 1, default: 1, solo se usa sin query) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
institucion_id | str | requerido | ID de institución (ej. "8") |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Palabras clave (ej. "empleo", "REEM", "censo agropecuario") |
limit | int | 10 | Máximo de resultados (default: 10, máx. 50) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
idno | str | requerido | Identificador de la encuesta de search_anda (el campo "idno") |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
idno | str | requerido | Identificador de la encuesta de search_anda (el campo "idno") |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto libre contra la descripción del grupo, su sección/subsección, y las etiquetas de sus series individuales (sin distinguir tildes) |
limit | int | 20 | Máximo de resultados (default 20, máx. 100) |
offset | int | 0 | Offset de paginación sobre el conjunto encontrado |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
id_grupo | int | requerido | El id del grupo, de search_indicadores_bce. |
desde | str | vacío | Período de inicio en formato YYYY-MM. Por default, el período más antiguo disponible para la frecuencia elegida. |
hasta | str | vacío | Período de fin en formato YYYY-MM. Por default, el período más reciente disponible para la frecuencia elegida. |
frecuencia | Literal['', 'Semanal', 'Mensual', 'Trimestral', 'Anual'] | vacío | Semanal | Mensual | Trimestral | Anual. Por default, la primera frecuencia disponible del grupo. |
unidad | str | vacío | Varía según el grupo (ej. "Millones de USD", "Indice", "Porcentaje"). Por default, la primera disponible para la frecuencia elegida. |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto libre contra el nombre de la compañía o RUC (sin distinguir tildes) |
provincia | str | vacío | Filtro opcional por provincia, ej. "PICHINCHA" (coincidencia de substring) |
situacion_legal | str | vacío | Filtro opcional por situación legal, ej. "ACTIVA", "DISOLUCIÓN" |
limit | int | 20 | Máximo de resultados (default 20, máx. 100) |
offset | int | 0 | Offset de paginación sobre el conjunto encontrado |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
ruc | str | requerido | El RUC de 13 dígitos de la compañía |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
anio | int | None | ninguno | Filtro opcional de año fiscal. |
ciiu_n1 | str | vacío | Filtro opcional de CIIU nivel 1, ej. "C", "G", "I". |
order_by | str | posicion_general | Columna para ordenar ascendente (ej. "posicion_general", "activos", "roe"). Vuelve a posicion_general si no se reconoce. |
descending | bool | False | Orden 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. |
limit | int | 20 | Máximo de resultados (default 20, máx. 100). |
offset | int | 0 | Offset de paginación. |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
expediente_or_ruc | str | requerido | El número de "expediente" de Supercías de la compañía (de search_companias/get_compania_info) o su RUC de 13 dígitos. |
anio | int | None | ninguno | Filtro opcional de un solo año fiscal. |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto libre contra el nombre del auditor o identificación (RUC/cédula), sin distinguir tildes |
provincia | str | vacío | Filtro opcional por provincia, ej. "PICHINCHA" (coincidencia de substring) |
limit | int | 20 | Máximo de resultados (default 20, máx. 100) |
offset | int | 0 | Offset de paginación sobre el conjunto encontrado |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
identificacion | str | requerido | El RUC o cédula del auditor |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Palabras clave (ej. "datos personales", "tránsito", "LOTAIP") |
page | int | 1 | Número de página cuando query está vacío (base 1) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
regulacion_id | str | requerido | ID de la regulación (ej. "5051") |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | requerido | Palabra clave (mín. 3 caracteres), ej. "medicinas", "vialidad", "software" |
year | int | 0 | Año del contrato (2015-actual). 0 = año actual + fallback |
page | int | 1 | Página de resultados (base 1) |
buyer | str | vacío | Palabra clave opcional de comprador/institución (mín. 3 caracteres) |
supplier | str | vacío | Palabra clave opcional de proveedor (mín. 3 caracteres) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
ocid | str | requerido | Open Contracting ID, ej. "ocds-5wno2w-001-LICO-GPLR-2020-2805" |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto libre (sector, causa, palabras clave de la descripción) |
provincia | str | vacío | Filtro de provincia (ej. "Pichincha") |
canton | str | vacío | Filtro de cantón (ej. "Quito") |
evento | str | vacío | Filtro de tipo de evento (ej. "Deslizamiento", "Inundación", "Aluvión") |
estado | str | vacío | Filtro de estado (ej. "Seguimiento", "Cierre") |
limit | int | 15 | Máximo de eventos a devolver (default 15, máx. 100) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
limit | int | 30 | Máximo de estaciones a incluir en la respuesta (default 30) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto libre sobre ubicación/id (ej. "Quito", "Esmeraldas") |
magnitud_minima | float | 0.0 | Magnitud mínima (ej. 4.0) |
dias | int | 0 | Solo eventos de los últimos N días (0 = todos los disponibles) |
limit | int | 15 | Máximo de eventos a devolver (default 15, máx. 100) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto libre contra el título, estado o descripción del evento (ignora tildes), ej. "terremoto", "en curso", "manabi". Vacío devuelve todos los eventos. |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
evento_url | str | requerido | Una URL de evento tomada del campo "url" de search_sgr_sitreps (debe ser de gestionderiesgos.gob.ec). |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Término de búsqueda opcional (ej. "salud", "SRI", "INEC") |
page | int | 1 | Número de página (base 1, default: 1) |
page_size | int | 20 | Resultados por página (default: 20, máx. 100) |
source | ckan_client.CkanSource | nacional | "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) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
organization_id | str | requerido | El slug de la organización (ej. "sri-servicio-de-rentas-internas") |
query | str | vacío | Texto libre contra el título de cada dataset (ignora tildes). Vacío devuelve todos los datasets. |
source | ckan_client.CkanSource | nacional | "nacional" (default, www.datosabiertos.gob.ec) o "cuenca" (cuencaendatos.cuenca.gob.ec, portal municipal independiente) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
source | ckan_client.CkanSource | nacional | "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) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
category | str | requerido | Slug/nombre de categoría de list_categories |
include_datasets | bool | True | Incluir datasets de ejemplo en la categoría (default True) |
source | ckan_client.CkanSource | nacional | "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) |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
table_id | str | requerido | Un table_id de search_bce_iem. |
desde | str | vacío | Primer período a incluir: YYYY, YYYY-MM o etiqueta mes-año. |
hasta | str | vacío | Último período a incluir; mismos formatos que desde. |
boletin_numero | int | 0 | Número de un boletín pasado de search_bce_iem(historico=true); 0 = el último. |
rows | int | 20 | Máximo de filas devueltas (1-100, default 20). |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
archivo | str | requerido | Un nombre de archivo devuelto por list_bce_indicadores_diarios. |
codigo | str | requerido | Un "Código Variable Dinámica" de ese mismo archivo. |
ultimos_n | int | 30 | Las N observaciones más recientes cuando no se indica un rango de fechas. |
desde | str | vacío | Fecha de inicio opcional, YYYY-MM-DD. |
hasta | str | vacío | Fecha de fin opcional, YYYY-MM-DD. |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto libre que se busca, sin distinguir tildes, en títulos y secciones de las tablas. Vacío lista todas. |
limit | int | 20 | Máximo de tablas devueltas (default 20). |
offset | int | 0 | Desplazamiento de paginación sobre las tablas encontradas. |
historico | bool | False | Busca también en boletines mensuales pasados, no solo en el último. |
desde_anio | int | 0 | Primer año de boletín a buscar (implica historico). |
hasta_anio | int | 0 | Último año de boletín a buscar (implica historico). |
guardar_catalogo | bool | False | Guarda el catálogo completo en IEM_CATALOG_DIR. |
hash_archivos | bool | False | Descarga cada XLSX descubierto e informa su SHA-256 (auditoría de operador; lento). |
max_hash_archivos | int | 5000 | Tope de archivos a los que se calcula el hash cuando hash_archivos está activo. |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto libre que se busca, sin distinguir tildes, en la etiqueta o URL del archivo, p. ej. "historica", "entidad", "bdd". Vacío devuelve todos. |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto libre contra el título de la publicación (ignora tildes). Vacío devuelve todas. |
formato | Literal['', 'PDF', 'XLSX', 'XLS', 'CSV', 'ZIP', 'HTML'] | vacío | Coincidencia exacta con el formato derivado — PDF, XLSX, XLS, CSV, ZIP, HTML. Vacío devuelve todos los formatos. |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto 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. |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto libre contra el nombre de la publicación o su nota de observaciones (ignora tildes). Vacío coincide con todas. |
categoria | str | vacío | Filtro exacto de categoría (ignora tildes), ej. "cuentas nacionales", "balanza de pagos y comercio exterior". |
periodicidad | str | vacío | Filtro exacto de periodicidad, ej. "Mensual", "Anual", "Trimestral", "Semanal". |
desde | str | vacío | Restringe a fecha de publicación >= esta fecha (AAAA-MM-DD). |
hasta | str | vacío | Restringe a fecha de publicación <= esta fecha (AAAA-MM-DD). |
solo_proximas | bool | False | Si es verdadero, solo publicaciones programadas para hoy o después. |
limit | int | 50 | Máximo de resultados (1-200, default 50). |
offset | int | 0 | Desplazamiento de paginación sobre el conjunto filtrado. |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
catalogo | Catalogo | requerido | indices o cuentas_nacionales. |
query | str | vacío | Texto 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. |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
catalogo | Catalogo | requerido | indices o cuentas_nacionales. |
pagina_id | str | requerido | El `pagina_id` de la página, de search_bce_paginas. |
anio | int | 0 | Solo para catalogo="indices": limita a un año (0 = todos). |
max_archivos | int | 30 | Tope de archivos devueltos, 1-200 (los más recientes primero); usa anio para ir más atrás. |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
url | str | requerido | A topic URL from search_inec_estadisticas's "url" field (must be on ecuadorencifras.gob.ec) |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
post | str | requerido | El "id" numérico de search_inec_publicaciones, o la URL completa de la publicación en ecuadorencifras.gob.ec. |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto libre que se busca, sin distinguir tildes, en el nombre o descripción del registro. Vacío devuelve la lista curada completa. |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto libre (sin distinguir tildes) contra el nombre del tema, ej. "precios", "empleo", "pobreza". Vacío devuelve todos los temas. |
limit | int | 30 | Máximo de resultados (default 30, máx. 100) |
offset | int | 0 | Desplazamiento de paginación sobre el conjunto encontrado |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto 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. |
limit | int | 20 | Máximo de resultados (default 20, máx. 100). |
offset | int | 0 | Desplazamiento de paginación sobre el conjunto encontrado. |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
ruc | str | requerido | RUC ecuatoriano exacto de 13 dígitos |
include_establecimientos | bool | True | incluir establecimientos registrados |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
razon_social | str | requerido | Texto a buscar (mínimo 4 caracteres), ej. "BANANERA" |
max_resultados | int | 25 | Cuántos resultados con detalle completo devolver (máx 100) |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
informe_id | str | requerido | An id from list_contraloria_informes |
rows | int | 50 | Número de filas de datos a mostrar (default 50, máx. 200). |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
anio | int | requerido | Año, ej. 2025. El más antiguo confirmado en vivo es 2018. |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
tablero | Literal['produccion_tiempo_real', 'demanda_tiempo_real', 'operativa_diaria', 'acumulada_mensual', 'acumulada_anual'] | requerido | Uno de los 5 nombres indicados arriba. |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
nombre | str | requerido | Nombre exacto del informe según search_informes_igepn (ej. "Informe Diario 2022-071") |
volcan | str | vacío | Nombre del volcán, solo necesario para desambiguar un nombre duplicado |
grupo | Literal['sismico', 'volcanico', ''] | vacío | "sismico" | "volcanico" | "" (ambos) -- el mismo valor usado para encontrarlo |
anio | int | 0 | Año del informe (0 = año actual) -- el mismo valor usado para encontrarlo |
pages | str | vacío | Rango de páginas, indexado desde 1 (ej. "3", "1-5"). Vacío = documento completo, con tope de 20 páginas por llamada |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
indicador | str | requerido | Una clave de list_sut_indicadores. |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
indicador | str | requerido | Una clave de list_sut_indicadores. |
campos | list[str] | requerido | Etiquetas de campo exactamente como las devuelve get_sut_indicador_schema. |
filtros | dict[str, str] | None | ninguno | Filtros opcionales de igualdad {campo: valor}, solo columnas planas. |
limite | int | 500 | Tope de filas aplicado del lado del servidor por la propia consulta. |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto libre sobre nombre del informe/volcán (ej. "cotopaxi", "trimestral") |
grupo | Literal['sismico', 'volcanico', ''] | vacío | "sismico" | "volcanico" | "" (ambos) |
anio | int | 0 | Año del informe (0 = año actual) |
limit | int | 15 | Máximo de informes a devolver (default 15, máx. 30) |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto libre contra cantón o sectores, sin tildes. Vacío devuelve todas las filas. |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
distribuidora | Distribuidora | requerido | eeq o centrosur. |
query | str | vacío | Texto 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. |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
distribuidora | Distribuidora | requerido | eeq o centrosur. |
archivo | str | requerido | El `archivo` de search_cortes (EEQ: slug o URL; CentroSur: URL del PDF). |
query | str | vacío | Texto 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. |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
tipo | str | requerido | Nombre del reporte según list_arconel_reportes (sin distinguir tildes ni mayúsculas), p. ej. "Balance Energía", "Pérdidas". |
anio | int | requerido | Año, desde 1998 hasta el actual. |
grupo | Literal['todos', 'cnel', 'empresas_electricas'] | todos | todos | cnel | empresas_electricas. |
mes | int | None | ninguno | 1-12, solo para reportes con filtro de mes; los demás ya desglosan por mes. |
max_paginas | int | 10 | Máximo de páginas a leer (1-40). |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | requerido | Palabras clave de búsqueda (ej. "empleo", "SRI recaudación") |
source | ckan_client.CkanSource | nacional | "nacional" (default), "cuenca" (portal municipal de Cuenca), "latacunga" (portal municipal de Latacunga) o "iadb" (portal del BID, no exclusivo de Ecuador) |
preview_rows | int | 10 | Filas de datos a previsualizar del recurso elegido (default: 10, máx.: 50) |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
url | str | requerido | URL directa a un archivo .zip (del resultado de otro tool, ej. get_inec_publicacion_archivos, search_archivos). |
limit | int | 200 | Máximo de miembros devueltos (default 200, máx. 1000). |
offset | int | 0 | Desplazamiento de paginación sobre la lista de miembros. |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
url | str | requerido | URL directa al archivo PDF |
pages | str | vacío | Rango 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. |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
coleccion | Literal['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). |
anio | int | None | ninguno | Filtra a un año. Obligatorio para "informes_auditoria". Opcional para las otras dos colecciones. |
query | str | vacío | Texto libre contra el título (y descripción/grupo cuando la colección lo tiene), ignora tildes. |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
identificacion | str | requerido | Cédula (10 dígitos) o RUC (13 dígitos). |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
designador | str | requerido | Código ICAO del aeródromo/helipuerto, ej. SEQM (Quito), SEGU (Guayaquil), SECU (Cuenca). |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
designador | str | requerido | Código ICAO del aeródromo/helipuerto, ej. SEQM (Quito), SEGU (Guayaquil), SECU (Cuenca). |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
designador | str | requerido | Código ICAO del aeródromo/helipuerto, ej. SEQM (Quito), SEGU (Guayaquil), SECU (Cuenca). |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
serie | Literal['anc', 'is'] | requerido | "anc" (Aseguramiento No Contributivo / inclusión económica) o "is" (usuarios del SIIMIES / inclusión social). |
anio | int | None | ninguno | Año específico a traer, ej. 2024. Si se omite, trae todos los años conocidos y los agrega (varias solicitudes en frío). |
query | str | vacío | Texto 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). |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
modo | Literal['zonal', 'consolidado'] | zonal | "zonal" o "consolidado". |
zona | str | vacío | Obligatorio 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. |
anio | int | None | ninguno | Añ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. |
query | str | vacío | Texto libre contra la etiqueta, año o URL del archivo (ignora tildes). |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
query | str | vacío | Texto 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). |
lang | Literal['es', 'en'] | es | "es" (default) o "en" |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
indicator_id | int | requerido | Un "indicator_id" de search_cepalstat_indicadores. |
pais | str | Ecuador | Paí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. |
lang | Literal['es', 'en'] | es | "es" (default) o "en" |
format | Literal['text', 'json'] | text | text | 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
fuente | Fuente | requerido | Catálogo a consultar (ver la lista de fuentes). |
query | str | vacío | Texto libre que se busca, sin distinguir tildes, en el título y los campos de cada archivo. Vacío devuelve todos. |
limit | int | 50 | Máximo de archivos devueltos (1-100, default 50). |
offset | int | 0 | Desplazamiento de paginación sobre los archivos encontrados. |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
fuente | Fuente | requerido | Una de arcsa, superbancos, seps, ineval, sgr, senescyt, sipa. |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
fuente | Fuente | requerido | Una de arcsa, superbancos, seps, ineval, sgr, senescyt, sipa. |
seccion | str | requerido | El `id` de una sección de list_archivo_secciones. |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
fuente | Fuente | requerido | inamhi o mag. |
query | str | vacío | Texto libre que se busca, sin distinguir tildes, en el id, nombre, título o resumen de la capa. Vacío devuelve todas. |
solo_wfs | bool | False | Devuelve solo las capas con WFS (datos de atributos). |
categoria | str | vacío | Solo para fuente="mag": una de sus 8 categorías. Se ignora para inamhi. |
format | Literal['text', 'json'] | text | Formato 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ámetro | Tipo | Default | Descripción |
|---|---|---|---|
fuente | Fuente | requerido | inamhi o mag. |
capa | str | requerido | El campo `capa` de search_capas_geo (INAMHI: nombre "geonode:..."; MAG: "categoria/store/nombre"). |
count | int | 5 | Número de objetos a traer (1-20, default 5). |
format | Literal['text', 'json'] | text | Formato de salida: `text` (default) o `json`. |
¿Falta un tool que necesitas? Proponlo.
Cómo colaborar