Maru Coach (marucoach.com)

Tu coach profesional. La home (/) reúne las secciones de Maru:

• Coach de postulación (/postulacion): CV a medida y respuestas para el formulario de una vacante concreta (detalle abajo).
• Creá tu CV perfecto (/cv): sin vacante. Subís tu experiencia, contás a qué rol, nivel, industria y país apuntás y qué querés destacar (texto o audio), respondés 3-5 preguntas y recibís un CV general optimizado para ATS y recruiters.
• Carta de presentación (/carta): link o job description (o carta espontánea a una empresa), lo que querés contar por texto o audio, tu experiencia y ajustes de tono, largo, idioma y destinatario. Devuelve una carta editable con reescritura por párrafo, otra versión con otro tono o largo, asunto de email, mensaje corto para LinkedIn y descarga en PDF o Word.
• Video de presentación (/video): para una búsqueda o una presentación general. Maru escribe el guion (30, 60 o 90 s) en bloques editables con tiempos y tips; lo leés en un teleprompter mientras grabás con la cámara del navegador y recibís feedback de cada toma: ritmo (palabras por minuto, muletillas), fidelidad al guion y encuadre, luz, fondo y mirada a partir de 3 fotogramas. El video no sale del navegador.
• Entrená para tu entrevista (/entrevista): simulación con formato de videollamada. Elegís tipo (RR. HH., con tu futuro líder, técnica), dificultad, cantidad de preguntas e idioma; la entrevistadora habla en voz alta, respondés por voz o por escrito y, si tu respuesta queda corta, repregunta. Al final, un informe con puntaje, fortalezas, qué mejorar y una respuesta más fuerte (STAR) para cada pregunta.
• Encontrá tu trabajo perfecto (/match): cargás o reutilizás tu CV, confirmás lo que Maru entendió, contás qué querés hacer y en qué condiciones, y recibís un ranking de búsquedas reales donde podés trabajar desde Argentina, con motivos, brechas y lo que falta confirmar. Desde cada búsqueda podés guardarla, descartarla o preparar la postulación con el coach. Detalle técnico, fuentes y políticas en docs/match.md.
• Búsquedas (/busquedas): buscador sin CV sobre el mismo inventario real, con filtros por puesto o empresa, modalidad, área, seniority y "desde Argentina" (por defecto). Cada resultado lleva al aviso original con su atribución.
• Seguimiento (/seguimiento): tablero de postulaciones (Guardadas · Postuladas · Entrevista · Oferta · Descartadas; en celular, pestañas). Las tarjetas se crean solas cuando guardás una búsqueda, tocás "Postularme" o armás un CV, una carta, una práctica de entrevista o un video para una búsqueda, con chips de lo que armaste. Notas, cambio de estado, carga manual y atajos para adaptar el CV o practicar la entrevista. Vive sólo en el navegador (src/lib/tracker.ts, clave maru:tracker:v1).
• Extensión de Chrome (extension/): cargás tu CV una vez y, en cualquier formulario de postulación, un clic (o Alt+Shift+M) completa los campos. Vos revisás y enviás (detalle abajo).

Diseño del CV: 24 templates en 5 estilos (clásicos, modernos, ejecutivos, minimalistas y creativos), todos de una columna y ATS-friendly, con color, tipografía, espaciado, tamaño de letra y orden de secciones personalizables. La carta usa los mismos templates para armar un set con el CV. El perfil que Maru lee queda guardado sólo en el navegador para reutilizarlo en las otras secciones.

Lo que falta y cómo seguir: docs/PENDIENTES.md.

Próxima etapa de avisos (16/10/2026): definiciones estratégicas, plan para la próxima IA y muestras/evidencia. Prioridad: profesionales generalistas, luego tecnología/remoto. Sin abono de Fantastic; se autorizó aprovechar su trial gratuito para investigar. El producto debe continuar funcionando cuando termine.

Coach de postulación

Para quienes encontraron una vacante que les encanta:

1. Pegan el link de la vacante (o el texto, si el portal no deja leerla).
2. Cuentan por qué les entusiasma (por qué es una buena vacante, por qué son buen fit, qué les encanta del desafío y la empresa), escribiendo o dictando por voz.
3. Suben su CV en PDF, su LinkedIn (PDF exportado o link público) o pegan su experiencia.
4. Responden 3–5 preguntas cortas que la IA arma para cubrir lo que falta.
5. Reciben:
   • un CV personalizado y optimizado para esa búsqueda, pensado para ATS (una columna, títulos estándar, palabras clave exactas) y para recruiters y hiring managers (titular alineado, logros con impacto), listo para descargar en PDF o copiar como texto;
   • una recomendación lista para copiar en cada campo del formulario de postulación, con el porqué y un tip.

Maru nunca inventa experiencia: si un dato ayudaría pero falta, deja un marcador [completar] resaltado.

Extensión de Chrome: completar postulaciones

1. En el popup, la persona sube su CV (PDF o Word, o pega el texto). Maru lo lee con /api/profile y lo guarda sólo en ese navegador (chrome.storage.local), junto con el archivo para adjuntarlo.
2. Opcional: carga "datos que suelen pedir y no están en el CV" (pretensión salarial, disponibilidad, permiso de trabajo, cómo se enteró). Sin eso, Maru no los completa.
3. En el formulario, toca Completar esta postulación. La extensión lee los campos de la página y de sus iframes (Greenhouse embebido en la web de la empresa), los manda a /api/autofill y completa cada uno.
4. Verde: copiado del CV. Amarillo: Maru lo redactó o dedujo (respuestas abiertas, años de experiencia) u obligatorio que falta completar. Nunca envía el formulario.

Qué completa: textos, email, teléfono, links, números, fechas, <select>, radios, casillas, listas con buscador (role="combobox", como las de react-select en el Greenhouse nuevo) y adjunta el CV en el campo de archivo. Funciona con formularios hechos en React (setter nativo + eventos, teclas completas keydown + keyup) y salta campos ya completos y honeypots anti-bots. Por diseño no completa datos demográficos (género, etnia, discapacidad, veterano…) ni aceptaciones legales (arbitraje, términos, privacidad, consentimientos): lo pide el prompt y además lo bloquea el servidor (isSensitive en src/lib/autofill.ts), aunque la IA conteste igual.

Probado contra formularios reales (sin enviar nada): Lever (Palantir, Spotify) y Greenhouse (Anthropic, 23 campos incluidas 11 listas con buscador).

Todavía no: buscadores que cargan opciones recién al tipear (ciudades), las listas de Workday (son botones, no inputs), formularios de varios pasos que cambian de página y editores de texto enriquecido. Quedan sin tocar y, si son obligatorios, marcados en amarillo.

Descargarla: la página /extension de Maru tiene el botón de descarga y los 4 pasos; el .zip se arma al compilar desde extension/ (src/lib/extensionZip.ts), así que siempre coincide con main.

Instalarla desde el repo: abrí chrome://extensions, activá Modo de desarrollador → Cargar descomprimida → elegí la carpeta extension/. Por defecto usa la Maru publicada (https://maru-grego7.vercel.app); para desarrollo local, poné http://localhost:3000 en Avanzado dentro del popup.

Cómo está hecha: JavaScript plano con Manifest V3, sin build. background.js coordina (inyecta content.js en todos los frames, llama a la API y reparte las respuestas por frame), content.js lee y completa los campos, popup.* es la interfaz. El servidor valida todo lo que devuelve la IA (src/lib/autofill.ts): sólo opciones que existen en la página, fechas y números con formato válido, largo máximo y nada de campos inventados.

Tests: tests/extension.test.ts levanta Chromium con la extensión cargada contra páginas de prueba (HTML común, iframe de otro origen, un formulario React controlado y listas de react-select como las de Greenhouse) y las rutas reales; sólo simula la respuesta de la IA.

Video de la home

El video del hero (public/video/maru-intro.mp4 y .webm, 33,6 s, 1280 × 720) sigue la estructura del video de jobright.ai, en español y con funciones reales de Maru: estrategia de búsqueda, muro de búsquedas reales del inventario, matches, Maru explicando el match, la extensión completando un formulario, "Postularme" y el CV a medida.

Es una escena animada (video/intro.html) donde todo depende del tiempo, así cada cuadro sale exacto. Para regenerarlo (por ejemplo, con números nuevos del inventario):

FFMPEG_PATH=/ruta/a/ffmpeg node scripts/render-intro-video.mjs            # video + póster
node scripts/render-intro-video.mjs --preview=2.9,13.45,25.35 --out=/tmp  # capturas sueltas

Necesita Chromium (CHROME_PATH) y un ffmpeg con libx264 y libvpx (por ejemplo, el de pip install imageio-ffmpeg). Abrir video/intro.html en el navegador lo reproduce en vivo.

Stack

• Next.js 15 (App Router) + TypeScript + Tailwind CSS v4
• Claude API (@anthropic-ai/sdk) con salidas estructuradas validadas por Zod. Modelo por defecto: claude-opus-5-5, con fallback automático del servidor si el modelo declina un pedido
• cheerio para leer la vacante: datos schema.org/JobPosting + campos de formulario (Greenhouse, Lever, Workable…)
• Dictado con la Web Speech API del navegador (Chrome, Edge, Safari)

Cómo correrlo

cp .env.example .env.local   # y poné tu ANTHROPIC_API_KEY
npm install
npm run dev

Abrí http://localhost:3000.

Login con Google

Cualquier persona puede ingresar desde el header de todas las páginas. Para descargar o copiar el CV y la carta, o descargar el video, es obligatorio. El único ingreso es Continuar con Google (sin contraseña; el link por email se sacó el 18/10/2026). El navegador queda recordado por 180 días y la persona sigue donde estaba.

• El login no usa la base de datos: al volver de Google se crea una sesión firmada (HMAC) en una cookie httpOnly.
• Las descargas se validan en el servidor (/api/export/pdf y /api/export/docx devuelven 401 sin sesión).

Variables: AUTH_SECRET (32+ caracteres, openssl rand -base64 48), GOOGLE_CLIENT_ID y GOOGLE_CLIENT_SECRET. Sin las de Google, el diálogo avisa que el ingreso no está disponible.

Continuar con Google

• Google se abre en una ventana aparte (/api/auth/google?popup=1), así no se pierde lo que hay en la pestaña (por ejemplo, un video grabado). Al volver, la ventana avisa por BroadcastChannel y se cierra; el diálogo retoma la descarga. Si el navegador bloquea la ventana, el ingreso pasa en la misma pestaña y vuelve a la página.
• El estado (state) va firmado con AUTH_SECRET y atado al navegador con la cookie maru_oauth; sólo se aceptan emails verificados por Google. La sesión dura 180 días.
• Configuración, en Google Cloud Console:
  1. Crear un proyecto (o usar uno). En APIs y servicios → Pantalla de consentimiento de OAuth: tipo Externo, nombre "Maru", email de soporte, logo opcional; alcances openid y email; Publicar la app (en modo prueba sólo entran los usuarios de prueba).
  2. En Credenciales → Crear credenciales → ID de cliente de OAuth: tipo Aplicación web. En URIs de redirección autorizadas: https://maru-grego7.vercel.app/api/auth/google/callback (y la del dominio propio cuando exista, más http://localhost:3000/api/auth/google/callback para desarrollo).
  3. Copiar el ID y el secreto a GOOGLE_CLIENT_ID y GOOGLE_CLIENT_SECRET en Vercel y hacer redeploy. Sin esas variables el botón no aparece.
• Los previews de Vercel tienen otra URL: Google sólo acepta las URIs cargadas, así que para probar ingresando en un preview hay que agregar su URL.

Base de datos: tu cuenta en cualquier dispositivo

Con sesión, el perfil, el match (preferencias, búsquedas guardadas y descartadas) y el seguimiento se copian a la cuenta y aparecen en cualquier dispositivo donde ingreses. Lo armado en cada herramienta (CV, carta, entrevista, video) sigue sólo en el navegador. Sin sesión, todo funciona como antes.

• La base es un Redis de Upstash que se usa por su API REST (src/lib/db.ts, sin dependencias). Cada cuenta guarda un documento por clave (maru:u:<hash del email>:perfil|match|tracker), con la fecha del servidor.
• localStorage sigue siendo la fuente de la app; src/lib/sync/client.ts sube cada cambio a los segundos y baja lo de la cuenta al ingresar, al cargar y al volver a la pestaña. Si cambiaron los dos lados, se concilian con su versión común (mergeDoc en src/lib/sync/docs.ts: el seguimiento por tarjeta, el resto el más reciente). Si en ese navegador había otra cuenta, no se mezclan.
• «Borrar mis datos» con sesión deja una marca sin datos en la cuenta, así se borra también en los demás dispositivos.
• API: GET /api/sync y PUT /api/sync {doc, data, baseVersion}, ambas con sesión. baseVersion es el updatedAt confirmado (0 si nunca se guardó). Redis compara y escribe atómicamente: una versión vieja recibe 409 y el documento actual; el cliente concilia y reintenta. X-Maru-Account impide que una subida pendiente se asigne a otra cuenta si cambia la cookie desde otra pestaña.
• Los borrados tienen prioridad frente a copias pendientes anteriores; las tarjetas y búsquedas removidas no se reintroducen al conciliar. Match y los selectores de perfil se refrescan al recibir datos y al cambiar otra pestaña.

Base actual: upstash-kv-gray-notebook, compartida con los proyectos de lab (Manuelita, Biblioteca). Por eso todas las claves de Maru empiezan con maru:; las de esos proyectos usan otros prefijos (user:, session:, biblio:…). Si más adelante se quiere separar, alcanza con conectar otra base y cambiar las variables.

Conectarla en Vercel: en el proyecto, Storage → Create Database → Upstash for Redis (plan gratis) y conectala a Production y Preview. Vercel agrega KV_REST_API_URL y KV_REST_API_TOKEN (también sirven UPSTASH_REDIS_REST_URL/_TOKEN, o los mismos nombres con prefijo). Después, Redeploy. Sin esas variables, en producción la sincronización queda apagada y en desarrollo usa una base en memoria.

Planes, protección de uso y chat

• /precios: comparación de planes, checkout por cuenta, estado y cancelación. La suscripción queda apagada por defecto (NEXT_PUBLIC_BILLING_ENABLED=false). Precio y límites son una propuesta pendiente de confirmar. Activación, credenciales, pruebas y límites: docs/COBROS.md.
• La cuenta y el plan se identifican por el email de Google. Un retorno de pago o una marca del navegador no otorgan acceso: se verifica el pago del lado del servidor.
• La protección por IP usa contadores atómicos en Redis con TTL y claves maru:rate: (IP con hash). Sin base configurada queda la alternativa en memoria. Si hay base y falla, las APIs protegidas devuelven 503 para no gastar IA sin control.
• Chat en /busquedas: consultas de carrera y avisos del inventario, enlaces validados por el servidor, consentimiento para enviar el perfil y conversación sin persistencia. Requiere la clave de IA habitual. El historial se limpia al cambiar de cuenta.
• Guía del seguimiento: /seguimiento/guia. Los resultados de Match usan AppShell. Logos locales verificados: public/companies/SOURCES.json (Simple Icons, versión fijada; sin seguimiento externo de imágenes).

Deploy

Funciona en Vercel tal cual: importá el repo y configurá ANTHROPIC_API_KEY en las variables de entorno. Las rutas /api/analyze y /api/generate declaran maxDuration = 300 porque la generación del CV puede tardar alrededor de un minuto.

Estructura

src/app/page.tsx              Home con las secciones
src/app/postulacion, cv, carta  Páginas de cada sección
src/components/Flow.tsx       Postulación: vacante → motivación → CV → preguntas → resultado
src/components/CvBuilderFlow.tsx  Creá tu CV: experiencia → objetivo → preguntas → CV
src/components/carta/         Carta: flujo, papel editable
src/components/cv/themes.ts   Los 24 templates y la personalización (color, tipografía, densidad, tamaño, orden)
src/components/CvSourceField.tsx, Questions.tsx, ui.tsx  Piezas compartidas
src/components/CvDocument.tsx CV ATS-friendly (también es lo que se imprime a PDF)
src/app/api/analyze           Lee vacante + CV + feedback → análisis y preguntas
src/app/api/generate          + respuestas → CV optimizado y respuestas del formulario
src/app/api/cv/*              Análisis y redacción del CV sin vacante
src/app/api/carta, carta/parrafo  Carta completa y reescritura de un párrafo
src/components/video/, src/app/api/video/*   Video: guion, estudio (cámara + teleprompter) y feedback
src/components/entrevista/, src/app/api/entrevista/*  Entrevista: plan, llamada (voz), turnos y informe
src/lib/tracker.ts, src/components/tracker/, src/app/seguimiento/  Seguimiento de postulaciones (localStorage + cuenta)
src/components/speech.ts      Dictado continuo, voz de la entrevistadora y métricas de ritmo
src/components/auth/, src/lib/auth.ts, src/lib/google.ts, src/app/api/auth/*  Login con Google
src/app/api/export/pdf, docx  Descargas (exigen sesión)
src/lib/db.ts, src/lib/sync/, src/app/api/sync  Base de datos y sincronización de la cuenta
src/app/api/autofill, src/lib/autofill.ts  Autocompletar formularios desde la extensión
extension/                    Extensión de Chrome (Manifest V3, sin build)
src/lib/job.ts                Scraping de la vacante y de LinkedIn
src/lib/prompts.ts            Instrucciones para Claude
src/lib/match/, src/components/match/, src/app/match/, src/app/api/match/*  Match con búsquedas (ver docs/match.md)
scripts/match-sync.ts, data/match/  Sincronización e inventario compartido de vacantes
src/lib/schemas.ts            Esquemas Zod de entrada/salida

Limitaciones conocidas

• Algunos portales (p. ej. LinkedIn Jobs con login, o sitios 100% JavaScript) no se pueden leer desde el servidor; en ese caso la app pide pegar el texto.
• Los perfiles de LinkedIn casi nunca son públicos para un servidor: lo más confiable es Más → Guardar en PDF y subir ese archivo.
• El dictado por voz depende del navegador; Firefox no lo soporta. En la entrevista se puede responder por escrito, y en el video el feedback funciona igual con los fotogramas.
• La voz de la entrevistadora es la del navegador o del sistema: cambia según el dispositivo.
• El video se graba en WebM (Chrome, Edge, Firefox) o MP4 (Safari).