> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Usar la extensión del navegador

> Linkly AI Clipper: convierte cualquier página web en Markdown bien maquetado con un solo clic, y previsualízalo, cópialo, descárgalo o guárdalo directamente en tu Espacio de Linkly AI.

## Qué hace

**Linkly AI Clipper** es la extensión de navegador de Linkly AI y hace una sola cosa: **guardar páginas web como Markdown apto para agentes**.

Con un clic convierte la página actual en Markdown bien maquetado, que puedes previsualizar, copiar o descargar desde el panel lateral. No es solo «guardar una página web»: el texto, las imágenes, la traducción, los subtítulos de un vídeo e incluso tus conversaciones con una IA acaban convertidos en un archivo Markdown limpio que cualquier agente puede aprovechar sin esfuerzo.

<CardGroup cols={2}>
  <Card title="Se guarda en un formato que la IA sabe leer" icon="file-code" iconType="duotone">
    Con cabecera YAML y una estructura de secciones clara; contenidos como los de X o Weibo tienen además su propia optimización
  </Card>

  <Card title="Va directo a tu biblioteca" icon="folder-tree" iconType="duotone">
    Con la aplicación de escritorio instalada, el recorte aterriza en el Espacio de Linkly AI y se indexa junto al resto de archivos de tu ordenador
  </Card>

  <Card title="Las imágenes se vienen contigo" icon="image" iconType="duotone">
    Las imágenes del texto se descargan a la misma carpeta, así que puedes leerlo todo sin conexión
  </Card>

  <Card title="Todo ocurre en local" icon="shield-check" iconType="duotone">
    La extracción, la traducción y la generación del índice se hacen dentro de tu navegador, sin pasar por nuestros servidores
  </Card>
</CardGroup>

***

## Instalación

Se instala desde la Chrome Web Store: [**Linkly AI Clipper**](https://chromewebstore.google.com/detail/linkly-ai-clipper/akplbgdjkgkakgoemhpjpphfilipdbda).

| Requisito                             | Detalle                                                                                                                          |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **Navegador**                         | Chrome 116 o superior (lo exige la API del panel lateral)                                                                        |
| **Funciones de IA en el dispositivo** | La traducción local y el índice generado por IA necesitan un Chrome reciente (basta con que el modelo integrado esté disponible) |
| **Otros navegadores**                 | Edge, Brave y demás navegadores basados en Chromium se instalan desde la propia Chrome Web Store                                 |
| **Cuenta / pago**                     | No hace falta ninguna de las dos cosas; ver [Preguntas frecuentes](#preguntas-frecuentes)                                        |

<Warning>**Firefox no es compatible por ahora.** La extensión solo está publicada en la Chrome Web Store y no existe ninguna versión para Firefox, así que no la busques en sus complementos.</Warning>

<Note>**La interfaz de la extensión existe por ahora solo en inglés y en chino simplificado.** En un navegador configurado en español se muestra en inglés, así que los nombres de botones y ajustes que se citan en esta página aparecen **tal cual los verás en pantalla**, seguidos de su traducción entre paréntesis.</Note>

***

## Recorta tu primera página

<Steps>
  <Step title="Abre la página de un artículo">
    Vale cualquier cosa: un artículo, un tuit, una respuesta de Zhihu o la página de un vídeo de YouTube.
  </Step>

  <Step title="Pulsa el icono L de la barra de herramientas">
    Un clic en el icono de la extensión, arriba a la derecha del navegador, abre el panel lateral, que empieza solo a extraer el texto de la página actual y a convertirlo en Markdown.

    <Note>
      **No hay menú contextual ni atajo de teclado.** La única forma de abrir el panel lateral es pulsar el icono de la barra de herramientas, así que conviene anclar ahí la extensión (un clic en la chincheta dentro del menú de extensiones).
    </Note>
  </Step>

  <Step title="Revisa el resultado y cópialo o guárdalo">
    La vista por defecto es **Preview** (Vista previa), la vista de lectura ya maquetada. En la barra de herramientas tienes además **Edit source** (Editar la fuente: pasar al Markdown en bruto y editarlo directamente), **Metadata** (Metadatos: URL de origen, sitio, autor y fecha de publicación), **Table of contents** (Índice) y cuatro tamaños de letra.

    Cuando estés conforme, pulsa **Copy** (Copiar) para llevarte todo el Markdown al portapapeles y pegárselo directamente a tu asistente de IA, o **Download** (Descargar) para guardarlo como archivo — dónde acaba exactamente se explica en [la sección siguiente](#dos-destinos-para-tus-recortes).
  </Step>
</Steps>

<Note>**Al cambiar de pestaña, la conversión se rehace sola.** Si no quieres ese comportamiento, desactiva **Settings → Auto-refresh** (Ajustes → Actualización automática); a partir de entonces tendrás que pulsar **Re-convert** (Reconvertir) a mano.</Note>

<Warning>**No se puede recortar solo una selección.** La extensión extrae siempre el texto completo de la página: no existe la opción de recortar únicamente el fragmento seleccionado. Si quieres quedarte con una parte, cambia a **Edit source** en el panel lateral y borra tú el resto.</Warning>

***

## Dos destinos para tus recortes

Es el punto que más confusión genera: **un mismo botón Download sigue dos caminos completamente distintos según si la aplicación de escritorio está en marcha o no.**

| Situación                                             | Dónde se guarda                              | Qué pasa después                                                 |
| ----------------------------------------------------- | -------------------------------------------- | ---------------------------------------------------------------- |
| **La aplicación de escritorio está en marcha**        | `~/LinklyAI/Clips/<título del recorte>/`     | Se indexa automáticamente y podrás buscarlo y recuperarlo con IA |
| **La aplicación no está en marcha, o falla el envío** | `~/Downloads/Linkly/` (carpeta de descargas) | Es un archivo corriente: **no** se indexa                        |

Cada recorte es **una carpeta**, con el archivo `.md` y sus imágenes dentro.

### Cómo saber qué camino ha seguido

Al guardar aparece un aviso en la parte inferior del panel lateral, y solo puede ser uno de estos cuatro:

| Aviso                                                            | Qué significa                                                |
| ---------------------------------------------------------------- | ------------------------------------------------------------ |
| **Saved to Linkly Space**                                        | Ha entrado en tu biblioteca                                  |
| **Client offline — saved to browser downloads**                  | No se ha detectado la aplicación de escritorio: plan B       |
| **Couldn't save to Linkly desktop — saved to browser downloads** | Sí se ha detectado, pero ha fallado la transferencia: plan B |
| **Saved locally**                                                | Has desactivado **Save to Linkly Space** en los ajustes      |

También puedes comprobarlo por tu cuenta: abre **Settings → Download settings** (Ajustes → Ajustes de descarga) y mira la línea **Save to Linkly Space** (Guardar en el Espacio de Linkly AI). Si pone **Online · v...** con el número de versión de la aplicación de escritorio, hay conexión; si pone **App not detected** (Aplicación no detectada), no la hay. Al lado tienes dos botones, **Re-check** (Volver a comprobar) y **Launch desktop app** (Abrir la aplicación de escritorio).

<Warning>**El plan B es definitivo y no se corrige solo.** Los recortes que acaban en la carpeta de descargas del navegador no se quedan esperando en ninguna cola ni vuelven solos a la biblioteca cuando arranques la aplicación de escritorio. Para que se indexen, tendrás que moverlos tú al Espacio de Linkly AI, o bien añadir la propia carpeta de descargas a las [carpetas indexadas](/docs/es/indexing).</Warning>

<Note>El plan B **no pierde contenido**: el Markdown y las imágenes están todos ahí, solo que en otro sitio. El nombre de la subcarpeta dentro de la carpeta de descargas del navegador (`Linkly` por defecto) se cambia en **Settings → Download settings → Default folder** (Carpeta predeterminada). La carpeta `Clips/` del lado de la biblioteca, en cambio, **no se puede configurar por separado**: va siempre allá donde esté tu Espacio de Linkly AI.</Note>

Cuando el guardado sale bien, en la barra de herramientas aparece el botón **Open save location** (Abrir la ubicación de guardado): con un clic se abre la carpeta de ese recorte en el gestor de archivos del sistema (en versiones antiguas de la aplicación de escritorio ese botón no aparece).

<Warning>La aplicación de escritorio **no tiene** ninguna pantalla para explorar los recortes. Para ver qué has ido recortando, abre la carpeta `~/LinklyAI/Clips` en el gestor de archivos. Eso sí, el contenido de los recortes se puede buscar perfectamente desde el [lanzador](/docs/es/use-launcher) y desde el [Chat](/docs/es/use-chatbot).</Warning>

***

## Cómo es un archivo de recorte

Al principio del Markdown hay un bloque de YAML front matter que declara compatibilidad con Open Knowledge Format v0.1: son metadatos pensados para los agentes de IA, para que sepan de un vistazo qué es este archivo y de dónde viene.

```yaml theme={null}
---
type: "Video Transcript"
title: "What is Linkly AI?"
resource: "https://www.youtube.com/watch?v=HnGMkWaWvVo"
timestamp: 2026-07-28T12:11:16Z
site: "YouTube"
author: "Linkly AI"
---
```

Campos completos: `type` (tipo de contenido), `title`, `description` (resumen; se omite cuando repite el título), `resource` (URL de origen), `tags`, `timestamp` (momento del recorte), `site`, `author`, `published` (fecha de publicación del original) y `lang`. Solo se escriben los campos que tienen valor; los demás simplemente no aparecen.

El valor de `type` lo decide el sitio de origen; los más habituales son `Web Article`, `WeChat Article`, `X Thread`, `Zhihu Article`, `Video Transcript` y `AI Conversation`.

<Tip>Si no quieres el front matter, desactiva **Settings → Export content → Include frontmatter** (Ajustes → Contenido exportado → Incluir el front matter) y lo que se exporte será solo el texto.</Tip>

### Imágenes

Las imágenes del texto **se descargan a tu equipo** y las referencias del Markdown se reescriben como rutas locales relativas: no se conserva ningún enlace remoto, así que las imágenes se siguen viendo sin conexión.

* Las imágenes y el `.md` **conviven en la misma carpeta**, sin subcarpeta `image/`
* El nombre sigue la regla `<título>-visual-N.<extensión>`
* Cada recorte admite 200 archivos como máximo
* Si solo quieres el texto, desactiva **Settings → Export content → Include images** (Incluir las imágenes): no se descarga ninguna imagen y las referencias también desaparecen del Markdown

***

## Optimizaciones para sitios concretos

La extracción genérica (quitar la navegación, los anuncios y los bloques de recomendaciones) es suficiente para la mayoría de las páginas, pero algunos sitios tienen una estructura peculiar y les hemos hecho una adaptación específica:

| Sitio                           | Qué se adapta                                                     |
| ------------------------------- | ----------------------------------------------------------------- |
| **ChatGPT / Claude**            | Exportar la conversación entera, o una respuesta suelta           |
| **X (Twitter)**                 | Hilos completos, con tratamiento aparte para los artículos largos |
| **YouTube / Bilibili**          | Los subtítulos se convierten en Markdown con marcas de tiempo     |
| **Cuentas oficiales de WeChat** | Texto, autor y fecha de publicación                               |
| **Zhihu**                       | Respuestas y artículos de columna                                 |
| **Documentos de Feishu / Lark** | Se leen de la estructura de datos del documento, no del DOM       |
| **Xiaohongshu**                 | Texto de la nota y carrusel de imágenes (sin los avatares)        |
| **Weibo**                       | Publicación suelta con sus imágenes                               |
| **V2EX**                        | Texto del hilo                                                    |

Los bloques de código se detectan y se etiquetan solos con su lenguaje. El resto de sitios pasa por la extracción genérica.

***

## Otras funciones

### Traducción local

**Translate** (Traducir), en la barra de herramientas del panel lateral, traduce el Markdown actual al inglés, chino simplificado, chino tradicional, japonés o coreano, y permite volver al original cuando quieras.

Usa el **modelo de traducción integrado en Chrome**: no hay que configurar ninguna clave API y el contenido no sale de este ordenador. La primera vez que uses un par de idiomas se descarga el modelo y el panel lateral muestra el progreso. Requiere un Chrome reciente.

### Como modo de lectura

La vista previa del panel lateral es de por sí un lector limpio: maqueta sola, cuatro tamaños de letra, modo oscuro siguiendo al del sistema y la posibilidad de leer el original y la traducción a la vez. No hace falta que guardes nada: puedes usarlo simplemente como un lector sin anuncios.

### Índice generado por IA

Hay páginas que no tienen una jerarquía de encabezados en condiciones (por ejemplo, las que son un único bloque de párrafos), y entonces el índice del panel lateral aparece vacío. En esos casos puedes pulsar **Generate AI outline** (Generar un índice con IA): el modelo integrado de Chrome, que se ejecuta en tu propio equipo, extrae los títulos de cada sección y genera un índice navegable.

Al copiar y al descargar, esos títulos generados por IA se incluyen por defecto; si prefieres que la exportación sea idéntica al original, desactiva **Settings → Export content → Include AI-generated article headings** (Incluir los títulos de artículo generados por IA). También necesita un Chrome reciente y solo funciona en Chrome / Edge de escritorio.

### Exportar una respuesta suelta de IA

En las páginas de conversación de **ChatGPT** y **Claude**, la extensión inyecta un botón de descarga junto a cada respuesta de la IA: no hace falta recortar la página entera, cada respuesta se guarda como Markdown con un clic.

La conversación completa también se puede recortar (pulsando el icono de la barra de herramientas, como siempre) y entonces el campo `type` será `AI Conversation`.

***

## Junto a la aplicación de escritorio

### Requisitos de versión

Para que los recortes entren directamente en el Espacio de Linkly AI hace falta una **versión razonablemente reciente de la aplicación de escritorio**: las antiguas no tienen la interfaz que recibe los recortes, la extensión las trata como si no estuvieran en marcha y el recorte acaba en la carpeta de descargas del navegador. Basta con dejar activadas las actualizaciones automáticas; no hace falta comparar números de versión a mano.

### Cómo se comunican

Entre la extensión y la aplicación de escritorio solo hay **HTTP de loopback local** (`127.0.0.1`): **no pasa nada por la nube**. Del lado de la aplicación hay dos comprobaciones de acceso: solo se admiten conexiones directas desde la propia máquina, y el origen de la extensión tiene que estar en la lista blanca, así que ningún otro programa ni ninguna página web puede conectarse.

<Note>El puerto no está garantizado: por defecto se escucha en 60606 y, si está ocupado, se pasa al siguiente. La extensión solo sondea los 10 puertos que van del 60606 al 60615, así que si otros programas los ocupasen todos, la aplicación de escritorio se daría por «no arrancada» aunque esté funcionando, y el recorte iría a la carpeta de descargas del navegador.</Note>

### Cuánto tarda un recorte en poder buscarse

Los recortes que entran en la biblioteca se indexan solos, pero **no son buscables al instante**: la vigilancia de archivos tiene un retardo (debounce) y la indexación va por cola, así que lo normal son entre unos segundos y unas decenas de segundos. Si buscas nada más recortar es posible que no aparezca; espera un poco y vuelve a intentarlo.

El mecanismo de indexación por capas y las vías de diagnóstico están en [Ajustes de indexación](/docs/es/indexing).

***

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Hace falta iniciar sesión? ¿Hay que pagar?">
    **Ni lo uno ni lo otro.** Extraer, traducir, copiar, descargar y guardar en la biblioteca: ninguna función depende de tener sesión iniciada.

    En el panel lateral sí existe una entrada **Sign in with Linkly AI** (Iniciar sesión con Linkly AI), pero hoy por hoy solo sirve para mostrar tus datos en el botón de cuenta: iniciar sesión o no da exactamente igual de cara a las funciones.
  </Accordion>

  <Accordion title="¿Es obligatorio instalar la aplicación de escritorio? ¿Qué pasa con los recortes si no está abierta?">
    No es obligatorio. Extraer el texto, traducir, copiar y descargar no dependen de la aplicación de escritorio, así que la extensión se puede usar por completo por su cuenta. La ventaja de tenerla instalada es que los recortes entran directamente en la biblioteca y se indexan junto al resto de archivos del ordenador, de modo que cualquier agente de IA puede encontrarlos después — muy recomendable usarlas juntas.

    Cuando la aplicación de escritorio no está en marcha, el recorte cae automáticamente en la carpeta de descargas del navegador, `~/Downloads/Linkly/`, y **no se pierde nada**: el panel lateral avisa claramente con **Client offline — saved to browser downloads**. Pero esos archivos **no** volverán solos a la biblioteca cuando arranques la aplicación; si los quieres allí, tendrás que moverlos tú al Espacio de Linkly AI.
  </Accordion>

  <Accordion title="No encuentro lo que he recortado">
    Búscalo en este orden:

    1. **La biblioteca**: `~/LinklyAI/Clips/<título del recorte>/`, el destino por defecto cuando la aplicación de escritorio está en marcha
    2. **La carpeta de descargas del navegador**: `~/Downloads/Linkly/`, el destino de reserva cuando no lo está

    La aplicación de escritorio **no tiene** ninguna pantalla para explorar los recortes: solo se ven desde el gestor de archivos. ¿No sabes qué camino siguió? Fíjate en lo que decía el aviso al guardar: **Saved to Linkly Space** o **saved to browser downloads**.
  </Accordion>

  <Accordion title="Recorto y busco enseguida, y no aparece">
    Es normal. Un recorte que entra en la biblioteca tarda entre unos segundos y unas decenas de segundos en terminar de indexarse: la vigilancia de archivos tiene un retardo y las tareas de indexación van por cola. Espera un poco y vuelve a buscar.

    Si pasa mucho rato y sigue sin aparecer, mira en **Ajustes → Índice** si el estado de la indexación se ha quedado atascado; las vías de diagnóstico están en [Ajustes de indexación](/docs/es/indexing).
  </Accordion>

  <Accordion title="¿Es compatible con Firefox?">No. La extensión solo está publicada en la Chrome Web Store. Edge, Brave y demás navegadores basados en Chromium pueden instalarla directamente desde ahí; para Firefox no hay ninguna versión disponible.</Accordion>

  <Accordion title="¿Hay atajos de teclado o menú contextual?">
    Ninguna de las dos cosas. La extensión no declara ningún atajo de teclado ni registra entradas en el menú contextual: la única forma de abrir el panel lateral es pulsar su icono en la barra de herramientas.

    La única excepción son las páginas de ChatGPT y Claude, donde se inyecta un botón de descarga junto a cada respuesta de la IA.
  </Accordion>

  <Accordion title="¿Lo que recorto se sube a vuestros servidores?">
    No. La extracción del texto, la traducción y la generación del índice **ocurren enteramente dentro de tu navegador**.

    Al guardar solo hay dos destinos posibles: el Espacio de Linkly AI de tu propio equipo, o la carpeta de descargas del navegador. Y la comunicación con la aplicación de escritorio va por loopback local (`127.0.0.1`), sin pasar por ningún servicio de red.
  </Accordion>

  <Accordion title="¿Por qué pide permiso para leer los datos de todos los sitios web?">
    Porque puedes querer recortar en cualquier sitio, y la extensión necesita poder ejecutar el script de extracción en la página que tengas delante. Solo lee el contenido de la pestaña activa **cuando tú lo pides**, y nunca escanea en segundo plano las páginas que visitas.
  </Accordion>
</AccordionGroup>

***

## Lecturas adicionales

* [Ajustes de indexación](/docs/es/indexing) — cómo se indexa un recorte una vez ha entrado en la biblioteca
* [Uso del lanzador de búsqueda](/docs/es/use-launcher) — la vía más rápida para encontrar lo que has recortado
* [Usar bibliotecas](/docs/es/use-libraries) — meter los recortes en una biblioteca concreta para que la IA busque por ámbito
* [Inicio rápido](/docs/es/quickstart) — instalación y configuración inicial de la aplicación de escritorio
* [Espacio de Linkly AI](/docs/es/linkly-space) — la carpeta donde aterrizan los recortes; se puede cambiar de sitio
* [Chatear con la IA](/docs/es/use-chatbot) — que la IA lea directamente las páginas que has recortado
