Adoteca

Buscar pets para adoção

Busca em TODO o catálogo de cães e gatos para adoção no Brasil, por filtros como cidade, espécie, porte e idade, ou pelo nome do pet. É a busca padrão de quem quer adotar. Inclui pets já adotados: leia `status` e só ofereça os 'available'. Mostre o `adoption_url` e nunca invente pets.

Ver ficha completa do pet

Ficha completa de um pet: saúde, cuidados, convivência e como falar com a ONG. Aceita o código curto do link ou o id devolvido pela busca de pets. Leia `status` antes de oferecer, e o `status` de cada `health_conditions` antes de falar da saúde dele.

Ver pets parecidos

Pets parecidos com UM pet específico, mesma espécie e mesma cidade — não é a busca geral do catálogo. Use quando o pet desejado já não estiver disponível. Pode vir vazia: use searchPets, nunca invente pets. Mostre o `adoption_url`. `total` é o tamanho desta lista; não há página 2.

Buscar ONGs e protetores na cidade

Use quando perguntarem QUAIS ONGs ou protetores existem em uma cidade. Lista quem tem pets no catálogo ali, com o link de cada um. Anúncios podem ser antigos: não afirme que a ONG está ativa. Não é registro completo, e NÃO diz se alguma pode acolher — nunca afirme que tem vaga.

Ver ficha da ONG ou protetor

Ficha de uma ONG ou protetor: cidades atendidas, contatos, site e página de doação. Aceita o código curto do link ou o @ do Instagram, devolvidos pela busca de ONGs. Para doações, mostre `donation_url` ou `profile_url` — nunca peça nem repasse chave PIX.

Encontrar a cidade no catálogo

Converte o nome de uma cidade (com ou sem acento, com erro de grafia) no slug oficial do catálogo. Use antes das outras buscas quando a pessoa citar uma cidade. Se `ambiguous` for true, escolha pelo contexto ou pergunte; nunca chute. Para os números da cidade, use as estatísticas.

Ver números do catálogo na cidade

Números do catálogo em UMA cidade já resolvida: quantos pets, por espécie, porte e idade, entradas em 24h, adoções, quantas ONGs e as raças mais comuns. Use para 'quantos pets tem em X?'. Não devolve pets, não resolve o nome da cidade e não diz QUAIS são as ONGs — para isso, use a busca de ONGs.

Listar raças com pets

Raças com pets no catálogo hoje, mais comuns primeiro, com o slug para enviar em `breed`. Use antes de filtrar por raça e quando perguntarem quais raças existem. A maioria do catálogo é SRD (sem raça definida): ofereça SRD em vez de dizer que não há pets.

Consultar guias da Adoteca

Guias da Adoteca sobre adoção, saúde e cuidados especiais (FIV, FeLV, leishmaniose, pet surdo, custos) e ajuda sobre como o site funciona. Use para dúvidas que não são busca de pets. Responda com base no `summary`, mostre o `url` e, se a lista vier vazia, diga que não temos guia sobre isso.

Montar link do catálogo

Monta o link do catálogo com os filtros pedidos e confirma que existem pets neles. Use quando a pessoa quiser ver a lista no site. Se `url` vier null, não há link: leia `note` e ofereça tirar um filtro. Nunca escreva um link de catálogo à mão.