Mapa de Palabras Clave y Expansión

¿Qué hace Mapa de Palabras Clave y Expansión?

Paso 1 de 5. Produce el mapa de palabras clave que leen todas las habilidades posteriores, por lo que no es necesario repetir nada.

Antes de empezar

Requerido: el conector DataForSEO. Sin él no hay volúmenes de búsqueda reales y esta habilidad estaría adivinando, que es peor que inútil porque las suposiciones parecen datos.

Verifica si existe una herramienta DataForSEO. Si no la hay, detente y di:

Esta habilidad necesita datos de búsqueda reales. Conecta DataForSEO primero: Personalizar → Conectores → Añadir conector personalizado → https://mcp.dataforseo.com/mcp → Conectar → aprobar. Tarda aproximadamente un minuto, luego ejecuta esto de nuevo.

También lee site-brief.md del proyecto. Toma SEARCH_COUNTRY, SEARCH_LANGUAGE, el área de servicio, la lista de servicios y los competidores del mismo. Si falta, dilo y ofrece ejecutar site-brief-builder primero. Puedes continuar sin él, pero debes preguntar explícitamente por el país y el idioma y advertir que los volúmenes solo son correctos para los valores indicados.

Entrada

Una palabra clave semilla, o un tipo de negocio más ubicación, o simplemente un tema. Si el usuario no proporciona nada, propón tres semillas de la lista de servicios del resumen.

Proceso

Paso 1: Expandir

Usa el conector DataForSEO. Los endpoints que necesitas, por ruta de API:

• dataforseo_labs/google/keyword_ideas, la expansión principal
• dataforseo_labs/google/related_keywords, vecinos semánticos
• keywords_data/google_ads/search_volume, volumen, CPC, competencia
• ai_optimization/ai_keyword_data/keyword_data, volumen de búsqueda AI, es decir, con qué frecuencia la gente introduce esto en un LLM en lugar de un buscador
• serp/google/organic, quién aparece actualmente (opcional pero mejora el informe)

Los nombres de las herramientas en el conector se asignan a estas rutas. Elige la herramienta correcta por su descripción en lugar de asumir un nombre exacto.

Siempre pasa la ubicación y el idioma del resumen. Nunca uses por defecto Estados Unidos porque sea conveniente.

Paso 2: Filtrar y agrupar

Descarta: palabras clave con volumen cero y volumen AI cero, errores ortográficos evidentes y términos de marca pertenecientes a competidores.

Agrupa lo que queda en grupos temáticos. Etiqueta cada palabra clave con una intención:

• informational, quiere entender ("qué es", "cómo funciona")
• commercial, comparando antes de comprar ("mejor", "vs", "reseña")
• transactional, listo para actuar ("cerca de mí", "reservar", "comprar", "precio")
• navigational, buscando una marca específica

Luego asigna a cada palabra clave un rol:

• primary, exactamente una. El tema de la etiqueta H1.
• secondary, merece su propia etiqueta H2.
• support, úsala de forma natural en el cuerpo del texto.
• skip, tema correcto pero intención incorrecta para esta página. Mantenla visible para que el usuario pueda ver que fue considerada y rechazada, no pasada por alto.

Elige la primaria por coincidencia de intención, no solo por volumen. Una palabra clave informacional de 2400/mes es la primaria incorrecta para una página de servicio, y elegirla es el error más común en la investigación de palabras clave.

Paso 3: Preguntas de expansión

Obtén las consultas de seguimiento en las que los motores AI expanden este tema:

• ai_optimization/llm_mentions para las consultas de expansión vinculadas al tema
• el bloque "People Also Ask" del endpoint SERP
• dataforseo_labs/google/related_keywords resultados en forma de pregunta

Conserva aquellas a las que una sola página pueda responder genuinamente. Cada una se convierte en una etiqueta H2 con una respuesta de dos oraciones justo debajo. Descarta cualquier cosa que pertenezca a otra página y dilo.

Salida

Escribe dos archivos.

01-keyword-map.csv, columnas exactas: cluster,keyword,intent,role,search_volume,ai_search_volume,competition,cpc Ordena por rol (primary, secondary, support, skip) y luego volumen descendente. Este es el archivo que lee seo-content-writer, por lo que los nombres de las columnas importan.

01-keyword-map.html, rellena templates/keyword-map.html.template.

Construye un data.json y renderiza:

python3 scripts/render.py templates/keyword-map.html.template data.json 01-keyword-map.html

Estructura de data.json:

{
  "tokens": { "SUBJECT": "...", "KW_TOTAL": 42, "...": "..." },
  "rows": {
    "KEYWORD_ROW": [{ "ROW_CLUSTER": "...", "ROW_KEYWORD": "...", "...": "..." }],
    "FANOUT_ROW": [{ "ROW_QUESTION": "...", "ROW_QUESTION_NOTE": "..." }],
    "SERP_ROW": [{ "ROW_POSITION": 1, "ROW_DOMAIN": "...", "...": "..." }]
  }
}

Notas sobre los tokens:

• ROW_INTENT_CLASS debe ser uno de info, comm, trans, nav.
• Si omitiste la comprobación SERP, establece SERP_TABLE_DISPLAY a none y SERP_EMPTY_DISPLAY a block. En caso contrario, block y none.
• DATA_WINDOW es la ventana de volumen, normalmente "media de 12 meses".
• DATA_NOTES debe indicar la ubicación y el idioma utilizados. Así es como el usuario detecta una ejecución en el mercado incorrecto.

No cambies el estilo de la plantilla. No añadas fuentes, colores ni gráficos.

Reglas de honestidad

• Nunca escribas un volumen que no hayas obtenido de la API. Si una palabra clave no devolvió volumen, muestra "sin datos", no 0 ni una estimación.
• El volumen de búsqueda AI es más nuevo y más limitado que el volumen de Google. Cuando falte, indícalo como faltante en lugar de implicar demanda cero.
• Si el recuento total de palabras clave es pequeño porque el nicho es pequeño, dilo. Un mapa corto y honesto es mejor que uno inflado.

Transferencia

Termina informando al usuario:

Siguiente: ejecuta seo-content-writer. Lee 01-keyword-map.csv por sí solo, por lo que no necesitarás repetir la palabra clave. Te hará tres preguntas, y solo tú puedes responder una de ellas.