SMART CONNECTION
Blueprint · Marketplace SMC
Documento 09

Sistema de Oportunidades

Cómo los 3 founders identifican productos con alta rotación y buen margen · sin pagar APIs · sin scrape propio · sin data lake.

Versión
1.0
Fecha
2026-05-27
Autor
Cerebro + Founders
Status
🟡 Design approved · S1 pending
Tabla de contenidos

Índice

  1. 01 · Qué es el Sistema de Oportunidades03
  2. 02 · Por qué este sistema lo operamos los 3 founders04
  3. 03 · Arquitectura · 6 capas05
  4. 04 · Scoring sin LLM · 6 señales06
  5. 05 · Smart Cache · NO data lake07
  6. 06 · Cómo usa el sistema Camila08
  7. 07 · Cómo usa el sistema Javier09
  8. 08 · Cómo usa el sistema Guillermo + qué lidera10
  9. 09 · Sources conectadas (estado actual)11
  10. 10 · Roadmap 3 sprints12
  11. 11 · Restricciones que NO se violan13

01Qué es el Sistema de Oportunidades

Marketplace SMC v5 incluye una vista /dashboard/oportunidades donde los 3 founders ven una tabla de productos con alta rotación + buen margen estimado · sin gastar tokens de LLM · sin clonar catálogos completos · sin pagar APIs.

Esto reemplaza la idea original de "Helium 10 para MeLi" que chocó con el bloqueo de PolicyAgent de Mercado Libre (DPP exige USD 200K GMV/mes · imposible arrancar).

💡 La verdad incómoda

No tenemos acceso a ventas reales ni a costos reales. El "score de oportunidad" es una aproximación honesta basada en 6 señales proxy. NO es ranking real MeLi · es estimación.

02Por qué este sistema lo operamos los 3 founders

El sistema NO es una herramienta exclusiva de nadie. Los 3 founders trabajamos lo mismo · consultamos diariamente, filtramos, operamos oportunidades. La única diferencia: Guillermo lidera la mantención técnica del sistema con apoyo de Javier y un chuca de Camila.

Rol con el sistemaCamilaJavierGuillermo
Consulta la tabla de oportunidades diaria
Ajusta filtros por categoría / score
Click "Explicar" para entender un score
Opera la oportunidad (compra · publica · licita)
Propone nueva señal de scoring
Mantención técnica (código · APIs · cron · IA)apoyoapoyolidera

Rotación garantizada · sin silos: ningún founder bloquea al otro porque cada uno puede usar el sistema sin esperar a otro.

03Arquitectura · 6 capas

De abajo hacia arriba · cada capa tiene política de tokens · todas las inferiores son cero LLM.

1Sources (gratis)
SoloTodo + Mercado Público + Open Food Facts + futuro otros. Nunca guardamos el catálogo entero · solo consulta on-demand.
2Filters
Reglas duras antes del scoring: quitar libros · quitar usados · solo Chile · stock>0 · price>0.
3Scoring Engine
JS/SQL puro · combina 6 señales en 1 número 0-10 · cero tokens LLM.
4Smart Cache Supabase
Tabla mkt_opportunity_cache · máx 1.000 filas · TTL diferenciado · cron limpia diario.
5API /api/opportunities/list
SQL · cero LLM · lee cache + aplica filtros usuario + ordena score.
6UI /dashboard/oportunidades
Tabla con scores · filtros · tooltips transparencia · botón "Explicar" (única capa con LLM opt-in cacheado 24h).

04Scoring sin LLM · 6 señales

Cada producto tiene un score 0-10 calculado por combinación ponderada de 6 señales proxy (no truth · estimación).

#SeñalQué proxy mideCómoPeso
1Multistore presenceDemanda# stores con mismo SKU canónico25%
2Price spreadMargen(max−min)/min · spread >15% = oportunidad arbi25%
3Availability rateStock real% stores con is_available=true15%
4Price stabilityDemanda sostenidaBaja varianza precio en 7d (proxy no-overstock)15%
5Category premiumMargen por categoríaTabla fija (accesorios > línea blanca)10%
6MeLi presenceValidación marketplace¿Producto está en MeLi además de retail?10%

Total: 1 SQL query · cero LLM tokens.

05Smart Cache · NO data lake

El sistema NO clona los 58.611 productos de SoloTodo. Cache estricto de máx 1.000 filas. Solo entra al cache lo que algún founder consultó.

AspectoPolítica
Tablamkt_opportunity_cache
Columnassku_canonico (PK) · score · category · n_stores · price_min · price_max · top_url · last_synced · n_queries
Tamaño máximo1.000 filas (~200 KB total)
TTL Hot (n_queries >5)6h (alineado con frecuencia SoloTodo)
TTL Warm (n_queries 1-5)12h
TTL Cold (sin query 7d)DELETE automático
Cron limpiezapg_cron diario 3:00 AM · borra cold · si tabla >1000 drop lowest score
💡 Por qué resuelve "no queremos data"

No clonamos SoloTodo · cache se autolimpia · si nadie consulta más, queda vacío · costo Supabase tier free sigue activo.

06Cómo usa el sistema Camila

Camila Bianchi

Founder · uso operativo idéntico a Javier y Guillermo

Uso diario del Sistema Oportunidades · los 3 hacemos lo mismo:

  • Abre /dashboard/oportunidades · filtra por score · spread · categoría
  • Identifica SKUs candidatos · click "Explicar" en los top
  • Cruza con stock actual de bodega (¿ya tenemos? ¿cuánto?)
  • Compara price_min del sistema vs precio Nexport ofrecido
  • Opera la oportunidad · compra a Nexport · publica en MeLi · postula licitación Mercado Público · abre cuenta B2B
  • Marca "Hot 🔥" los SKUs que está empujando para que el sistema priorice
  • Propone nuevas señales de scoring si detecta gap
  • Reporta en stand-up lunes a los 3 founders

07Cómo usa el sistema Javier

Javier Bianchi

Founder · uso operativo idéntico a Camila y Guillermo

Uso diario del Sistema Oportunidades · los 3 hacemos lo mismo:

  • Abre /dashboard/oportunidades · filtra por score · spread · categoría
  • Identifica SKUs candidatos · click "Explicar" en los top
  • Cruza con stock actual de bodega (¿ya tenemos? ¿cuánto?)
  • Compara price_min del sistema vs precio Nexport ofrecido
  • Opera la oportunidad · compra a Nexport · publica en MeLi · postula licitación Mercado Público · abre cuenta B2B
  • Marca "Hot 🔥" los SKUs que está empujando para que el sistema priorice
  • Propone nuevas señales de scoring si detecta gap
  • Reporta en stand-up lunes a los 3 founders

08Cómo usa el sistema Guillermo + qué lidera

Guillermo González León

Founder · uso operativo idéntico + lidera mantención técnica

Uso diario del Sistema Oportunidades · los 3 hacemos lo mismo:

  • Abre /dashboard/oportunidades · filtra por score · spread · categoría
  • Identifica SKUs candidatos · click "Explicar" en los top
  • Cruza con stock actual de bodega (¿ya tenemos? ¿cuánto?)
  • Compara price_min del sistema vs precio Nexport ofrecido
  • Opera la oportunidad · compra a Nexport · publica en MeLi · postula licitación Mercado Público · abre cuenta B2B
  • Marca "Hot 🔥" los SKUs que está empujando para que el sistema priorice
  • Propone nuevas señales de scoring si detecta gap
  • Reporta en stand-up lunes a los 3 founders

Lo que lidera Guillermo (con apoyo de Javier y un chuca de Camila):

  • Mantiene los 6 endpoints (sources + scoring + cache + list)
  • Vigila el cron pg_cron diario · revisa logs de tokens LLM (debe estar <1% sesión)
  • Suma sources nuevas cuando hay caso de uso real (no especulativo)
  • Ajusta pesos del scoring según feedback de los 3 (no unilateral)
  • Reporta a galvarez.cl si hay cambios fiscales (UF/USD en BCentral)

09Sources conectadas · estado actual

APIEndpoint appEstadoAuthCobertura
SoloTodo/api/solotodo/test🟢 OK commit 876e5c9sin auth58.611 productos MeLi Chile · 564 stores · tech/electro
Mercado Público/api/mercadopublico/test🟡 OK commit db51105 · falta ticket envticket freeLicitaciones B2G ChileCompra
Open Food Factspendiente⚪ pendientesin auth6.440 productos alimentación Chile + EAN
BCentralpendiente⚪ pendienteuser/pass freeUF/USD/UTM/IPC oficial Chile

10Roadmap 3 sprints

SprintEntregable funcionalTokens estimados
S1 "tubería"Backend completo sin UI · SQL migration + scoring.ts + filters.ts + 2 endpoints + cron pg_cron · curl validable15-20% sesión
S2 "ducha"Página /dashboard/oportunidades con tabla básica · top 50 default · 3 founders pueden abrir8-10% sesión
S3 "grifos finos"Filtros client-side + botón "Explicar" con Groq cacheado 24h + tooltips transparencia10-12% sesión

Cada sprint deja algo funcional · no hace falta esperar S3 para validar S1 con Camila y Javier.

11Restricciones que NO se violan

  1. NO data lake masivo · cache ligero · no clonamos catálogo SoloTodo
  2. NO LLM en cada vista · scoring es math puro · LLM solo on-click "Explicar"
  3. NO libros (categoría excluida explícitamente)
  4. Transparente para el usuario final · los 3 founders ven scores · no la cocina
  5. Sin scraping propio · solo APIs públicas con permisos
  6. Sin pagar APIs · stack 100% gratis
💡 ADR canónico

El detalle técnico completo (SQL schemas · TypeScript signatures · cómputo del score paso a paso) vive en ~/smartconnection-marketplace/docs/adr/0001-opportunities-architecture.md del repo. Este documento del banco es la vista founders · no la vista dev.