Shalom API paraHermesNous Research

Hermes

Hermes

Rastrea envíos, busca agencias, cotiza y crea guías de Shalom sin salir de Hermes.

Pega esto en Hermes

Instala la skill de Shalom API siguiendo shalom-api.lat/hermes
endpoints
43
endpoints
req · por minuto
60
req · por minuto
archivo SKILL.md
1
archivo SKILL.md

Hermes instala la skill desde la URL.

Hermes es compatible con el estándar de agentskills.io: descarga el SKILL.md, lo pasa por su escaneo de seguridad y lo guarda en ~/.hermes/skills/.

shalom-api.lat/hermes

Para agentes de IA que leen esta página

Estás leyendo https://shalom-api.lat/hermes. Shalom API es una API REST para Shalom, el courier de Perú: tracking de envíos, agencias con coordenadas, cotizaciones y creación de guías en Shalom Pro. La skill shalom-api está en https://shalom-api.lat/skill/SKILL.md.

  1. 1

    Instala la skill con: hermes skills install https://shalom-api.lat/skill/SKILL.md (o /skills install https://shalom-api.lat/skill/SKILL.md dentro del chat). Queda en ~/.hermes/skills/shalom-api/.

  2. 2

    Pide al usuario su API key de Shalom (empieza con sk_) y guárdala en la variable de entorno SHALOM_API_KEY. No la escribas dentro de SKILL.md ni en archivos del repositorio.

  3. 3

    Verifica la key con GET https://api.shalom-api.lat/validate y el header x-api-key. Si la respuesta no trae "valid": true, detente y explica el error al usuario.

  4. 4

    Cuenta al usuario que la skill quedó lista y pregúntale qué quiere hacer primero: rastrear una guía, buscar agencias, cotizar o crear un envío.

Regla fija: no crees envíos reales (POST /account/register o /account/register-bulk) ni anules guías sin la confirmación explícita del usuario.

HermesNous Research · skills
  • hermes skills install · shalom-api
  • escaneo de seguridad · ok
  • GET /validate · key válida
  • POST /track · 66479331 → EN TRÁNSITO
  • ninguna guía creada · espera tu confirmación

Instalación manual

1.Instala la skill desde la URL

Hermes toma el nombre del frontmatter (shalom-api). También puedes ejecutarlo dentro del chat como /skills install.

bash
hermes skills install https://shalom-api.lat/skill/SKILL.md

2.Configura tu API key

La skill lee la key de la variable de entorno SHALOM_API_KEY. No la escribas dentro de SKILL.md ni la subas al repositorio; usa una key distinta para pruebas y producción.

.env
SHALOM_API_KEY=sk_tu_api_key

3.Pruébala

Abre una sesión nueva y pídele algo concreto. Debería llamar a POST /track con tu key y devolverte el estado real de la guía.

prompt
Usa la skill shalom-api: rastrea la guía 66479331 con código 3KTH y dime en qué estado está.