Iterpec
API Reference
search
extension4 skills prontos — código real, não placeholder

Skills .md prontas para Claude / Cursor / Lovable

Cada skill abaixo é um arquivo SKILL.md completo, com frontmatter MCP e protocolo operacional escrito. Baixe, coloque em .claude/skills/, .cursor/skills/ ou .lovable/skills/ e o agente passa a executar o fluxo correto sem você prompt-engineering nada.

Como instalar (3 passos)

  1. 1. Exporte o token: export ITERPEC_MCP_TOKEN="Bearer ..."
  2. 2. Baixe o(s) SKILL.md abaixo e salve em .[claude|cursor|lovable]/skills/[nome]/SKILL.md
  3. 3. Reabra o cliente. Digite / e selecione a skill — ela já vem com MCP conectado.

Conteúdo de iterpec-search-hoteis/SKILL.md

---
name: iterpec-search-hoteis
description: Buscar disponibilidade de hotéis na API Iterpec/Cangooroo, interpretar o retorno de Search e selecionar a melhor tarifa para um caso de uso.
mcp:
  iterpec-api:
    url: https://iterpec.com/api/mcp
    headers:
      Authorization: "Bearer ${ITERPEC_MCP_TOKEN}"
---

# iterpec-search-hoteis

## Quando ativar
O usuário pediu para buscar disponibilidade, comparar tarifas ou cotar hotel
em alguma cidade/data específica.

## Protocolo
1. Confirme com o usuário (não invente):
   - CityCode ou nome da cidade (se nome, pergunte país)
   - CheckIn / CheckOut em ISO-8601
   - Ocupação por quarto (Adults, Children, ChildrenAges[])
   - Moeda desejada (default BRL)
   - Nacionalidade dos hóspedes (default BR)
2. Chame `get_endpoint({endpointId:"hotel-search"})` para pegar o schema
   atual e o exemplo curl. NÃO use payload memorizado.
3. Monte o POST conforme schema. Datas em UTC.
4. No retorno, agrupe por hotel e ordene por menor tarifa total refundable.
5. Para cada hotel destaque: nome, categoria, tarifa total, política de
   cancelamento resumida, refundable Y/N, RatePlanCode.
6. Se vier vazio: tente raio maior ou flexibilize ±1 dia e avise o usuário.

## Erros comuns
- 401: token expirado → `get_reference({topic:"retoken"})`.
- CityCode inválido: peça o nome da cidade e tente novamente com busca.
- Disponibilidade zero: NÃO afirme "esgotado", sugira flexibilizar data.

## Saída
Tabela markdown com top 5 + JSON cru do hotel escolhido para próxima etapa
(GetBookingConditions).