Skip to main content
Glama

Búsquedas El Peruano (Conector MCP - No oficial)

elPeruanoMCP

Licencia Python MCP Local

Servidor MCP local para buscar y leer el Diario Oficial El Peruano (normas, resoluciones, cuadernillos y PDFs) desde tu harness MCP.

Herramienta no oficial: sin afiliacion con EL PERUANO y sin aceptacion de contribuciones externas. Ver Aviso legal.

Fuente de datos

busquedas.elperuano.pe (publico)

Almacenamiento

Ninguno — el servidor nunca guarda archivos; los PDFs se entregan como URL

Herramientas

9

Instalacion

Opcion 1: .mcpb (one-click, Claude Desktop)

  1. Descarga el asset elPeruanoMCP.mcpb (nombre fijo, siempre la ultima version) de la seccion Releases.

  2. En Claude Desktop: Ajustes > Extensiones > instalar desde archivo, y selecciona el .mcpb.

  3. Claude Desktop se encarga del entorno y las dependencias por ti.

Related MCP server: CREG MCP Server

Actualizacion

  • El servidor se auto-chequea en cada arranque: si publicamos una version mas nueva que la tuya, tu agente vera el aviso UPDATE DISPONIBLE y te pedira descargar elPeruanoMCP.mcpb de Releases e instalarlo de nuevo (arrastralo como la primera vez). Se desactiva con EPERUANO_UPDATE_CHECK=0.

  • Cada version reemplaza el mismo archivo (elPeruanoMCP.mcpb): la pagina de Releases siempre muestra una sola tarjeta con la ultima.

Opcion 2: uv (recomendada para desarrolladores)

  1. Clona el repo: git clone https://github.com/pipaacebedo/elPeruanoMCP

  2. Entra a la carpeta: cd elPeruanoMCP

  3. Instala las dependencias: uv sync

  4. Lanza el servidor: uv run elperuano-mcp serve

Opcion 3: pip (sin uv)

  1. Instala el paquete: pip install .

  2. Lanza el servidor: elperuano-mcp serve

Conectar el cliente

  • Claude Code: claude mcp add elPeruanoMCP -- uv --directory RUTA/elPeruanoMCP run elperuano-mcp serve

  • ChatGPT: seccion MCP/connectors de tu setup (config equivalente)

  • Otros harness: config MCP equivalente (command + args)

"mcpServers": {
  "elPeruanoMCP": {
    "command": "uv",
    "args": ["--directory", "RUTA/elPeruanoMCP", "run", "elperuano-mcp", "serve"]
  }
}

Al ser local, no hay autenticacion, tokens ni limites de ningun tipo.

Herramientas

Tool

Uso

buscar_dispositivos

Busqueda full-text con filtros (cuadernillo, sector post-filtro, fecha, rango) y paginacion deduplicada

buscar_por_op

Puntual por numero de orden (NNNNNNN-N); devuelve campos planos

obtener_dispositivo

Sumilla, tipo, numero, sector, fechas, texto integral (+ rango desde/hasta opcional) y pdf_url

obtener_dispositivo_texto

Texto por parrafos en rangos, con metadatos del dispositivo

obtener_cuadernillo_texto

Lee el PDF del cuadernillo en memoria: busca texto dentro del PDF (query) o lee por rangos de paginas

listar_cuadernillos

Cuadernillos por fecha o rango (max 7 dias), con filtro por tipo y pdf_url

descargar_pdf / descargar_cuadernillo

Devuelven la URL publica del PDF (no descargan nada)

listar_tipos_publicacion

Siglas y cuales tipos tienen dispositivos individuales

Como consultar

Necesitas

Como

Frase exacta

Entre comillas dobles: '"prescripcion adquisitiva de dominio"'

Tema que cae en cuadernillos (PC/DJ/JU/CA)

buscar_dispositivos trae cuadernillos_con_coincidencias → obtener_cuadernillo_texto(codigo, query="...") localiza el texto dentro del PDF

Puntual por OP

obtener_dispositivo(op="2558398-1") — el cuadernillo se auto-resuelve

Un dia puntual

fecha="20260923" (acepta 2026-09-23 o 23/09/2026)

Un rango

fecha_ini + fecha_fin

Solo Normas Legales

cuadernillo="NL" (siglas: NL, BO, EX, PC, DJ, JU, SE, CA, IN, TU)

Variables de entorno (opcionales)

Variable

Default

Para que

EPERUANO_BASE_URL

https://busquedas.elperuano.pe

Origen de los datos

EPERUANO_TIMEOUT

60

Timeout HTTP

EPERUANO_CACHE_TTL

300

Cache en memoria (0 = off)

EPERUANO_CACHE_BYTES

32 MB

Presupuesto de cache por bytes

EPERUANO_CACHE_MAX_ENTRY

3 MB

No cachear paginas mayores a esto

EPERUANO_MAX_PAGINAS

20

Tope de paginas por llamada

EPERUANO_MAX_CONCURRENCY

3

Requests simultaneos hacia el sitio

Limitaciones y diseno

Aspecto

Detalle

Filtros web Entidad/Tipo de dispositivo

No aplican server-side: incluye el organismo en consulta o usa sector como post-filtro

coincidencias_texto

Contador de coincidencias de texto del sitio (no dispositivos unicos); dispositivos_unicos cuenta los devueltos

PC/DJ/JU/CA/IN/TU

Sin dispositivo individual: el texto integral vive en el PDF del cuadernillo (obtener_cuadernillo_texto lo lee por paginas o con query)

Streaming

Paginas de busqueda se leen con corte en </main> (algunas superan los 100 MB de HTML; lo util es ~40-140 KB)

Cortesia

Cache por bytes + single-flight + semaforo de concurrencia para no sobrecargar la fuente oficial

Latencia

Busquedas sin filtro de cuadernillo pueden tardar 10-40 s (el sitio genera la pagina completa)

  • Herramienta de terceros no oficial, sin afiliacion con EL PERUANO ni con ninguna entidad publica.

  • Provista tal cual; el autor no responde por el uso que se le de ni por la disponibilidad del sitio.

  • Los datos son de acceso publico en busquedas.elperuano.pe; respeta la fuente: no la uses para scraping masivo.

  • Proyecto personal: no se aceptan contribuciones externas ni se ofrece soporte. Puedes forkarlo y adaptarlo a tu criterio.

Licencia

Apache-2.0.

Available Tools

9 tools
buscar_dispositivosBuscando dispositivosA

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.

Inputs: fecha, start, sector, paginas, +4 more.

buscar_por_opBuscando por orden de publicaciónC

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

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

Inputs: op (required).

descargar_cuadernilloResolviendo URL del cuadernilloA

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

Inputs: codigo (required).

descargar_pdfResolviendo URL del PDFA

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

Inputs: op (required), cuadernillo (required).

listar_cuadernillosListando cuadernillosA

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

Inputs: tipo, fecha, fecha_fin.

listar_tipos_publicacionListando tipos de publicaciónA

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

Inputs: no named parameters.

obtener_cuadernillo_textoLeyendo el texto del cuadernilloA

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.

Inputs: codigo (required), query, pagina_desde, pagina_hasta.

obtener_dispositivoObteniendo dispositivoA

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.

Inputs: op, desde, hasta, cuadernillo.

obtener_dispositivo_textoLeyendo el texto del dispositivoA

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

Inputs: op, desde, hasta, cuadernillo.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 9 tools

    Disambiguation4/5

    Most tools have distinct purposes: buscar_por_op is a targeted OP lookup while buscar_dispositivos is free-text search, and descargar_pdf vs descargar_cuadernillo target different resources. The one soft overlap is obtener_dispositivo vs obtener_dispositivo_texto (both return device text), but the descriptions explicitly state when to use the paragraph-ranged variant.

    Naming Consistency5/5

    All tools follow a consistent Spanish verb_noun snake_case pattern: buscar_*, obtener_*, listar_*, descargar_*. No mixing of conventions, and names clearly telegraph the action and target resource.

    Tool Count5/5

    Nine tools is well-scoped for a read-only gazette access server, covering search, retrieval, listing, and download without redundancy. Each tool earns its place, no bloat.

    Completeness4/5

    The surface covers the full read lifecycle: search by OP and free text, fetch device/full text, list publication types and cuadernillos, and obtain device/cuadernillo PDF URLs plus in-PDF text search. Minor gaps (e.g. no sector-wide corpus filtering, only page-level post-filter) are documented workarounds rather than dead ends.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP server for searching and extracting official announcements, decrees, and resolutions from the Argentine Official Gazette (Boletín Oficial de la República Argentina). It enables LLMs to perform real-time searches and retrieve verbatim legal text with complete juridical fidelity.
      14
      19 npm
      3
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables MCP clients to search Colombian energy and gas resolutions and legal opinions, read them in chunks or by internal search, and explore each rule's regulatory graph with validity computed from the texts themselves.
      4
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables local MCP clients to search and read Peru's official legal information system, including legal norms and jurisprudence, with tools for full-text search, structure mapping, targeted reading, and filters. It provides clean content without storing files, using stdio transport and public session authentication.
      7
      6
      Apache 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables local, credential-free searching and reading of Peru's public procurement system—including selection processes, contracts, documents, and annual procurement plans—through MCP tools, returning clean data and direct download URLs without storing files.
      25
      1
      Apache 2.0