cygnixlabs-cmd/cygnix-seo-skills

Agrupa una lista de palabras clave en grupos temáticos con una palabra clave pilar, la intención de búsqueda mayoritaria y el tipo de página sugerido, de modo que una página se enfoque en cada grupo.

¿Qué es cygnix-seo-skills?

Esta habilidad, llamada "Keyword clustering (lite)", transforma una lista plana de palabras clave en grupos listos para páginas. Cada cluster se asigna una palabra clave pilar (basada en el mayor volumen de búsqueda o en la más corta si no hay volumen), una intención mayoritaria y el tipo de página que suele posicionarse para esa intención. Es útil para planificar hubs de contenido a partir de exportaciones de herramientas SEO como Ahrefs, Semrush, Google Search Console o Keyword Planner. Funciona mediante clustering léxico: elimina palabras vacías, aplica stemming ligero y une cada palabra clave al cluster cuyo pilar comparte al menos un umbral de términos centrales (Jaccard). No requiere conexión a internet ni API keys, por lo que los datos nunca abandonan el equipo del usuario. La salida es una tabla Markdown con sugerencias de slugs y H1 para los tres clusters principales. El usuario debe verificar los SERPs reales antes de fusionar o dividir páginas, ya que el método no maneja sinónimos ni coalescencia de clusters que rankean para las mismas URLs.

Compatible con~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/cygnixlabs-cmd/cygnix-seo-skills/tree/HEAD/skills/keyword-clustering-lite

Documentación

Clustering de palabras clave (lite)

Convierte una lista plana de palabras clave en grupos listos para páginas. Cada grupo recibe una palabra clave pilar (la de mayor volumen, o la más corta si no hay volumen), una intención mayoritaria y el tipo de página que suele posicionarse para esa intención.

Cuándo usarlo

"Agrupa estas palabras clave", "organiza este export de palabras clave", "¿qué palabras clave pueden compartir una página?"
Planificar un hub de contenido pilar/cluster a partir de un export de herramientas SEO (Ahrefs, Semrush, GSC, Keyword Planner).

Cómo ejecutarlo

Guarda las palabras clave como un .txt (una por línea) o un CSV con una columna keyword o query. Una columna opcional volume / search volume / impressions se usa para elegir pilares y ordenar clusters.

Ejecuta:

python3 scripts/cluster.py keywords.csv            # umbral por defecto 0.5
python3 scripts/cluster.py keywords.txt --threshold 0.4   # clusters más amplios

Presenta la tabla Markdown. Para los tres clusters principales, sugiere un slug de URL y un H1 cada uno.

Cómo funciona (y sus límites)

Clustering léxico: se eliminan palabras vacías, se aplica un stemming ligero, y una palabra clave se une al cluster cuyo pilar comparte al menos threshold de sus términos centrales (Jaccard). Los núcleos de una sola palabra solo se unen a núcleos idénticos. No consulta SERPs en vivo, por lo que sinónimos ("barato" vs "económico") permanecen separados y dos clusters con las mismas URLs en ranking no se fusionan. Indica al usuario que verifique el SERP real de los clusters principales antes de fusionar o dividir páginas.

Ejemplo

Entrada: best crm for small business, small business crm software, crm for small business, crm vs erp, erp vs crm difference. Salida: cluster 1 "crm for small business" (comercial, página de comparación, 3 palabras clave); cluster 2 "crm vs erp" (comercial, 2 palabras clave).

¿Quieres más?

Habilidad de pago que construye clusters con intención etiquetada a partir de tu oferta y términos semilla, con una lista priorizada y ángulos de página: Keyword Clusters + Intent Map en Agensi
Versión alojada para listas grandes (hasta 50,000 palabras clave) con briefs de contenido: Keyword Clusterer & Brief en Apify
Servidor MCP gratuito con una herramienta cluster_keywords: cygnix-seo-mcp