Busca dispositivos y cuadernillos en El Peruano.

Args: consulta: texto libre; frases exactas entre comillas dobles, ej: '"prescripcion adquisitiva de dominio"'. El sitio combina palabras por coincidencia de texto y no garantiza un AND estricto entre todas. cuadernillo: sigla del tipo de publicacion (ver listar_tipos_publicacion): NL, BO, EX, PC, DJ, JU, SE, CA, IN, TU. Opcional. sector: post-filtro por subcadena sobre el campo sector de los resultados obtenidos (ej: "salud"). NO filtra todo el corpus: solo la pagina(s) de resultados actual. fecha: dia puntual YYYYMMDD. fecha_ini, fecha_fin: rango de fechas YYYYMMDD. start: desplazamiento de resultados (pagina N -> start = N*20). paginas: paginas consecutivas a traer en una sola llamada (1 = 20 resultados).

Nota de latencia: sin filtro de cuadernillo, el sitio puede tardar 10-40 s en generar la respuesta (con filtro NL/BO es mas rapido). El sitio pagina por coincidencias de texto y puede repetir dispositivos entre paginas: usa paginas (deduplica internamente) en lugar de start manual.

Devuelve: coincidencias_texto: contador del sitio (coincidencias de texto, no dispositivos unicos). dispositivos_unicos: cantidad de dispositivos individuales devueltos. ms: duracion de la llamada en milisegundos. data: dispositivos con pagina individual (sector, tipo, numero, fecha, titulo, url). cuadernillos_con_coincidencias: cuando las coincidencias caen en cuadernillos SIN pagina individual (PC/DJ/JU/CA/IN/TU) el resultado son cuadernillos (compacto): codigo, fecha, paginas y pdf_url; el texto integral esta en el PDF. siguiente_start: start para la proxima pagina, si hay mas. cacheado: true si la respuesta vino de la cache de resultados. sin_resultados_motivo + nota: cuando no hay resultados, con la causa y sugerencias.

Busqueda puntual por numero de orden de publicacion (OP).

Args: op: formato NNNNNNN-N, ej '2558398-1'.

Devuelve el dispositivo completo: sumilla, tipo, numero, sector, fechas y texto integral, mas pdf_url y thumbnail.

Nota: el texto integral puede ser muy largo. Para documentos extensos usa obtener_dispositivo_texto (rangos de parrafos) o limita aqui con desde/hasta.

Args: cuadernillo: sigla de publicacion (ver listar_tipos_publicacion). Opcional: si se omite, se auto-resuelve por OP. op: numero de orden, ej '2558398-1'. desde, hasta: opcionales; rango de parrafos 1-indexed (inclusivo). Vacios = texto completo.

Texto de un dispositivo por parrafos, en dosis controladas (para documentos largos sin saturar el contexto).

Incluye los metadatos del dispositivo (sumilla, tipo, numero, sector, fecha). Sin tope de parrafos: usa rangos razonables.

Args: cuadernillo: sigla de publicacion. Opcional: si se omite, se auto-resuelve por OP. op: numero de orden. desde, hasta: rango de parrafos (1-indexed, inclusivo).

Lista cuadernillos publicados en una fecha o rango (con pdf_url).

Args: fecha: YYYYMMDD, AAAA-MM-DD o DD/MM/AAAA (vacio = los ultimos publicados). fecha_fin: opcional; con fecha, recorre el rango hasta esta fecha (maximo 7 dias INCLUSIVE por llamada). tipo: filtro por sigla de los cuadernillos listados (ej "NL").

URL de descarga del PDF de un dispositivo individual.

El MCP NUNCA almacena archivos: devuelve la URL publica en busquedas.elperuano.pe para que el usuario descargue por su cuenta.

Args: cuadernillo: sigla de publicacion (ver listar_tipos_publicacion). op: numero de orden, ej '2558398-1'.

URL de descarga del PDF completo de un cuadernillo.

Es la unica via de texto para cuadernillos SIN dispositivo individual (PC/DJ/JU/CA/IN/TU). El MCP no descarga ni guarda: devuelve la URL publica para el cliente.

Devuelve tambien url_viewer (pagina visor del cuadernillo). Nota: el sitio publica el archivo con nombres con sufijo de pagina inicial (ej PC20260606_4335.pdf); otras URLs del mismo cuadernillo (sin sufijo) tambien sirven el mismo PDF.

Args: codigo: codigo TIPO+FECHA, ej 'NL20230923' o 'PC20260927'.

Busca texto DENTRO del PDF de un cuadernillo (query) o lee su texto por paginas, en rangos controlados.

Es la unica via de lectura del texto integral para cuadernillos SIN pagina individual (PC/DJ/JU/CA/IN/TU): el PDF se descarga en memoria y se procesa pagina por pagina; nunca se guarda en disco.

Args: codigo: codigo TIPO+FECHA, ej 'PC20260927'. pagina_desde, pagina_hasta: rango de paginas del PDF (1-indexed, inclusivo). Maximo 10 paginas por llamada. query: opcional; texto a buscar en TODAS las paginas del PDF (case-insensitive). Si se indica, el resultado son las paginas que contienen el texto, con extractos de contexto (ignora pagina_desde/pagina_hasta). Para PDFs de cientos de paginas.

Siglas de cuadernillos (tipoPublicacion) y sus titulos.

PC/DJ/JU/CA/IN/TU no tienen dispositivo individual; para esos la busqueda devuelve cuadernillos_con_coincidencias y el texto integral solo vive en el PDF del cuadernillo (descargar_cuadernillo).