Instalar la skill de Laposta para tu asistente de IA
Una skill es una carpeta con instrucciones para tu asistente de IA. La skill de Laposta contiene la API completa: todos los endpoints, campos obligatorios, códigos de error y errores frecuentes. Por lo tanto, no tienes que explicar nada antes de hacer una consulta.
La skill es gratis, de código abierto y se encuentra en github.com/laposta/laposta-skill. La referencia de endpoints de la skill se genera a partir de la misma fuente que esta documentación. Si la API cambia, se ejecuta un único script y la skill vuelve a estar actualizada.
Ejemplos de instrucciones
Puedes hacer todo lo que permite la API, usando un lenguaje natural. Aquí tienes algunos ejemplos de instrucciones que puedes usar directamente:
- “¿Cuántos suscriptores activos hay en cada una de mis listas?”
- “Añade estas doce direcciones a la lista del boletín, con el nombre en el campo correspondiente.”
- “¿Quién se ha dado de baja el mes pasado?”
- “Crea una campaña a partir de este archivo html y envíame un correo de prueba.”
- “Compara la tasa de apertura y la tasa de clics de mis últimas cinco campañas.”
Si preguntas por un endpoint, la skill busca la respuesta en su propia referencia en lugar de recurrir a su memoria.
Instalar en Claude Code
El repositorio también funciona como un catálogo de plugins. Ejecuta estas dos líneas:
A continuación, elige dónde quieres guardar la skill: para tu usuario, para un proyecto o solo de forma local. Más adelante podrás descargar las actualizaciones con /plugin marketplace update laposta-skill.
Si recibes el mensaje de que /plugin no está disponible, no se debe a un fallo de la skill. Esos comandos con barra inclinada solo funcionan en Claude Code desde la terminal, no en la aplicación de escritorio ni en el navegador. En esos casos, utiliza estos comandos habituales:
Si prefieres colocar los archivos por tu cuenta, copia la carpeta laposta en tu carpeta personal de skills. Claude Code reconoce la carpeta directamente, sin necesidad de reiniciar el programa.
Instalar en claude.ai
En claude.ai no hay catálogo, pero puedes subir un archivo zip. Asegúrate de que la carpeta laposta esté en el nivel superior dentro del archivo zip; de lo contrario, no la reconocerá.
Sube este archivo desde tus ajustes, en la sección «Skills».
En claude.ai el acceso a la red debe estar activado; de lo contrario, el asistente no podrá conectarse a api.laposta.nl. Que puedas activarlo por tu cuenta dependerá de tus propios ajustes y de lo que permita el administrador. A través de la API de Claude la skill sí funciona en sí misma, pero no logra conectarse a api.laposta.nl porque ese entorno no tiene conexión a internet.
Instalar en otros asistentes
La skill utiliza únicamente los campos del estándar Agent Skills. Por lo tanto, la misma carpeta funciona en cualquier programa que siga ese estándar, como Gemini CLI, GitHub Copilot, Codex y Cursor. La ubicación de la carpeta de skills varía según el programa. Puedes consultar este dato en la documentación del propio programa.
Indicar tu clave API
La skill no te pide tu clave durante la conversación, sino que la lee de la variable de entorno LAPOSTA_API_KEY. Configúrala así:
Puedes leer cómo conseguir una clave en Crear una clave API. Crea una clave específica para esto. En Conectar un asistente de IA se explica por qué es importante hacerlo así.
Trabajar de forma segura con la skill
Las reglas de seguridad están integradas en la propia skill, por lo que no tienes que preocuparte por ellas.