IAPOST Groq
Generador de Post en wordpress con GroqIA
by Sergio Paredes & Claude Code · github.com/sergioparedesv/generador-iapost-with-groq · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/sergioparedesv/generador-iapost-with-groq/archive/refs/heads/main.zipIAPOST Groq — Generador de Contenido SEO para WordPress
Plugin de WordPress que genera artículos SEO completos usando la API de Groq (LLaMA 3.3 70B), integra con Yoast SEO y publica borradores en Gutenberg listos para revisar.
Desarrollado por Sergio Paredes & Claude Code
¿Qué hace?
A partir de una noticia base y un enfoque editorial, el plugin realiza dos llamadas a la API de Groq y produce:
| Campo | Descripción |
|---|---|
| Keyword SEO | 1-3 palabras clave óptimas |
| Título del post | 50-65 caracteres con keyword |
| SEO Title (Yoast) | Máx. 60 caracteres |
| Meta Description | 110-138 caracteres con CTA |
| Slug | Generado desde la keyword |
| Social Post | Para copiar a redes, con emojis y hashtags |
| OG Title/Description | Para Facebook (Yoast) |
| Twitter Title/Description | Para Twitter/X (Yoast) |
| Artículo Gutenberg | 1200-1500 palabras en bloques `` |
Todo se inserta como borrador en WordPress con los metadatos de Yoast SEO completos.
Características
- Promptbooks — 9 tipos de contenido × 9 roles periodísticos
- Tipos: Noticia, Artículo de opinión, Reportaje, Post de blog, Tutorial, Entrevista, Reseña, Cuento, Receta
- Roles: Tecnología, Política, Economía, Ciencia, Cultura, Deportes, Medio Ambiente, Internacional, Generalista
- Promptbooks personalizados — crea los tuyos desde la UI de configuración (CRUD completo)
- Editor con Vista previa Gutenberg — pestaña Código y Vista previa en tiempo real
- Reglas de legibilidad Yoast integradas en el prompt (frases cortas, transiciones, variedad)
- Densidad de keyword controlada — entre 4 y 6 apariciones, sin keyword stuffing
- Enlace externo e interno generados automáticamente en el artículo
- Yoast Social Meta — OG y Twitter title/description poblados automáticamente
- Autocompletado de etiquetas — busca entre etiquetas existentes de WordPress
- Categorías y etiquetas — asignación en el momento de publicar
- Contadores de caracteres con barra de progreso visual en meta description
- Modal Re-redactar — refina el artículo con instrucciones adicionales
- Popup de éxito con cuenta atrás de 3s que redirige al editor Gutenberg
Requisitos
| Requisito | Versión mínima |
|---|---|
| WordPress | 6.0 |
| PHP | 7.4 |
| Extensión PHP cURL | Cualquier versión |
| Yoast SEO | Recomendado (el plugin funciona sin él) |
| Groq API Key | Gratuita |
Sin dependencias externas. No requiere Composer, Node.js, npm ni ningún paso de compilación. PHP puro + jQuery (incluido en WordPress).
Instalación
Opción A — Subir ZIP
- Descarga el ZIP desde Releases
- En WordPress: Plugins → Añadir nuevo → Subir plugin
- Sube el ZIP y activa el plugin
Opción B — Manual (cPanel / FTP)
- Descarga o clona este repositorio
- Sube la carpeta
iapost-groq/a/wp-content/plugins/ - Activa el plugin desde Plugins → Plugins instalados
Opción C — WP-CLI
wp plugin install https://github.com/sergioparedesv/Generador-iapost-with-groq/archive/refs/heads/main.zip --activate
Configuración
- Ve a IAPOST Groq → Configuración → API y Modelo
- Introduce tu clave de API de Groq (obtenerla gratis aquí)
- Haz clic en Guardar y luego en Verificar conexión
- (Opcional) Configura el tipo de contenido y rol de periodista por defecto
Uso
Generar un artículo
- Ve a IAPOST Groq → Generador
- Pega la noticia base y define el enfoque editorial
- Selecciona el tipo de contenido y el rol del periodista
- Haz clic en Generar Contenido
- Revisa y edita los 10 campos generados
- Asigna categorías y etiquetas
- Haz clic en Enviar como Entrada → se crea el borrador y redirige al editor Gutenberg
Re-redactar
Si el artículo no cumple tus expectativas, haz clic en Re-redactar, escribe instrucciones específicas (ej: "Usa un tono más informal, acorta las frases") y aplica.
Gestionar Promptbooks
En Configuración → Tipos de Contenido y Configuración → Roles de Periodista puedes:
- Ver los 9 tipos/roles integrados (solo lectura)
- Crear, editar y eliminar tipos y roles personalizados
- Definir las instrucciones exactas que la IA aplicará para ese perfil
Estructura del plugin
iapost-groq/
├── iapost-groq.php ← Entrada del plugin (singleton + hooks)
├── readme.txt ← Documentación formato WordPress.org
├── README.md ← Este archivo
├── assets/
│ ├── admin.css ← Estilos del panel de administración
│ └── admin.js ← jQuery AJAX, preview Gutenberg, autocomplete
└── includes/
├── class-groq-api.php ← Wrapper cURL para la API de Groq
├── class-content-generator.php ← Orquesta las 2 llamadas a la API
├── class-post-creator.php ← wp_insert_post + metadatos Yoast
├── class-admin.php ← Menú, vistas, handlers AJAX
└── class-promptbooks.php ← Biblioteca de promptbooks (tipos × roles)
Modelos disponibles
| Modelo | Descripción |
|---|---|
llama-3.3-70b-versatile |
Recomendado — mejor calidad |
llama-3.1-8b-instant |
Más rápido, menor calidad |
mixtral-8x7b-32768 |
Ventana de contexto grande |
gemma2-9b-it |
Alternativa ligera |
Despliegue en producción (cPanel / Hosting compartido)
El plugin no tiene dependencias externas ni pasos de compilación. Para desplegarlo:
- Sube la carpeta
iapost-groq/apublic_html/wp-content/plugins/ - Activa desde el panel de WordPress
- Asegúrate de que PHP tenga activada la extensión
cURL(habitual en todos los hostings) - El servidor debe poder hacer peticiones HTTPS salientes a
api.groq.com(puerto 443)
La mayoría de hostings compartidos en cPanel permiten esto por defecto. Si el hosting tiene restricciones de
allow_url_fopeno firewall saliente, consulta con tu proveedor.
Metadatos Yoast SEO que se rellenan
| Meta key | Campo |
|---|---|
_yoast_wpseo_focuskw |
Keyword principal |
_yoast_wpseo_title |
SEO Title |
_yoast_wpseo_metadesc |
Meta Description |
_yoast_wpseo_opengraph-title |
Facebook Title |
_yoast_wpseo_opengraph-description |
Facebook Description |
_yoast_wpseo_twitter-title |
Twitter Title |
_yoast_wpseo_twitter-description |
Twitter Description |
Licencia
GPL-2.0+ — ver LICENSE
Créditos
Desarrollado por Sergio Paredes con la asistencia de Claude Code (Anthropic).
- API de IA: Groq — inferencia ultrarrápida con modelos LLaMA
- SEO: Yoast SEO
- Editor: Gutenberg / WordPress