---
id: 0014
title: Extension de navegador "Add to graph"
status: pending
priority: high
created: 2026-05-01
depends_on: [0012]
---

## Objetivo

Extension Firefox/Chrome que añade items al grafo desde el navegador con
un click. Cubre el flujo Maltego "estoy leyendo algo en web -> nodo en
mi grafo" sin abandonar el navegador.

## Casos

- Click derecho sobre seleccion de texto -> "Add to graph" (manda texto
  via `/ingest/text`).
- Click derecho sobre link -> "Add link" (crea entidad URL + metadata
  del href, opcionalmente trigger fetch).
- Boton de toolbar -> "Add this page" (URL + titulo + meta description +
  texto principal extraido con Readability).
- Modo "select & relate": dos selecciones consecutivas -> crea relacion
  entre las entidades resultantes.

## Alcance

- WebExtension API (compatible Firefox/Chrome, Manifest v3).
- Settings: URL del endpoint (default `http://localhost:7878`), token,
  proyecto destino.
- Preview popup tras extraccion: muestra entities propuestas, el usuario
  acepta o edita antes de commit (reusa `?commit=false` de 0012).
- Atajo configurable (ej. `Ctrl+Shift+G`) para "add page".

## Decisiones

- Sin auth OAuth — token local compartido es suficiente para localhost.
- Empaquetar en `apps/graph_explorer/extension/` o como sub-repo propio
  bajo `dataforge/graph_explorer_extension`.
- Si `graph_explorer` no esta corriendo: la extension muestra error
  claro y guarda la accion en cola para reintentar.

## Definicion de hecho

- Selecciono un parrafo en una pagina, click derecho -> Add, en menos de
  2 s veo los nodos en `graph_explorer`.
- Funciona en Firefox y Chrome con la misma build.
- Reintento automatico de la cola cuando vuelve a haber endpoint vivo.
