Lectura de URL EnriProxy

Previous value: -"Captura de pantalla renderizada de la página (juegos en canvas, dashboards, mapas, splash pages donde el texto no describe lo que se ve). ELIGE según TU modelo: (1) Si NO puedes ver imágenes: usa 'analyze' — el servidor captura la página (hasta 3 segmentos de scroll) y te devuelve un TEXTO que describe lo que se ve ('Análisis visual: ...'), sin imágenes que rompan tu request. (2) Si SÍ puedes ver imágenes: omite el parámetro o usa 'auto' (captura sólo cuando el texto es escaso, <1,500 caracteres) o 'force' (captura siempre); las imágenes llegan como bloques de imagen MCP (~1,400 tokens de visión por segmento). (3) Si no necesitas nada visual y quieres ahorrar tokens: 'none'. Solo aplica a la lectura única completa por url (no cursor/ranges). Cuando no se captura, la respuesta lo indica con screenshot_status='skipped' y su razón."New value: +"Captura de pantalla renderizada de la página (juegos en canvas, dashboards, mapas, splash pages donde el texto no describe lo que se ve). ES OBLIGATORIO elegirla según TU modelo: (1) Si tu modelo NO puede ver imágenes (sin visión): es OBLIGATORIO usar 'analyze' — el servidor captura la página (hasta 3 segmentos de scroll) y te devuelve un TEXTO que describe lo que se ve ('Análisis visual: ...'), sin imágenes; cualquier otro modo te entrega bloques de imagen que tu modelo NO puede procesar y el material visual se pierde. (2) Si tu modelo SÍ puede ver imágenes: omite el parámetro o usa 'auto' (captura sólo cuando el texto es escaso, <1,500 caracteres) o 'force' (captura siempre); las imágenes llegan como bloques de imagen MCP (~1,400 tokens de visión por segmento). (3) Si no necesitas nada visual y quieres ahorrar tokens: 'none'. Solo aplica a la lectura única completa por url (no cursor/ranges). Cuando no se captura, la respuesta lo indica con screenshot_status='skipped' y su razón."

Previous value: -"Cursor opaco devuelto por una llamada previa de `web_fetch` para paginación. Nunca invente este valor."New value: +"Cursor opaco devuelto por una llamada previa de `web_fetch` para paginación. Nunca invente este valor. Envíe también `url` cuando la conozca para activar la recuperación automática si el cursor expiró."

Added value: +{
+  "description": "Captura de pantalla renderizada de la página (juegos en canvas, dashboards, mapas, splash pages donde el texto no describe lo que se ve). ELIGE según TU modelo: (1) Si NO puedes ver imágenes: usa 'analyze' — el servidor captura la página (hasta 3 segmentos de scroll) y te devuelve un TEXTO que describe lo que se ve ('Análisis visual: ...'), sin imágenes que rompan tu request. (2) Si SÍ puedes ver imágenes: omite el parámetro o usa 'auto' (captura sólo cuando el texto es escaso, <1,500 caracteres) o 'force' (captura siempre); las imágenes llegan como bloques de imagen MCP (~1,400 tokens de visión por segmento). (3) Si no necesitas nada visual y quieres ahorrar tokens: 'none'. Solo aplica a la lectura única completa por url (no cursor/ranges). Cuando no se captura, la respuesta lo indica con screenshot_status='skipped' y su razón.",
+  "enum": [
+    "auto",
+    "force",
+    "none",
+    "analyze"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Longitud de la página sin decoraciones dentro de `content` (ventanas de rangos direccionan esta base).",
+  "type": "integer"
+}

Added value: +{
+  "description": "Offset base-cero dentro de `content` donde empieza la página sin decoraciones (lecturas url con encabezado de estado).",
+  "type": "integer"
+}

Added value: +{
+  "description": "True cuando el cursor enviado había expirado y la herramienta re-obtuvo la url con los mismos parámetros; los offsets aplican a la captura nueva.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Nota en español describiendo la recuperación automática de cursor expirado.",
+  "type": "string"
+}

Added value: +{
+  "description": "Descripciones en TEXTO de cada segmento de captura, generadas del lado del servidor con el modo screenshot='analyze' (para modelos que no pueden ver imágenes). Un elemento null significa que ese segmento falló el análisis.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Razón de captura o omisión: auto_thin_text, forced, analyze_requested, image_target (la URL apuntaba a una imagen y va adjunta inline), auto_rich_text, background_verification, http_error_status, capture_failed, lane_unsupported.",
+  "type": "string"
+}

Added value: +{
+  "description": "Número de segmentos de captura entregados como bloques de imagen MCP (el payload base64 no viaja en structuredContent).",
+  "type": "integer"
+}

Added value: +{
+  "description": "'captured' cuando el proxy adjuntó capturas como bloques de imagen; 'analyzed' cuando las convirtió en texto del lado del servidor (modo 'analyze'); 'skipped' cuando no (solo cuando se pidió screenshot).",
+  "type": "string"
+}

Added value: +[
+  {
+    "url": "https://example.com/docs"
+  },
+  {
+    "limit_chars": 4000,
+    "offset_chars": 0,
+    "url": "https://example.com/docs"
+  },
+  {
+    "cursor": "123e4567-e89b-12d3-a456-426614174000",
+    "limit_chars": 20000,
+    "offset_chars": 20000
+  }
+]

Added value: +{
+  "description": "Acción especial sobre un cursor: 'delete' libera en el servidor la captura asociada al cursor (envíelo junto con `cursor`; los demás parámetros se ignoran). La respuesta es {deleted, cursor}: true si existía y se liberó, false si ya no existía. Se recomienda liberar cursores que ya no usará (si no, expiran solos tras ~10 minutos).",
+  "enum": [
+    "delete"
+  ],
+  "type": "string"
+}

Previous value: -"Selector de sección: id de un elemento (con o sin '#', ej. 'installation') o texto exacto de un encabezado (ej. 'Instalación'). Devuelve sólo esa sección hasta el siguiente encabezado del mismo nivel o superior. Mucho más barato que paginar con offset_chars a ciegas en documentos largos. Si la sección no existe, la respuesta lo indica y devuelve el documento completo."New value: +"Selector de sección: id de un elemento (con o sin '#', ej. 'installation') o texto exacto de un encabezado (ej. 'Instalación'). Devuelve sólo esa sección hasta el siguiente encabezado del mismo nivel o superior. Mucho más barato que paginar con offset_chars a ciegas en documentos largos. Máximo 300 caracteres; el exceso se recorta. Si la sección no existe, la respuesta lo indica y devuelve el documento completo."

Added value: +300

Previous value: -"Alcance del contenido HTML. 'full' (por defecto) devuelve toda la página, incluida navegación, encabezados y pie. Use 'main' para quedarse sólo con el contenido principal (contenedor article/main, sin menús, barras laterales, banners de cookies ni pies): ahorra típicamente 60-80% de tokens en artículos, documentación y blogs. Combine content='main' con format='markdown' para la lectura óptima de artículos largos."New value: +"Alcance del contenido HTML. 'main' (por defecto) devuelve sólo el contenido principal (contenedor article/main, sin menús, barras laterales, banners de cookies ni pies): ahorra típicamente 60-80% de tokens en artículos, documentación y blogs. Use 'full' cuando necesite la estructura completa de la página. Combine content='main' con format='markdown' para la lectura óptima de artículos largos. Los valores inválidos se degradan a 'main'."

Previous value: -"Formato del contenido para páginas HTML. 'text' (por defecto) devuelve texto estructurado ligero y gasta menos tokens. 'markdown' reproduce la estructura exacta de la página: enlaces con URL, énfasis, bloques de código, listas anidadas, imágenes y tablas. 'html' devuelve el marcado HTML saneado (sin scripts/estilos) para inspeccionar el DOM: formularios, atributos data-*, estructura de componentes. Para preguntas puntuales (versiones, precios, datos sueltos) deje el formato por defecto."New value: +"Formato del contenido para páginas HTML. 'text' (por defecto) devuelve texto estructurado ligero y gasta menos tokens. 'markdown' reproduce la estructura exacta de la página: enlaces con URL, énfasis, bloques de código, listas anidadas, imágenes y tablas. 'html' devuelve el marcado HTML saneado (sin scripts/estilos) para inspeccionar el DOM: formularios, atributos data-*, estructura de componentes. Para preguntas puntuales (versiones, precios, datos sueltos) deje el formato por defecto. Los valores inválidos se degradan a 'text'."

Previous value: -"Si es true, agrega al final un inventario ENLACES DE LA PÁGINA con todos los enlaces únicos (etiqueta y URL, hasta 200). Úselo para decidir a dónde navegar después (crawling informado), descargar documentos enlazados o pasar URLs de imágenes a una herramienta de análisis de media que acepte URLs http(s) directas."New value: +"Por defecto es true: agrega al final un inventario ENLACES DE LA PÁGINA con los enlaces únicos (etiqueta y URL, hasta 200). Úselo para decidir a dónde navegar después (crawling informado), descargar documentos enlazados o pasar URLs de imágenes a una herramienta de análisis de media que acepte URLs http(s) directas. Envíe false para omitir el inventario y ahorrar tokens. También se acepta el alias camelCase `includeLinks`."

Previous value: -"Si es true, agrega al final un bloque METADATOS DE LA PÁGINA con idioma, autor, fecha de publicación e imagen destacada (og:image). Útil para citar fuentes o decidir frescura del contenido antes de gastar tokens en el fetch completo."New value: +"Por defecto es false. Si es true, agrega al final un bloque METADATOS DE LA PÁGINA con idioma, autor, fecha de publicación e imagen destacada (og:image). Útil para citar fuentes o decidir frescura del contenido antes de gastar tokens en el fetch completo. También se acepta el alias camelCase `includeMetadata`."

Previous value: -"Alias legado de limit_chars. Límite de lectura por cursor en caracteres (por defecto: max_chars)."New value: +"Alias legado de limit_chars. Límite de lectura en caracteres (por defecto: max_chars; con `url` recorta localmente el contenido devuelto). Un valor 0 se ignora."

Previous value: -"Límite de lectura por cursor en caracteres (por defecto: max_chars). Prefiera este nombre actual de campo de EnriProxy sobre limit."New value: +"Límite de lectura en caracteres. Con `cursor`: límite del servidor (por defecto: max_chars). Con `url` (primera lectura): recorta localmente el contenido devuelto. Un valor 0 se ignora. Prefiera este nombre actual de campo de EnriProxy sobre limit."

Previous value: -"Alias legado de offset_chars. Offset de lectura por cursor en caracteres (por defecto: 0)."New value: +"Alias legado de offset_chars. Offset de lectura en caracteres (por defecto: 0; con `url` aplica un rango local sobre el contenido devuelto)."

Previous value: -"Offset de lectura por cursor en caracteres (por defecto: 0). Prefiera este nombre actual de campo de EnriProxy sobre offset."New value: +"Offset de lectura en caracteres (por defecto: 0). Con `cursor`: ventana del servidor sobre la captura. Con `url` (primera lectura): rango local sobre el contenido devuelto; la primera lectura amplía automáticamente su presupuesto hasta alcanzar la ventana solicitada, así que los offsets más allá de max_chars SÍ devuelven contenido. Prefiera este nombre actual de campo de EnriProxy sobre offset."

Previous value: -"Pista opcional que describe qué desea extraer (la herramienta devuelve el contenido obtenido; no genera un resumen con IA)."New value: +"Pista opcional de extracción. Cuando el documento excede max_chars y el servidor reduce la respuesta (reduced=true), la pista guía la selección de extractos del paquete devuelto; en documentos que caben en el presupuesto no cambia el contenido devuelto. Nunca se envía al sitio de destino."

Added value: +{
+  "description": "Hasta 10 rangos {offset_chars, limit_chars} leídos en una sola llamada, para leer tramos no contiguos de un documento grande. Con `cursor`: cada rango se lee del servidor en paralelo y la respuesta es un objeto agrupado {range_applied, range_count, ranges[], range_hint}. Con `url`: primero se descarga el documento; si viene truncado con cursor, cada rango se lee por cursor en paralelo; si no, los rangos se recortan localmente del contenido devuelto. Ejemplo: [{\"offset_chars\": 0, \"limit_chars\": 5000}, {\"offset_chars\": 120000, \"limit_chars\": 5000}].",
+  "items": {
+    "properties": {
+      "limit_chars": {
+        "description": "Longitud del rango en caracteres; omitido usa max_chars.",
+        "type": "integer"
+      },
+      "offset_chars": {
+        "description": "Offset inicial del rango en caracteres (>=0).",
+        "type": "integer"
+      }
+    },
+    "type": "object"
+  },
+  "maxItems": 10,
+  "minItems": 1,
+  "type": "array"
+}

Previous value: -nullNew value: +{
+  "description": "Contenido obtenido con metadatos de paginación; variantes: lectura única, borrado de cursor o rangos agrupados.",
+  "properties": {
+    "applied_max_chars": {
+      "description": "Presupuesto aplicado en el camino npm.",
+      "type": "integer"
+    },
+    "content": {
+      "description": "Contenido obtenido (lectura única).",
+      "type": "string"
+    },
+    "content_type": {
+      "description": "Tipo de contenido de la respuesta.",
+      "type": "string"
+    },
+    "cursor": {
+      "description": "Cursor de paginación, cuando existe.",
+      "type": "string"
+    },
+    "deleted": {
+      "description": "Resultado de action 'delete': si el cursor existía y se liberó.",
+      "type": "boolean"
+    },
+    "fetched_truncated": {
+      "description": "Si el fetch aguas arriba se truncó.",
+      "type": "boolean"
+    },
+    "has_more": {
+      "description": "Si existe más contenido tras este corte.",
+      "type": "boolean"
+    },
+    "limit_chars": {
+      "description": "Límite de lectura por cursor.",
+      "type": "integer"
+    },
+    "next_offset_chars": {
+      "description": "Offset exacto donde empieza la página siguiente (lecturas por cursor), cuando el servidor lo reporta.",
+      "type": "integer"
+    },
+    "offset_chars": {
+      "description": "Offset de lectura por cursor.",
+      "type": "integer"
+    },
+    "range_applied": {
+      "description": "Marca de resultado por rangos agrupados.",
+      "type": "boolean"
+    },
+    "range_count": {
+      "description": "Número de rangos devueltos.",
+      "type": "integer"
+    },
+    "range_hint": {
+      "description": "Guía de continuación para lecturas por rangos.",
+      "type": "string"
+    },
+    "ranges": {
+      "description": "Cortes por rango en orden de petición.",
+      "items": {
+        "properties": {
+          "content": {
+            "description": "Contenido del corte.",
+            "type": "string"
+          },
+          "content_type": {
+            "description": "Tipo de contenido.",
+            "type": "string"
+          },
+          "cursor": {
+            "description": "Cursor de continuación.",
+            "type": "string"
+          },
+          "error": {
+            "description": "Error en español cuando la lectura de este rango falló.",
+            "type": "string"
+          },
+          "has_more": {
+            "description": "Si hay más contenido tras el corte.",
+            "type": "boolean"
+          },
+          "index": {
+            "description": "Índice del rango (base 1).",
+            "type": "integer"
+          },
+          "limit_chars": {
+            "description": "Límite solicitado.",
+            "type": "integer"
+          },
+          "note": {
+            "description": "Nota en español cuando el offset quedó fuera del contenido devuelto.",
+            "type": "string"
+          },
+          "offset_chars": {
+            "description": "Offset solicitado.",
+            "type": "integer"
+          },
+          "status": {
+            "description": "Código HTTP de la lectura.",
+            "type": "integer"
+          },
+          "total_chars": {
+            "description": "Total capturado para el cursor.",
+            "type": "integer"
+          },
+          "truncated": {
+            "description": "Si el corte quedó truncado.",
+            "type": "boolean"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "reduced": {
+      "description": "Si el contenido se redujo a un paquete de extractos.",
+      "type": "boolean"
+    },
+    "status": {
+      "description": "Código HTTP de la lectura.",
+      "type": "integer"
+    },
+    "total_chars": {
+      "description": "Total de caracteres capturados.",
+      "type": "integer"
+    },
+    "truncated": {
+      "description": "Si el contenido quedó truncado.",
+      "type": "boolean"
+    },
+    "url": {
+      "description": "URL que se obtuvo.",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "description": "Selector de sección: id de un elemento (con o sin '#', ej. 'installation') o texto exacto de un encabezado (ej. 'Instalación'). Devuelve sólo esa sección hasta el siguiente encabezado del mismo nivel o superior. Mucho más barato que paginar con offset_chars a ciegas en documentos largos. Si la sección no existe, la respuesta lo indica y devuelve el documento completo.",
+  "type": "string"
+}

Added value: +{
+  "description": "Alcance del contenido HTML. 'full' (por defecto) devuelve toda la página, incluida navegación, encabezados y pie. Use 'main' para quedarse sólo con el contenido principal (contenedor article/main, sin menús, barras laterales, banners de cookies ni pies): ahorra típicamente 60-80% de tokens en artículos, documentación y blogs. Combine content='main' con format='markdown' para la lectura óptima de artículos largos.",
+  "enum": [
+    "main",
+    "full"
+  ],
+  "type": "string"
+}

Previous value: -"Formato del contenido para páginas HTML. 'text' (por defecto) devuelve texto estructurado ligero y gasta menos tokens. Use 'markdown' cuando necesite reproducir la estructura exacta de la página: enlaces con URL, énfasis, bloques de código, listas anidadas o imágenes. Para preguntas puntuales (versiones, precios, datos sueltos) deje el formato por defecto."New value: +"Formato del contenido para páginas HTML. 'text' (por defecto) devuelve texto estructurado ligero y gasta menos tokens. 'markdown' reproduce la estructura exacta de la página: enlaces con URL, énfasis, bloques de código, listas anidadas, imágenes y tablas. 'html' devuelve el marcado HTML saneado (sin scripts/estilos) para inspeccionar el DOM: formularios, atributos data-*, estructura de componentes. Para preguntas puntuales (versiones, precios, datos sueltos) deje el formato por defecto."

Previous value: -[
-  "text",
-  "markdown"
-]New value: +[
+  "text",
+  "markdown",
+  "html"
+]

Added value: +{
+  "description": "Si es true, agrega al final un inventario ENLACES DE LA PÁGINA con todos los enlaces únicos (etiqueta y URL, hasta 200). Úselo para decidir a dónde navegar después (crawling informado), descargar documentos enlazados o pasar URLs de imágenes a una herramienta de análisis de media que acepte URLs http(s) directas.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Si es true, agrega al final un bloque METADATOS DE LA PÁGINA con idioma, autor, fecha de publicación e imagen destacada (og:image). Útil para citar fuentes o decidir frescura del contenido antes de gastar tokens en el fetch completo.",
+  "type": "boolean"
+}

Previous value: -"Opaque cursor returned by a previous `web_fetch` call for pagination."New value: +"Cursor opaco devuelto por una llamada previa de `web_fetch` para paginación. Nunca invente este valor."

Added value: +{
+  "description": "Formato del contenido para páginas HTML. 'text' (por defecto) devuelve texto estructurado ligero y gasta menos tokens. Use 'markdown' cuando necesite reproducir la estructura exacta de la página: enlaces con URL, énfasis, bloques de código, listas anidadas o imágenes. Para preguntas puntuales (versiones, precios, datos sueltos) deje el formato por defecto.",
+  "enum": [
+    "text",
+    "markdown"
+  ],
+  "type": "string"
+}

Previous value: -"Legacy alias for limit_chars. Cursor read limit in characters (default: max_chars)."New value: +"Alias legado de limit_chars. Límite de lectura por cursor en caracteres (por defecto: max_chars)."

Previous value: -"Cursor read limit in characters (default: max_chars). Prefer this current EnriProxy field name over limit."New value: +"Límite de lectura por cursor en caracteres (por defecto: max_chars). Prefiera este nombre actual de campo de EnriProxy sobre limit."

Previous value: -"Maximum content length (default: 200000)."New value: +"Longitud máxima del contenido (por defecto: 200000)."

Previous value: -"Legacy alias for offset_chars. Cursor read offset in characters (default: 0)."New value: +"Alias legado de offset_chars. Offset de lectura por cursor en caracteres (por defecto: 0)."

Previous value: -"Cursor read offset in characters (default: 0). Prefer this current EnriProxy field name over offset."New value: +"Offset de lectura por cursor en caracteres (por defecto: 0). Prefiera este nombre actual de campo de EnriProxy sobre offset."

Previous value: -"Optional hint describing what you want to extract (the tool returns fetched content; it does not generate an AI summary)."New value: +"Pista opcional que describe qué desea extraer (la herramienta devuelve el contenido obtenido; no genera un resumen con IA)."

Previous value: -"Full URL to fetch (http:// or https://)."New value: +"URL completa a obtener (http:// o https://)."

Previous value: -"Cursor read limit in characters (default: max_chars)."New value: +"Legacy alias for limit_chars. Cursor read limit in characters (default: max_chars)."

Added value: +{
+  "description": "Cursor read limit in characters (default: max_chars). Prefer this current EnriProxy field name over limit.",
+  "type": "integer"
+}

Previous value: -"Cursor read offset in characters (default: 0)."New value: +"Legacy alias for offset_chars. Cursor read offset in characters (default: 0)."

Added value: +{
+  "description": "Cursor read offset in characters (default: 0). Prefer this current EnriProxy field name over offset.",
+  "type": "integer"
+}