Files
graph_explorer/issues/0014-browser-extension.md
T
egutierrez 9042110ea2 docs(issues): plan enrichers asincronos + recoleccion web (0026-0030)
Cinco issues que componen el plan:
- 0026: sistema de jobs (infra, contrato wire)
- 0027: tipo Webpage + cache de documentos
- 0028: enricher fetch_webpage (MVP end-to-end)
- 0028b: enrichers extract_domain / extract_links / extract_text_entities
- 0029: variantes CDP (Chrome headless, screenshot)
- 0030: macro "Deep enrich" + expand_domain

Tambien anade los issues previos 0012-0025 que estaban untracked.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-01 18:24:13 +02:00

1.7 KiB

id, title, status, priority, created, depends_on
id title status priority created depends_on
0014 Extension de navegador "Add to graph" pending high 2026-05-01
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.