QReaper — extension de navegador
================================

Que hace
--------
Anade al menu del clic derecho la opcion "Analizar con QReaper" sobre:

  * cualquier ENLACE          -> lo manda a analizar sin abrirlo
  * cualquier IMAGEN          -> el servidor busca un QR dentro y analiza su URL
  * el TEXTO SELECCIONADO     -> saca la primera URL que encuentre
  * la PAGINA actual          -> analiza la URL de la pestana

El veredicto llega como notificacion del sistema. Al hacer clic en ella se
abre el informe completo en la web de QReaper.

El icono de la barra abre un panel donde puedes analizar la pestana actual o
pegar una URL a mano.

Dentro del correo web (Gmail y Outlook)
---------------------------------------
Cuando abres mail.google.com o outlook.com aparece un boton "🛡️ QReaper"
abajo a la derecha. Abre un correo, pulsalo, y QReaper:

  * saca todos los enlaces del cuerpo del mensaje que tienes abierto,
  * los pasa por el sandbox (hasta 15 de una tacada),
  * y te pinta el veredicto de cada uno en un panel, sin salir del correo.

Es la alternativa comoda al complemento nativo de Gmail: no hay que tocar
Apps Script, se instala como el resto de la extension (cargar carpeta). Solo
salen del navegador las URLs del correo, nunca el cuerpo del mensaje.

Este boton SOLO se inyecta en mail.google.com y outlook.* — en ninguna otra
web. La extension sigue sin leer el contenido del resto de paginas.


Instalacion en Chrome, Edge, Brave u Opera
------------------------------------------
1. Descomprime este ZIP en una carpeta que no vayas a borrar.
2. Abre  chrome://extensions  (o  edge://extensions ).
3. Activa el "Modo de desarrollador" (arriba a la derecha).
4. Pulsa "Cargar descomprimida" y elige la carpeta del paso 1.
5. Listo. Fija el icono en la barra si quieres tenerlo a mano.


Instalacion en Firefox
----------------------
1. Descomprime el ZIP.
2. Borra  manifest.json  y renombra  manifest.firefox.json  a  manifest.json
   (Firefox necesita un formato ligeramente distinto para el script de fondo).
3. Abre  about:debugging#/runtime/this-firefox
4. "Cargar complemento temporal..." y elige el  manifest.json .
   Nota: en Firefox la carga temporal se pierde al cerrar el navegador.


Apuntar a tu propio servidor
----------------------------
Por defecto usa https://qreaper.b-dev.es . Si tienes QReaper montado en local
o en el servidor de tu organizacion, cambialo en las Opciones de la extension
(clic derecho sobre el icono -> Opciones).


Privacidad y permisos
---------------------
Al instalarla, Chrome avisa de que la extension puede "leer y cambiar los
datos de todos los sitios web". Suena peor de lo que es, y conviene entender
por que lo pide:

  * La extension NO declara ningun content script. No inyecta nada en las
    paginas que visitas y no lee su contenido.
  * El permiso amplio hace falta para UNA sola cosa: poder descargar la
    imagen concreta sobre la que haces clic derecho y mandarsela al servidor
    a buscar el QR. En Manifest V3, un fetch a otro dominio desde el script
    de fondo falla sin permiso de host, y la imagen puede estar en cualquier
    dominio.

Lo unico que sale del navegador es la URL que tu eliges analizar o la imagen
sobre la que haces clic derecho. Nada mas.

Si prefieres no dar ese permiso, borra la linea "<all_urls>" de
host_permissions en manifest.json: seguira funcionando todo menos la opcion
"Analizar el QR de esta imagen".
