3qs

3 Q's — Meta Campaign Analyzer

Plugin para Claude Code que diagnostica campañas de Meta (Facebook & Instagram Ads) aplicando la metodología de las 3 Q's y un sistema de benchmarks semáforo 🔴 🟡 🟢.

Instalar · Metodología · Tipos soportados · Access Token

✨ ¿Qué hace?

3 Q's conecta Claude Code con la Meta Marketing API y convierte los datos brutos de tus campañas en un diagnóstico accionable en 3 pasos:

1️⃣ ¿Qué pasó? → Resultados principales vs tu objetivo de negocio 2️⃣ ¿Por qué pasó? → Diagnóstico del embudo y calidad creativa 3️⃣ ¿Qué haremos? → Optimizaciones concretas priorizadas

No tienes que editar archivos, exportar variables ni pegar JSON. Pegas tu Access Token una vez y Claude conduce la conversación:

Access Token → Negocios → Campañas → Tipo → Análisis → [Conjuntos → Anuncios]

🚦 Sistema de benchmarks semáforo

Cada métrica se evalúa contra umbrales verde / amarillo / rojo:

Los benchmarks se adaptan automáticamente al tipo de campaña y al objetivo de negocio que declaras (ROAS, CPL o costo por conversación).

🎯 Tipos de campaña soportados

Todas las tablas incluyen además: % video 3s, tiempo promedio de reproducción, frecuencia, CPM y métricas de calidad de Meta.

🧠 Metodología 3 Q's

1️⃣ ¿Qué pasó?

Métricas principales comparadas contra tu objetivo (no benchmarks genéricos). Ejemplo:

"ROAS 2.1x vs objetivo 4x → 47% por debajo 🔴"

2️⃣ ¿Por qué pasó?

Se recorre el embudo paso por paso para encontrar el eslabón débil:

Impresiones → Clics salientes → Visitas p.d. → Ver contenido → Carrito → Checkout → Compra
                   ▲                                                      
                   └── El % más bajo revela dónde se pierde la audiencia

3️⃣ ¿Qué haremos?

Recomendaciones priorizadas por impacto, siempre aplicando las reglas del Efecto Desglose antes de pausar o escalar (nunca matar anuncios que Meta está preservando por aprendizaje).

⚡ Inicio rápido

Requisitos

• Claude Code instalado
• Python 3.7+
• Token de Meta con permisos de solo lectura: ads_read + business_management

🔌 Instalación

/plugin marketplace add felipeverce/3Qs
/plugin install 3qs@3qs

cp -r skills/3qs ~/.claude/skills/

▶️ Uso

1. Abre Claude Code con el plugin activo.
2. Escribe algo como "Analiza mis campañas de Meta del último mes".
3. Pega tu Access Token una sola vez.
4. Claude hace el resto: escribe .env, ejecuta los scripts, lee los JSON y te presenta el diagnóstico.

📁 Estructura del proyecto