Busca convocatorias en el índice local de boletines oficiales.

Devuelve metadatos y enlaces, no el texto completo: para leer los requisitos de una convocatoria concreta, llama después a get_convocatoria.

IMPORTANTE: los títulos del BOE están escritos en lenguaje administrativo, no coloquial. Una oposición nunca se titula "oposiciones": se titula "Resolución de 8 de octubre de 2026, de la Subsecretaría, por la que se convoca proceso selectivo para ingreso en el Cuerpo...". Traducir la intención del usuario a ese vocabulario es tu trabajo, y el filtro más potente casi siempre es la sección, no las palabras.

Qué contiene cada sección:

• "II.B": empleo público. Procesos selectivos, pruebas selectivas, concursos-oposición, concursos de traslados, listas de admitidos y excluidos, tribunales. Aquí está todo lo que la gente llama "oposiciones".

• "III": bases reguladoras y convocatorias de becas, ayudas, subvenciones, premios y convenios. Aquí están las becas de verdad, con sus requisitos.

• "V.B": extractos de convocatorias de subvenciones y otros anuncios oficiales. Suele ser la versión corta de algo publicado en III, y es la sección con más volumen.

• "V.A": contratación pública. Licitaciones, adjudicaciones y formalizaciones de contratos. Útil para autónomos y empresas, no para quien busca empleo o una beca.

• "I", "II.A", "IV", "V.C": normativa general, nombramientos, administración de justicia y anuncios particulares. Rara vez son convocatorias a las que alguien pueda optar.

Cómo construir una buena consulta:

• "quiero oposiciones de informática" -> seccion="II.B" y keywords="informatica" (o "sistemas", "telecomunicaciones"). No pases "oposiciones" como keyword: no aparece en los títulos.

• "becas para estudiar un máster" -> seccion="III" y keywords="becas".

• "¿qué ha salido esta semana?" -> solo desde, sin keywords.

• "ayudas para autónomos en Madrid" -> seccion="III" y keywords="autonomos", y revisa el ámbito en los resultados en vez de filtrar por él, que no siempre viene.

• Si una búsqueda con varias palabras no devuelve nada, prueba con menos: las keywords se exigen TODAS.

Hay una tabla pequeña de sinónimos que traduce algunos términos coloquiales ("oposiciones" -> "proceso selectivo"), pero es una red de seguridad y no cubre el idioma entero: no te apoyes en ella.

Args: keywords: Palabras que deben aparecer TODAS en el título, sin distinguir mayúsculas ni acentos. Usa el vocabulario del boletín, no el del usuario. seccion: Sección del boletín, como "II.B" o "III". Es el filtro más útil; úsalo siempre que la intención del usuario esté clara. desde: Fecha de publicación mínima, en formato AAAA-MM-DD. hasta: Fecha de publicación máxima, en formato AAAA-MM-DD. watchlist: Nombre de una watchlist del usuario para quedarte solo con lo que ella hace coincidir. Si el usuario dice "lo de siempre" o "mis becas", mira primero qué watchlists tiene en la respuesta de source_health. include_vistas: Por defecto se omiten las ya enviadas en un digest. Ponlo a true si el usuario quiere revisar también esas. limite: Máximo de resultados, entre 1 y 200.

Devuelve una convocatoria con su TEXTO OFICIAL COMPLETO.

Llámalo cuando una convocatoria de search_convocatorias parezca encajar y haga falta leer sus requisitos: plazos, titulación, renta, méritos, baremos. Esos requisitos vienen en prosa jurídica y hay que leerlos; no se deducen del título.

La primera vez descarga el texto del boletín y lo guarda, así que la siguiente llamada es instantánea. Pídelo solo de las convocatorias que de verdad interesen: son 15.000 en el índice y descargarlas todas sería abusar de una fuente pública.

Al resumir: di qué pide la convocatoria, señala qué coincide y qué no con lo que sepas del perfil del usuario, y enlaza siempre al texto oficial. No afirmes que cumple o no cumple los requisitos: esa conclusión no es tuya, y equivocarse tiene consecuencias reales.

Args: id: El campo "id" de un resultado de search_convocatorias, con el formato "boe:BOE-A-2026-21635".

Informa de hasta dónde llega el índice local y si hay huecos.

Úsalo cuando una búsqueda no devuelva nada y haya que distinguir "no hay convocatorias que encajen" de "el índice no tiene esas fechas", o cuando el usuario pregunte si los datos están al día.

Explica por qué una convocatoria encaja (o no) con las watchlists.

Úsalo cuando el usuario pregunte "¿por qué me sale esto?" o "¿por qué no me sale lo que busco?". Devuelve el desglose del score por dimensiones: palabras clave en el título, sección, departamento y ámbito.

Ojo con lo que significa: el score mide afinidad temática, no elegibilidad. Que puntúe alto no dice nada sobre si el usuario cumple los requisitos; eso está en el texto y se lee con get_convocatoria.

Args: id: El campo "id" de un resultado de search_convocatorias. watchlist: Para explicar solo una. Sin esto se explican todas.

Convocatorias con el plazo abierto que cierran dentro de N días.

Úsalo para "¿qué se me acaba pronto?" o para un repaso semanal.

IMPORTANTE: solo aparecen las convocatorias cuyo plazo se ha podido determinar leyendo su texto. Muchas lo expresan como "veinte días hábiles desde la publicación", que no se puede calcular sin el calendario de festivos, y esas no salen aquí. Esta lista no es exhaustiva: no le digas al usuario que no le vence nada más.

Args: dias: Ventana en días naturales desde hoy. Por defecto 7. limite: Máximo de resultados.

Anota que el usuario ha solicitado una convocatoria.

Sirve de registro de solicitudes, que después se consulta con list_solicitudes. Llámalo cuando el usuario diga que la ha pedido, que la ha presentado o que ya la ha entregado.

Args: id: El campo "id" de un resultado de search_convocatorias. notas: Lo que el usuario quiera recordar: por dónde la presentó, qué documentación envió, un número de registro. fecha: Fecha de la solicitud en formato AAAA-MM-DD. Por defecto hoy.

Descarta una convocatoria para que no vuelva a aparecer.

Llámalo cuando el usuario diga que algo no le interesa o no le aplica. Las descartadas se omiten de las búsquedas y de los avisos de plazo.

Guarda el motivo si el usuario lo da: sirve para entender después por qué se descartó, y para afinar sus watchlists.

Args: id: El campo "id" de un resultado de search_convocatorias. motivo: Por qué no le interesa, con las palabras del usuario.

Lista las convocatorias que el usuario ha marcado como solicitadas.

Úsalo para "¿a qué me he apuntado?" o para repasar lo presentado. Devuelve también las notas que se guardaron con cada una.

Args: incluir_descartadas: Añade además las descartadas, con su motivo.