iscabox

Busca equipamentos de pesca no catálogo da iscabox (varas, carretilhas, molinetes, linhas, iscas, anzóis, acessórios). Use sempre que o usuário pedir recomendação de produto, comparação ou faixa de preço. Retorna preços ao vivo.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Termos livres: marca, modelo ou tipo. Ex: \"carretilha perfil baixo\", \"shimano\"."
    },
    "category": {
      "type": "string",
      "description": "Categoria exata. Uma de: acessorios, anzois, barcos-e-caiaques, boias, carretilhas, chumbadas, iscas-artificiais, linhas, molinetes, motores, pesca-submarina, roupas, varas."
    },
    "subcategory": {
      "type": "string",
      "description": "Subcategoria exata, se souber."
    },
    "maxPriceBRL": {
      "type": "number",
      "description": "Preço máximo em reais."
    },
    "minPriceBRL": {
      "type": "number",
      "description": "Preço mínimo em reais."
    },
    "targetPriceBRL": {
      "type": "number",
      "description": "Faixa de preço em que a conversa está: o orçamento dito pelo usuário ou o preço dos itens já discutidos. Aproxima os resultados dessa faixa sem excluir nada."
    },
    "sortByPrice": {
      "type": "string",
      "description": "'asc' para o mais barato primeiro. Use quando o usuário pedir \"a mais barata\"."
    },
    "limit": {
      "type": "number",
      "description": "Quantos resultados (1-8, padrão 5)."
    }
  },
  "required": []
}

Detalhes completos de um equipamento: especificações, prós e contras, preço ao vivo. Use depois de search_equipment quando o usuário quiser saber mais sobre um produto específico.

{
  "type": "object",
  "properties": {
    "productPath": {
      "type": "string",
      "description": "O productPath exato retornado por search_equipment."
    }
  },
  "required": [
    "productPath"
  ]
}

As iscas certas para um peixe específico, com o motivo de cada uma: a lista curada da página "melhores iscas artificiais para X" da iscabox e, para peixes sem essa página, as iscas (artificiais e naturais) que o guia da espécie recomenda. Use SEMPRE que a pergunta for "que isca para <peixe>", em vez de search_equipment: o catálogo de iscas não sabe para que peixe cada isca serve. Aceita nome de família ("robalo" cobre peva e flecha). Retorna preços ao vivo.

{
  "type": "object",
  "properties": {
    "species": {
      "type": "string",
      "description": "Nome ou slug do peixe. Ex: \"robalo\", \"tucunaré\", \"tilapia\"."
    }
  },
  "required": [
    "species"
  ]
}

Busca espécies de peixes no acervo da iscabox pelo nome popular ou científico. Use quando o usuário mencionar um peixe para confirmar qual espécie é antes de responder.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Nome do peixe. Ex: \"tucunaré\", \"robalo\"."
    },
    "water": {
      "type": "string",
      "enum": [
        "doce",
        "salgada"
      ],
      "description": "Filtra por tipo de água."
    },
    "limit": {
      "type": "number",
      "description": "Quantos resultados (1-8, padrão 5)."
    }
  },
  "required": []
}

Detalhes de uma espécie: habitat, dieta, técnicas que funcionam, iscas, melhor época do ano (seasonalCalendar) e regiões onde pescar. Use antes de recomendar equipamento ou local para um peixe específico, e para "melhor época / quando pescar X".

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "O slug retornado por search_species. Ex: \"tucunare\"."
    }
  },
  "required": [
    "slug"
  ]
}

Busca locais de pesca no acervo da iscabox — rios, represas, praias, pesqueiros. Filtre por estado, espécie ou tipo de água. Use quando o usuário perguntar onde pescar. Se o usuário citar uma cidade, passe lat e lng dela: locais próximos entram na resposta mesmo quando a cidade em si não tem página. Use kind para separar pesque-pague de água livre.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Nome do local, cidade, região ou espécie."
    },
    "state": {
      "type": "string",
      "description": "Nome ou slug do estado. Ex: \"sao-paulo\", \"Mato Grosso\"."
    },
    "speciesSlug": {
      "type": "string",
      "description": "Slug de espécie (de search_species) para achar onde pescá-la."
    },
    "water": {
      "type": "string",
      "enum": [
        "freshwater",
        "saltwater",
        "estuarine",
        "brackish",
        "pelagic"
      ],
      "description": "Tipo de água. Use \"estuarine\" para estuários e \"pelagic\" para pesca em alto-mar / oceânica / mar aberto."
    },
    "lat": {
      "type": "number",
      "description": "Latitude, em graus decimais, da cidade ou ponto que o usuário citou. Preencha com o que você sabe da geografia brasileira. Ex: Marau (RS) é -28.45."
    },
    "lng": {
      "type": "number",
      "description": "Longitude do mesmo ponto. Ex: Marau (RS) é -52.20."
    },
    "kind": {
      "type": "string",
      "enum": [
        "pesqueiro",
        "natural"
      ],
      "description": "Tipo de local. \"pesqueiro\" = pesque-pague; \"natural\" = rio, represa, lagoa, praia. Passe \"natural\" quando o usuário não quer pesque-pague."
    },
    "limit": {
      "type": "number",
      "description": "Quantos resultados (1-8, padrão 5)."
    },
    "anchor": {
      "type": "string",
      "description": "Lugar citado antes na conversa, quando a mensagem atual não cita nenhum (\"quero locais na beira do lago\" depois de falar de Fortaleza): a busca fica ancorada nele."
    },
    "radiusKm": {
      "type": "number",
      "description": "Distância máxima em km quando o usuário pede para ampliar (\"até 1 hora e meia\", \"uns 100 km\"). Dentro do raio, os melhores locais vêm primeiro, não os mais perto."
    },
    "exclude": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "locationPath dos locais já mostrados, para não repeti-los."
    }
  },
  "required": []
}

Detalhes de um local de pesca: como chegar, melhores pontos, espécies, iscas e técnicas que funcionam ali.

{
  "type": "object",
  "properties": {
    "locationPath": {
      "type": "string",
      "description": "O locationPath exato retornado por search_locations."
    }
  },
  "required": [
    "locationPath"
  ]
}

Traçado de um rio que a iscabox mapeou: os municípios que ele atravessa, na ordem da nascente à foz, com o trecho em km de cada um, e os locais de pesca do acervo ao longo dele. Use quando o usuário perguntar por onde um rio passa, que cidades ficam nele, ou onde pescar ao longo de um rio.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Nome do rio como o usuário escreveu. Ex: \"rio taquari\"."
    }
  },
  "required": [
    "name"
  ]
}

Busca técnicas e nós de pesca no acervo da iscabox. Use quando o usuário perguntar como pescar, que técnica usar ou como dar um nó. Se a pergunta for sobre um peixe ("técnicas para pescar tambacu"), passe o peixe em "species": além das técnicas do acervo, vêm as técnicas que o guia daquela espécie recomenda.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Termos livres. Ex: \"arremesso\", \"nó de conexão\"."
    },
    "species": {
      "type": "string",
      "description": "Nome ou slug do peixe alvo, quando a pergunta for sobre pescar uma espécie. Ex: \"tambacu\"."
    },
    "category": {
      "type": "string",
      "description": "Categoria. Uma de: arremessos, fly-fishing, iscas-artificiais, iscas-naturais, montagens, nos, para-pesqueiros, pesca-embarcada, por-ambiente, preparacao."
    },
    "limit": {
      "type": "number",
      "description": "Quantos resultados (1-8, padrão 5)."
    }
  },
  "required": []
}

Detalhes de uma técnica: passo a passo, equipamento necessário e quando usar.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "O slug retornado por search_techniques."
    }
  },
  "required": [
    "slug"
  ]
}

Condições de pesca de um dia: tábua de marés, fase da lua, melhores janelas de horário, temperatura da água e tempo. Use quando o usuário perguntar sobre maré, lua, melhor horário para pescar, ou se o dia está bom. Hoje por padrão; passe date para amanhã, um dia da semana ou uma data, e range para a semana ou o mês inteiro. Maré só existe para portos do litoral; para água doce a ferramenta devolve a fase da lua e as janelas de horário do dia (bestWindows).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Cidade ou porto que o usuário citou. Ex: \"São Francisco do Sul\", \"Guarapari\"."
    },
    "lat": {
      "type": "number",
      "description": "Latitude em graus decimais do ponto citado, se você souber. Ex: -26.24."
    },
    "lng": {
      "type": "number",
      "description": "Longitude em graus decimais. Ex: -48.63."
    },
    "date": {
      "type": "string",
      "description": "O dia perguntado: \"hoje\", \"amanhã\", um dia da semana (\"domingo\") ou uma data (\"2026-09-13\", \"13/09\"). Omita para hoje."
    },
    "water": {
      "type": "string",
      "description": "'doce' quando o ponto é rio, lago, represa, açude ou pesqueiro: a resposta sai sem maré."
    },
    "range": {
      "type": "string",
      "enum": [
        "dia",
        "semana",
        "mes"
      ],
      "description": "Quanto tempo o usuário quer: \"dia\" (padrão), \"semana\" (7 dias) ou \"mes\" (o mês inteiro publicado). Use \"mes\" quando ele pedir \"tábua completa\", \"mês completo\", \"a tábua do mês\" ou uma programação de viagem."
    },
    "portSlug": {
      "type": "string",
      "enum": [
        "santos",
        "rio-de-janeiro",
        "angra-dos-reis",
        "cabo-frio",
        "vitoria",
        "salvador",
        "ilheus",
        "recife",
        "natal",
        "fortaleza",
        "sao-luis",
        "belem",
        "paranagua",
        "itajai",
        "florianopolis",
        "rio-grande",
        "maceio",
        "tutoia",
        "cabedelo",
        "aracaju",
        "imbituba",
        "sao-francisco-do-sul",
        "sao-sebastiao",
        "itaguai",
        "fernando-de-noronha",
        "suape",
        "salinopolis",
        "mosqueiro",
        "vila-do-conde",
        "breves",
        "luis-correia",
        "pecem",
        "madre-de-deus",
        "aratu",
        "ubu"
      ],
      "description": "Slug do porto coberto pela iscabox. Se a cidade que o usuário citou é um destes portos (ou é atendida por um deles), passe o slug direto — é mais confiável que a busca por texto."
    }
  },
  "required": []
}

Monta uma tralha completa e coerente (vara, carretilha ou molinete, linha, leader, iscas, anzóis) para uma pescaria. Use quando o usuário pedir uma montagem inteira, um kit ou "o que eu preciso para pescar X", inclusive pescaria de pesqueiro com isca natural (massa, minhoca, ração): a montagem vem com a isca natural como item fixo. Respeita o orçamento em budgetBRL. Para dúvidas sobre um produto só, use search_equipment.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Briefing em português: espécie, água, orçamento e preferências. Ex: \"tralha para tucunaré em represa até R$800, prefiro carretilha\"."
    },
    "budgetBRL": {
      "type": "number",
      "description": "Teto de gasto em reais dito pelo usuário (ex: 250). Obrigatório sempre que ele citou um valor."
    }
  },
  "required": [
    "prompt"
  ]
}