Última actualización: 2026-09-21 · Base URL: https://api.shalom-api.lat
La skill de IA es un archivo SKILL.md (estándar de Agent Skills) con todo lo que un agente necesita para integrar Shalom API: autenticación, los 24 endpoints con request/response reales, 5 recetas paso a paso y reglas anti-alucinación. Compatible con Claude Code, Cursor, Codex, OpenCode, VS Code y cualquier agente que soporte el formato.
Crea la carpeta de skills de tu proyecto y descarga el SKILL.md servido en producción (se actualiza junto con la documentación). El agente lo detecta al iniciar la siguiente sesión.
mkdir -p .agents/skills/shalom-api
curl -o .agents/skills/shalom-api/SKILL.md https://shalom-api.lat/skill/SKILL.mdSi tu agente usa el CLI de skills (skills.sh), instala la skill desde el repositorio público con un comando.
npx skills add ronnaldrangel/shalom-api-skillEl agente necesita una API key para operar. Expórtala como variable de entorno en tu proyecto o pídesela al agente cuando la pida.
# .env de tu proyecto
SHALOM_API_KEY=sk_tu_api_keyCon la skill instalada, pídele a tu agente algo concreto. Debería usar POST /track con tu API key y devolverte el estado de la guía.
Usa la skill shalom-api: rastrea la guía 66479331 con código 3KTH y dime en qué estado está.Es un archivo de instrucciones que tu agente carga para saber cómo usar un servicio: qué endpoints existen, cómo autenticarse y qué formato tienen las respuestas. Sin ella, el agente improvisa y suele inventar parámetros.
La de Shalom API enseña al agente a rastrear envíos, buscar agencias, cotizar y crear guías en Shalom Pro.
Cada agente tiene su carpeta de skills. La guía cubre Claude Code, Cursor, Codex, OpenCode y VS Code. Si usas otro, el archivo SKILL.md sirve igual: es texto plano.
No escribas la key dentro de la skill. El agente la lee de una variable de entorno, igual que haría tu código. Así puedes compartir la skill con tu equipo sin repartir credenciales.
Pídele al agente que consulte las agencias de Cusco por API. Si responde con datos reales y no con un ejemplo inventado, la skill está activa y con la key bien configurada.
Un archivo de instrucciones que tu agente carga para saber cómo usar un servicio, con sus endpoints, su autenticación y el formato de sus respuestas.
Claude Code, Cursor, Codex, OpenCode y VS Code. En cualquier otro sirve el mismo archivo, porque es texto plano.
En una variable de entorno, nunca dentro del archivo de la skill.
Pidiéndole al agente que consulte agencias por API. Si devuelve datos reales, está funcionando.
Puede, siempre que le des una instancia de Shalom Pro con sesión activa. Las operaciones Pro necesitan el instanceId.
Escríbenos por WhatsApp y la recibes de inmediato para probar todos estos ejemplos.
Solicitar API key