Adoteca — Adoção de Pets no Brasil

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, indicados em `status`; cada pet traz o `adoption_url` da ficha.

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 de um pet já listado. Traz o `status` do pet e o resultado de cada item de `health_conditions`.

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. Só traz pets disponíveis, cada um com o `adoption_url`, e pode vir vazia. `total` é o tamanho desta lista; não há página 2.

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. Vem só de anúncios, que podem ser antigos: não é registro completo e não indica se a ONG está ativa nem se tem vaga para acolher.

Ficha de uma ONG ou protetor: cidades atendidas, contatos, site e página de doação (`donation_url`). Aceita o código curto do link ou o @ do Instagram da ONG. Não traz chave PIX.

Converte o nome de uma cidade (com ou sem acento, com erro de grafia) no slug oficial do catálogo, com a UF. Use quando a pessoa citar uma cidade. `ambiguous` vem true quando o nome existe em mais de um estado. Não traz os números da 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 lista QUAIS são as ONGs.

Raças com pets no catálogo hoje, mais comuns primeiro, com o slug aceito no filtro `breed`. Use quando perguntarem quais raças existem ou antes de filtrar por raça. A maioria do catálogo é SRD (sem raça definida).

Serviços públicos para animais numa cidade, conferidos à mão e com data: hospital veterinário público ou de universidade, zoonoses, castração, bem-estar animal da prefeitura e canais de denúncia. Filtra por necessidade. A cobertura é parcial, cidade a cidade, e a resposta pode vir vazia.

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. Cada guia traz `summary` e `url`; lista vazia significa que não há guia sobre o tema.

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. Sem pets nesses filtros, `url` vem null e `note` explica.