IA & GEO

GEO Prompt Deriver

GEO Prompt Deriver es una herramienta de la SEO Suite de Antropus que convierte keywords SEO tradicionales en prompts AI realistas — preguntas naturales y conversacionales que un usuario haría a motores de IA generativa como Claude, ChatGPT, Gemini o Perplexity.

La SEO clásica identifica qué palabras clave busca la audiencia en Google. GEO pregunta: ¿qué le preguntaría esa misma audiencia a una IA? GEO Prompt Deriver automatiza esa traducción, generando variaciones naturales de prompts que conservan la intención de búsqueda pero reflejando cómo interactuaría un usuario con un chatbot.

---

Qué es y para qué sirve

GEO Prompt Deriver responde a estas preguntas:

• ¿Cómo puedo convertir mis keywords SEO en preguntas para IA sin que suene a máquina?
• ¿Debo hacer manualmente un prompt para cada keyword, o puedo automatizarlo?
• ¿Cómo garantizo que los prompts que creo reflejen diferentes intenciones (comparación, recomendación, decisión…)?
• ¿Cómo envío los prompts generados directamente a Prompt Tracker para empezar a medir?

El resultado es un conjunto de prompts variados, agrupados por intent, listos para inyectar en un baseline GEO. Sin necesidad de escribirlos a mano. Sin riesgo de sesgo por intención.

---

Cómo funciona, paso a paso

1. Suministras keywords: con un proyecto seleccionado, lista de 1–60 keywords SEO, y, si quieres, el sector como contexto.
2. Configuras la generación: cuántos prompts por keyword (1, 2 o 3) y qué tipos de intents deseas (recomendación, comparación, alternativa, decisión, informacional, transaccional).
3. Motor: siempre ChatGPT (OpenAI). No se elige: aquí el motor solo redacta las preguntas, y ChatGPT las da cortas y directas.
4. Antropus genera los prompts: envía un prompt técnico a ChatGPT con instrucciones GEO, reglas de variación y el sector como contexto. Las preguntas salen solo de las keywords: nunca llevan tu marca ni la de tus competidores, porque en el Prompt Tracker inflarían tu visibilidad (la IA te nombra si se lo pides). El modelo devuelve un JSON con cada prompt derivado.
5. Validación y limpieza: solo se descartan los prompts que llegan sin texto o sin keyword; un intent no reconocido pasa a informacional, el rationale se acota y cada prompt recibe un ID único.
6. Visualización de resultados: tabla interactiva con filtrado por intent, barra de distribución por intent, y botones para copiar, exportar (Excel o CSV) o enviar directo a Prompt Tracker.
7. Persistencia: el run se guarda en historial para reutilizar configuración o resultados en cualquier momento.

La generación corre dentro de la propia petición, sin trabajo en segundo plano. Mientras dura, la barra superior indica «Generando N prompts…» y la pantalla muestra el esqueleto de los resultados: unos 8 segundos para 10 prompts y poco más de un minuto para el máximo de 180. El resultado aparece en cuanto termina.

---

Qué necesitas antes de empezar

Sin proyecto o sin keywords, el formulario se bloquea. Todo lo demás es opcional.

---

Las dos formas de trabajar con GEO Prompt Deriver

1. Generar prompts nuevos (/seo/geo-deriver)

El flujo principal. Pega tus keywords, configura intents y contexto, y Antropus genera los prompts automáticamente repartidos en categorías para que la cobertura sea equilibrada (no sesgada a una sola intención).

2. Importar un run guardado (/seo/geo-deriver/history)

Si ya generaste prompts antes, verás un historial de todos los runs pasados. Clic en cualquiera para reabrirlo: recupera sus inputs (keywords, sector, intents), sus resultados y los créditos y el motor con que se hizo. Desde ahí puedes re-ejecutar con la misma configuración o variaciones.

---

Intents: los 6 tipos de prompts

Cada prompt generado lleva un intent — la intención detrás de la pregunta. GEO Prompt Deriver entiende estos seis tipos:

Al generar, eliges cuáles de estos 6 types deseas. El modelo varía automáticamente los prompts entre intents para que no todos sean recomendación pura, por ejemplo. Las preguntas no nombran marcas, empresas ni productos, salvo los que vengan en la propia keyword.

---

Cómo se generan los prompts

El servidor envía instrucciones técnicas a ChatGPT con estos elementos:

Instrucciones globales:

• Eres experto en GEO (Generative Engine Optimization)
• Cada prompt debe sonar como pregunta natural, no como keyword
• No añadas detalles que no estén en la keyword ni en el sector (ubicación, tamaño de empresa, presupuesto, situación personal)
• Varía el tipo de intent según lo que el usuario solicite
• No nombres marcas, empresas ni productos que no estén en la propia keyword
• Idioma: español de España (informal natural)

Contexto inyectado:

• Sector (si existe)
• Ni tu marca ni tus competidores: no se le pasan al modelo
• Lista numerada de las keywords con deduplicación hecha
• Definiciones de cada intent permitido
• Restricción: solo usar los intents solicitados
• Expectativa de salida: N prompts (keywords × promptsPerKeyword)
• Formato esperado: JSON puro, un objeto {"prompts": [...]} cuya lista lleva objetos {sourceKeyword, promptText, intent, rationale}

Restricciones técnicas:

• Límite de respuesta: 14.000 tokens máximo
• Salida pedida en modo JSON
• No consulta datos externos: es puro procesamiento

---

Configuración: opciones de generación

Prompts por keyword:

• 1: un solo prompt por keyword. Rápido, mínima salida (N×1 total).
• 2: dos prompts por keyword. Balance (default). (N×2 total).
• 3: tres prompts por keyword. Máxima variedad y cobertura. (N×3 total).

Selección de intents:

• Por defecto: todos los 6 types están seleccionados.
• Puedes deseleccionar cualquiera. Mínimo 1 debe estar activo (el formulario lo valida).
• Si solo seleccionas "recommendation", todos los prompts generados serán de ese type (menos variedad, pero enfoque claro).

Motor: siempre ChatGPT (OpenAI), en todos los planes con acceso. No se elige.

• Free/Lite: no tienen acceso a GEO Prompt Deriver (requiere seo_full).

---

Motores de IA y cómo funciona la generación

Motor: ChatGPT (OpenAI). Las derivaciones antiguas del Historial pueden venir de Claude, Gemini o Perplexity, cuando se podía elegir; conservan el motor con el que se hicieron.

Contexto y datos que Antropus usa:

• Tuyos: keywords y sector (el sector, hasta 200 caracteres).
• Instrucciones: las reglas GEO codificadas en el system prompt.

Lo que NO hace:

• No consulta Google, Bing ni ningún motor de búsqueda.
• No mide visibilidad (eso es Prompt Tracker).
• No analiza intent histórico.
• No valida si los prompts son "buenos" — solo los genera según reglas.

---

Cómo se calculan las métricas y se interpreta el resultado

GEO Prompt Deriver NO produce métricas de rendimiento (no mide cómo se posicionan los prompts en motores IA). Es una herramienta de generación, no de medición. Lo que calcula es simple:

1. totalKeywords: número de keywords únicas después de deduplicación.
   • Fórmula: |{keywords deduplicados}|
2. totalPrompts: cuántos prompts se generaron realmente.
   • Fórmula: prompts válidos devueltos por el LLM (los que traen texto y keyword)
   • Nota: si el modelo devolvió menos de las pedidas, se usan las que devolvió y la pantalla lo avisa.
3. byIntent: distribución de prompts por cada uno de los 6 intents.
   • Fórmula: Σ count(p.intent == X) para cada intent X
4. generatedAt: timestamp ISO 8601 del momento de generación.

No hay fórmulas complejas ni ponderaciones. El resultado es una radiografía cuantitativa de qué se generó y cómo se distribuyó entre tipos.

---

Cómo leer el informe / los resultados

El resultado de GEO Prompt Deriver se organiza así:

Sección 1: KPIs (números grandes)

• Prompts generados: total generado.
• Keywords procesadas: número de keywords únicas.
• Intents generados: cuántos de los 6 intents tienen al menos un prompt.
• Créditos consumidos: lo cobrado por ese run.
• Modelo usado: el motor que redactó las preguntas (ChatGPT; en derivaciones antiguas puede ser otro).

Sección 2: Distribución por intent

• Barra horizontal segmentada con el peso de cada intent.
• Debajo, un listado con el número y el porcentaje de cada intent.
• Cada segmento lleva el color de su intent, el mismo que en la tabla.

Sección 3: Controles de filtrado

• Botón "Todos" + uno por cada intent con count.
• Al hacer clic en un intent, la tabla abajo se filtra mostrando solo prompts de ese type.
• Buscador de prompt o keyword y, si hay varias, selector de keyword origen.

Sección 4: Tabla de prompts

• Columnas: Keyword origen | Intent (badge coloreado) | Prompt AI | Contexto (el rationale del modelo, en gris) | Acción (copiar).
• Cada row es un prompt. Clic en el botón copiar → al portapapeles.
• Si filtras por intent, solo ves prompts de ese tipo.

Sección 5: Controles de acción

• Editar entrada: reabre el formulario con las keywords y la configuración del run.
• Nueva derivación: deja el formulario como al entrar para empezar de cero.
• Copiar todos: copia todos los prompts al portapapeles, uno por línea, aunque tengas un filtro activo.
• Exportar: menú con Excel (.xlsx) o CSV (columnas keyword | intent | prompt | rationale).
• Reanalizar: vuelve a generar con la misma entrada; es un run nuevo y se cobra.
• Enviar a Prompt Tracker: sin diálogo de confirmación, te lleva al Prompt Tracker del proyecto con los prompts preparados para importar (ver «Integración con Prompt Tracker»).

Sección 6: Metadata

• Footer con fecha de generación, motor, créditos y "N prompts".

---

Cuánto suele tardar

Tiempo real (medido con ChatGPT, 30-sep-2026):

• 5 keywords × 2 (10 prompts): unos 8 segundos.
• 40 keywords × 2 (80 prompts): unos 28 segundos.
• 60 keywords × 2 (120 prompts): unos 45 segundos.
• 60 keywords × 3 (180 prompts, el máximo): unos 70 segundos.
• Límite del servidor: 180 segundos.

---

Cuánto consume (créditos)

El coste en créditos de GEO Prompt Deriver se cobra por los tokens que realmente consume la generación, con una base fija por la instrucción: más prompts, más tokens. Una derivación que devuelve 0 prompts también cobra los tokens que gastó.

Estimación mostrada en la UI antes de lanzar: El formulario calcula un coste estimado que se actualiza en tiempo real mientras escribes.

Coste real cobrado (ChatGPT, 30-sep-2026):

• 5 keywords × 2 prompts/kw = 10 prompts → 0,2 créditos.
• 40 keywords × 2 prompts/kw = 80 prompts → 1,2 créditos.
• 60 keywords × 3 prompts/kw = 180 prompts → 2,8 créditos.

La estimación del formulario queda un poco por encima del cobro real, para no anunciar nunca menos de lo que se cobra.

Gate de capacidad:

• Mínimo de créditos requerido para ejecutar un run.
• Si tu workspace no tiene créditos suficientes, el servidor rechaza la solicitud.
• Estimación visible: el formulario muestra el coste estimado en créditos en tiempo real mientras escribes; se actualiza si cambias número de keywords o prompts/kw.

---

Disponibilidad y límites por plan

Acceso a la herramienta:

• Free: ❌ NO incluido
• Lite: ❌ NO incluido
• Starter: ✅ SÍ (categoría seo_full)
• Pro: ✅ SÍ
• Agency: ✅ SÍ
• Enterprise: ✅ SÍ

GEO Prompt Deriver requiere la categoría seo_full, que está disponible desde Starter en adelante.

Interpretación:

• Starter: 200 prompts/mes = aprox. 10–20 runs (según config).
• Pro: 700 prompts/mes = aprox. 35–70 runs.
• Agency/Enterprise: prácticamente sin límites. Retención ilimitada de histórico.

Gates de cuota (server-side):

• Cada run suma al contador de promptsPerDay, promptsPerWeek y promptsPerMonth del workspace.
• Si el run resultaría en exceder CUALQUIERA de estas tres cuotas, se rechaza aunque tengas cuota mensual.
• Ej: plan Starter (20/día, 60/semana, 200/mes). Ya has lanzado 20 prompts hoy → siguiente run se bloquea incluso si tiene 30 días de mes disponibles.

---

Errores y casos frecuentes

Errores de validación (HTTP 400):

Errores de capacidad (HTTP 403):

Errores de cuota (HTTP 429):

Errores de autorización (HTTP 401):

Errores del servidor (HTTP 500):

Edge cases manejados automáticamente:

1. Duplicados exactos de keywords:

   • Se desduplicarán automáticamente.
   • El resumen del formulario («N kw × M = X prompts») ya cuenta solo las keywords únicas.

2. Intent inválido del motor:

   • Si el modelo devuelve intent no reconocido, se convierte automáticamente a "informational".
   • No genera error; solo fallback silencioso.

3. Prompts faltantes:

   • Si esperabas 120 prompts (60 kw × 2) pero el motor devolvió 80 válidos, se retornan los 80.
   • Métrica totalPrompts refleja lo real, no lo esperado.

4. Contexto vacío:

   • El sector es opcional; marca y competidores no se piden.
   • Si no hay sector, la instrucción va sin él y las preguntas salen solo de las keywords.

5. Rationale muy largo:

   • Si el motor devuelve rationale >120 caracteres, se corta automáticamente.
   • No genera error; solo truncamiento silencioso.

6. Charset/encoding:

   • Soporta UTF-8 completamente (español de España con acentos, signos especiales).
   • Prompts con caracteres especiales se preservan.

7. Sin proyecto seleccionado:

   • La pantalla no deja generar: el botón queda desactivado y pide «Selecciona un proyecto en la barra lateral».
   • Así cada run queda en el historial de su proyecto.

8. Motor fijo:

   • No hay selector de motor: siempre es ChatGPT (OpenAI).
   • Las derivaciones antiguas del Historial pueden mostrar Claude, Gemini o Perplexity, de cuando se podía elegir.

9. Re-carga desde historial:

   • Clic en un run guardado → /seo/geo-deriver?load=<id>.
   • Se recargan los inputs originales (keywords, sector, prompts por keyword e intents), sus resultados y los créditos y el motor guardados.
   • Si un run muy antiguo no guardó créditos o motor, se muestra «No disponible».
   • Al re-ejecutar, siempre genera con ChatGPT, aunque el run original fuera de otro motor.

10. Deduplicación de prompts generados:

    • El servidor NO deduplica prompts entre keywords.
    • Si dos keywords generan prompts idénticos (caso raro), ambos aparecen en resultado.
    • El UI tampoco filtra; muestra todos.

---

Integración con Prompt Tracker

Desde los resultados de GEO Prompt Deriver, el botón "Enviar a Prompt Tracker" te lleva directamente a crear un baseline con los prompts generados:

1. Los prompts se guardan en localStorage con clave antropus:geo_deriver_pending.
2. Te lleva al Prompt Tracker de tu proyecto. Al empezar, un aviso te ofrece «Importar N prompts».
3. Al importarlos, cada pregunta entra en su categoría de la metodología: recomendación e informacional en Descubrimiento; comparación y alternativa en Comparación; decisión y transaccional en Decisión. Puedes cambiar la categoría de cualquiera a mano.
4. Puedes revisar, editar o agregar más prompts antes de lanzar el baseline.

No hay doble coste: el baseline corre los prompts contra motores IA para medir visibilidad; GEO Prompt Deriver solo los generó.

---

Resumen técnico para clientes

Qué es: Herramienta que convierte keywords SEO en prompts naturales para IA, de unos segundos a poco más de un minuto según el tamaño.

Para quién: Equipos que hacen GEO (Generative Engine Optimization) y necesitan cobertura rápida de prompts variados.

Cuánto cuesta: Se cobra por los tokens que consume la generación (unos 0,2 créditos por 10 prompts y unos 2,8 por 180). La UI muestra una estimación en créditos mientras configuras.

Cuánto tarda: unos 8 segundos para 10 prompts y poco más de un minuto para el máximo de 180. El servidor espera hasta 180 segundos.

Plan mínimo: Starter (incluye categoría seo_full).

Cuotas típicas: 200 prompts/mes (Starter), 700 (Pro), 1.500 (Agency), ilimitado (Enterprise).

Motor de IA: ChatGPT (OpenAI), fijo en todos los planes con acceso.

Integración: Botón directo a Prompt Tracker desde resultados. Allí un aviso te ofrece «Importar N prompts» y cada pregunta entra en su categoría de la metodología.

Historial: Todos los runs se guardan (30 días Starter, 365 Pro, ilimitado Agency+).