Boletín Claro

Escribe una nota en una de tus entradas: lo que hay que hacer, lo que ya se ha hecho o lo que conviene recordar sobre esa oportunidad. Indica 'entrada_id' (el 'id' que aparece en listar_entradas o mis_novedades) y 'nota'. Si añades 'fecha' (AAAA-MM-DD), la nota se convierte en un vencimiento del calendario y se avisa por email 7 días antes y el día antes: úsala para plazos de presentación, reuniones o recordatorios. Con 'cliente' (opcional, solo modo clientes) la nota queda bajo ese cliente en vez de a la vista de todo el espacio de trabajo. Es la misma nota que se ve en boletinclaro.es. Requiere iniciar sesión. Coste: 0 créditos de lectura; se mantienen los límites y confirmaciones del plan.

Archiva una entrada del inbox bajo uno o más clientes: es la segunda criba, la decisión de que esa oportunidad es relevante para ese cliente. Indica 'entrada_id' (el 'id' de listar_entradas) y 'clientes' (nombre o nombres separados por comas, tal como aparecen en listar_clientes). La entrada pasa al flujo de trabajo de cada cliente y la alerta que la detectó se vincula automáticamente al cliente. Requiere tener el modo clientes activado. Coste: 0 créditos de lectura; se mantienen los límites y confirmaciones del plan.

Borra una de tus alertas de forma PERMANENTE, junto con todo su histórico (avisos, notas y documentos). Indica el 'nombre' de la alerta tal como aparece en listar_mis_alertas. Es IRREVERSIBLE: llama primero con confirmar=false (por defecto) para avisar al usuario de qué se va a borrar, y solo con su visto bueno vuelve a llamar con confirmar=true. Si solo quiere dejar de recibir avisos sin perder el histórico, usa pausar_alerta en su lugar. Requiere iniciar sesión. Coste: 0 créditos de lectura; se mantienen los límites y confirmaciones del plan.

Borra una nota de una entrada. Indica 'nota_id' (el id que muestra listar_notas). El borrado es definitivo y solo puedes borrar las notas que escribiste tú; si la nota tenía fecha, deja de aparecer en el calendario y de generar avisos. Requiere iniciar sesión. Coste: 0 créditos de lectura; se mantienen los límites y confirmaciones del plan.

Busca en los boletines oficiales españoles (BOE, BORME y los boletines de las comunidades autónomas) cualquier cosa que NO sea una subvención ni una licitación: normativa, oposiciones, anuncios, nombramientos, edictos, etc. Para subvenciones o licitaciones usa buscar_oportunidades. Devuelve cada resultado con su boletín, fecha, lugar y enlace. Gratis con una cuenta de Boletín Claro. Parámetros: 'tipos' (opcional, acota a códigos de boletín como BOE o BOJA) y 'limite' (1-25, por defecto 10). Coste: 1 crédito del saldo compartido MCP/API.

Busca empresas por nombre (o parte del nombre) y devuelve sus NIF junto al total de dinero público recibido, para poder elegir una y consultar su detalle con perfil_empresa. Úsala cuando el usuario menciona una empresa por su nombre y no por su NIF. Gratis con una cuenta de Boletín Claro. Coste: 5 créditos del saldo compartido MCP/API.

Busca subvenciones y licitaciones públicas ABIERTAS que encajen con el perfil de una empresa o autónomo, descritas en lenguaje natural. Es la herramienta estrella para '¿qué ayudas o contratos hay para mí?'. Devuelve cada oportunidad con su importe, plazo, lugar y un enlace a la ficha de Boletín Claro. Gratis con una cuenta de Boletín Claro. Parámetros: 'tipo' (subvenciones/licitaciones/ambos), 'zona' (CCAA, provincia o municipio) y 'limite' (1-20, por defecto 8). Para que el usuario reciba avisos automáticos de lo nuevo, dirígelo a crear una alerta en boletinclaro.es. Coste: 1 crédito del saldo compartido MCP/API.

Crea una alerta para que Boletín Claro vigile el dinero público que te interesa y te avise por email cuando salga algo nuevo que encaje. Es el paso de la búsqueda puntual a la vigilancia continua. Toma una 'descripcion' en lenguaje natural (sector o actividad, zona e importes si aplican); no necesitas saber códigos. IMPORTANTE: llama primero con confirmar=false (por defecto) para mostrar al usuario un resumen de la alerta y pedir su visto bueno; solo cuando lo confirme, vuelve a llamar con confirmar=true para crearla. Requiere haber iniciado sesión. Coste: 0 créditos de lectura; se mantienen los límites y confirmaciones del plan.

Crea un nuevo cliente (empresa u organización) en tu modo clientes, para poder archivar entradas bajo él. Toma 'nombre' y opcionalmente 'descripcion' (quién es, sector, ubicación, qué busca): esa descripción es el contexto que se usará después para decidir qué entradas le interesan, así que merece la pena rellenarla. Si tu cuenta no tiene el modo clientes activado, te lo indicará y no lo creará. Requiere iniciar sesión. Coste: 0 créditos de lectura; se mantienen los límites y confirmaciones del plan.

Quita una entrada del flujo de trabajo de uno o más clientes: es el inverso de asignar_entrada, para deshacer un archivado que no tocaba. Indica 'entrada_id' (el 'id' de la entrada) y 'clientes' (nombre o nombres separados por comas, tal como aparecen en listar_clientes). La entrada pierde el estado que tenía en el flujo de ese cliente; si ya no queda bajo ningún cliente, vuelve al inbox (listar_entradas). Desasignar una entrada que no estaba asignada a ese cliente no es un error. Requiere tener el modo clientes activado. Coste: 0 créditos de lectura; se mantienen los límites y confirmaciones del plan.

Descarta una o varias entradas del inbox que NO interesan a ningún cliente: es la acción de 'no me interesa, fuera del inbox', el complemento de asignar_entrada al terminar la criba. Indica 'entradas' (un id, o varios separados por comas, tal como aparecen en listar_entradas). No borra nada: la entrada queda marcada como descartada y puede recuperarse desde boletinclaro.es. Descartar una entrada ya descartada no es un error. Requiere tener el modo clientes activado. Coste: 0 créditos de lectura; se mantienen los límites y confirmaciones del plan.

Desvincula una de tus alertas de uno o más clientes del modo clientes: es el inverso de vincular_alerta, para cuando una alerta deja de describir lo que busca un cliente. Solo quita el vínculo (el contexto que muestra listar_clientes); no borra la alerta ni toca las entradas ya archivadas. Indica 'alerta' (nombre tal como aparece en listar_mis_alertas) y 'clientes' (nombre o nombres separados por comas, tal como aparecen en listar_clientes). Desvincular una alerta que no estaba vinculada no es un error. Requiere tener el modo clientes activado. Coste: 0 créditos de lectura; se mantienen los límites y confirmaciones del plan.

Devuelve el detalle completo de UNA convocatoria de subvenciones (BDNS) a partir de su código (el que aparece en el enlace /subvencion que devuelve buscar_oportunidades): organismo, importe total, número de concesiones y beneficiarios, y principales beneficiarios. Úsala para resumir una subvención sin salir de Boletín Claro. Gratis con una cuenta de Boletín Claro. Coste: 5 créditos del saldo compartido MCP/API.

Devuelve el detalle completo de UNA licitación pública (PLACSP) a partir del 'id' de su enlace /licitacion (el que devuelve buscar_oportunidades), o de su nif_organo y expediente: importe, plazo, lugar de ejecución, tipo y procedimiento, CPV, lotes, órgano de contratación y adjudicatarios si ya está adjudicada. Úsala para resumir o comparar licitaciones sin abrir el portal oficial. Gratis con una cuenta de Boletín Claro. Coste: 5 créditos del saldo compartido MCP/API.

Edita una de tus alertas: cambia lo que vigila (con 'nueva_descripcion' en lenguaje natural) y/o su nombre (con 'nuevo_nombre'). Identifícala por su 'nombre' actual. Cambiar la descripción rehace el criterio de búsqueda, así que muéstrale primero al usuario el resumen (confirmar=false) y aplica el cambio solo con confirmar=true; renombrar no necesita confirmación. Requiere iniciar sesión. Coste: 0 créditos de lectura; se mantienen los límites y confirmaciones del plan.

Actualiza la DESCRIPCIÓN de un cliente del modo clientes: quién es, su sector, ubicación, qué busca y en qué estado está. Es el contexto con el que se decide qué entradas le interesan, así que mantenla al día: si al triar con el usuario aprendes algo nuevo de un cliente (ya no le interesa X, ahora busca Y, ha ganado tal contrato), propónle actualizarla y hazlo aquí. Toma 'cliente' (nombre tal como aparece en listar_clientes) y 'descripcion'. La nueva descripción SUSTITUYE a la anterior entera: parte de la existente y conserva lo que siga siendo válido. Muestra al usuario la nueva descripción antes de guardarla. Requiere tener el modo clientes activado. Coste: 0 créditos de lectura; se mantienen los límites y confirmaciones del plan.

Lista tus clientes (modo clientes, para asesorías y gestorías) junto con las alertas que nutren a cada uno: esas alertas describen qué vigila cada cliente, así que son el contexto para decidir a qué cliente pertenece cada entrada del inbox. Úsala para '¿qué clientes tengo?' o antes de asignar entradas. Con más de 5 clientes la lista sale resumida; pasa 'cliente' para ver la ficha completa de uno. Requiere tener el modo clientes activado. Coste: 1 crédito del saldo compartido MCP/API.

Devuelve el inbox: las entradas que han encajado con tus alertas pero que aún no has archivado bajo ningún cliente. Es la primera criba de Boletín Claro; revísalas para decidir, con el contexto de cada cliente (listar_clientes), cuáles son relevantes y para quién. Cada entrada trae su 'id' para asignarla con asignar_entrada. Parámetros opcionales: 'limite' (por defecto 25, máximo 60) y 'alerta' (acota a una alerta por su nombre). Requiere tener el modo clientes activado. Coste: 1 crédito del saldo compartido MCP/API.

Lista tus alertas temáticas y su estado: si están activas, su frecuencia de envío, los boletines que vigilan y si cada uno está al día o pendiente de procesar. Úsala para '¿qué alertas tengo?' o '¿están funcionando mis alertas?'. Coste: 1 crédito del saldo compartido MCP/API.

Muestra las notas escritas en una entrada (lo anotado sobre esa oportunidad: gestiones hechas, plazos, pendientes), de la más reciente a la más antigua y con la fecha de vencimiento de cada una si la tiene. Indica 'entrada_id' (el 'id' de listar_entradas o mis_novedades) y, opcionalmente, 'cliente' para ver además las notas privadas de ese cliente. Cada nota trae su id, que es lo que necesita borrar_nota. Requiere iniciar sesión. Coste: 1 crédito del saldo compartido MCP/API.

Devuelve las novedades recientes que han encajado con TUS alertas: las últimas oportunidades (subvenciones, licitaciones, anuncios) detectadas para tu espacio de trabajo, con su boletín, fecha, importe y plazo si los hay, y enlace. Úsala para '¿qué me ha llegado?' o '¿hay algo nuevo en mis alertas?'. Parámetros opcionales: 'dias' (ventana hacia atrás, por defecto 7) y 'limite' (máximo de resultados, por defecto 15). Coste: 1 crédito del saldo compartido MCP/API.

Pausa una de tus alertas para dejar de recibir avisos sin borrarla. Indica el 'nombre' de la alerta tal como aparece en listar_mis_alertas. Reversible con reactivar_alerta. Requiere iniciar sesión. Coste: 0 créditos de lectura; se mantienen los límites y confirmaciones del plan.

Devuelve el perfil de dinero público de una empresa (por NIF), cruzando todas las fuentes: subvenciones recibidas (BDNS), licitaciones y contratos públicos GANADOS (PLACSP), proyectos de I+D europeos (CORDIS), contratos UE (TED) y datos mercantiles (BORME), con el total, el número de contratos/concesiones, el periodo y los principales organismos/sectores. Úsala para '¿qué licitaciones o contratos ha ganado X?', '¿qué subvenciones ha recibido X?', '¿cuánto dinero público recibió X?' o due diligence ('háblame de la empresa X'). Da agregados y un enlace a la ficha completa, no el listado contrato a contrato. Si solo tienes el nombre, usa antes buscar_empresa para obtener el NIF. Gratis con una cuenta de Boletín Claro. Coste: 5 créditos del saldo compartido MCP/API. Gratis: máximo cinco llamadas al mes por workspace, compartidas con /v1/empresas/{nif}.

Reactiva una alerta que estaba pausada para volver a recibir avisos. Indica el 'nombre' de la alerta tal como aparece en listar_mis_alertas. Requiere iniciar sesión. Coste: 0 créditos de lectura; se mantienen los límites y confirmaciones del plan.

Resume lo publicado en un boletín oficial un día concreto: '¿qué ha salido hoy en el BOE?' o '¿qué publicó el BOCM el lunes?'. Devuelve las entradas agrupadas por apartado o tipo (subvenciones, licitaciones, nombramientos, normativa…) con su número y una muestra de títulos, importes y plazos. Parámetros: 'fuente' (código del boletín: BOE, BOCM, BDNS, DOG, BOPV, BOJA…) y 'fecha' (AAAA-MM-DD; vacío = hoy). Es un índice del día; para el detalle de una entrada usa buscar_boletines. Gratis con una cuenta de Boletín Claro. Coste: 1 crédito del saldo compartido MCP/API.

Resume lo que ha encajado con tus alertas esta semana (de lunes a hoy), agrupado por alerta, usando los resúmenes que Boletín Claro ya generó. Úsala para 'resúmeme la semana' o '¿qué ha pasado en mis alertas estos días?'. Coste: 1 crédito del saldo compartido MCP/API.

Muestra UNA de tus entradas por su id: lo que ya ves en su página de boletinclaro.es. Devuelve título, boletín, fecha, importe, plazo, lugar y tipo de convocatoria o procedimiento; en qué punto está en tu flujo (en el inbox, archivada bajo qué cliente(s) y con qué estado, o descartada); la alerta que la detectó; sus fechas clave; el IDENTIFICADOR DE ORIGEN (código BDNS o expediente) con la herramienta que sigue desde él (detalle_convocatoria / detalle_licitacion); los datos de su ficha, el resumen generado si lo hay, los enlaces y sus notas. Indica 'entrada_id' (el 'id' de listar_entradas o mis_novedades, o el enlace /entradas/… entero) y, opcionalmente, 'cliente' para ver además las notas privadas de ese cliente. Funciona con entradas del inbox, archivadas o descartadas. Requiere iniciar sesión. Coste: 1 crédito del saldo compartido MCP/API.

Crea una vigilancia de una o varias EMPRESAS concretas (competidores, clientes, proveedores) y avisa por email cuando tengan movimientos en el dinero público: contratos, subvenciones o cambios mercantiles. Para vigilar un TEMA (un sector o tipo de ayuda) usa crear_alerta; esta es para empresas con nombre y apellidos. Toma 'empresas' (nombres o NIFs separados por comas; por cada nombre se busca su NIF). IMPORTANTE: llama primero con confirmar=false (por defecto) para mostrar al usuario qué empresas se van a vigilar y pedir su visto bueno; solo cuando lo confirme, vuelve con confirmar=true. Es una función de pago. Requiere iniciar sesión. Coste: 5 créditos por cada nombre que haya que resolver a NIF; 0 si se envían NIF. Se mantienen los límites y confirmaciones del plan.

Vincula una de tus alertas a uno o más clientes del modo clientes, para que cuente entre las alertas que los nutren (el contexto que muestra listar_clientes). Complementa el vínculo automático que hace asignar_entrada al archivar: úsala cuando una alerta recién creada deba colgar de un cliente sin esperar a su primera asignación. Indica 'alerta' (nombre tal como aparece en listar_mis_alertas) y 'clientes' (nombre o nombres separados por comas, tal como aparecen en listar_clientes). Vincular una alerta ya vinculada no es un error. Requiere tener el modo clientes activado. Coste: 0 créditos de lectura; se mantienen los límites y confirmaciones del plan.