CorretorX

Use esta ferramenta quando o corretor pedir para encontrar Imóveis do estoque dele por bairro, cidade, tipo, quartos, faixa de preço ou situação. Sem `status`, devolve só o que está disponível. Informe `status` pelo nome que aparece no CorretorX — Disponível, Reservado, Vendido, Alugado ou Indisponível — para alcançar o resto do inventário. A Lixeira nunca aparece, com ou sem esse filtro: não é uma situação que este campo alcança. Devolve um resumo e o identificador de cada Imóvel; o detalhe completo vem de corretorx.get_property, que recebe esse identificador. Exige login: sem sessão, a chamada devolve o desafio de autenticação. Não use para buscar Lead.

corretorx.search_properties

Use esta ferramenta quando o corretor pedir para encontrar Leads da carteira dele por nome do Contato, Etapa do Funil, temperatura, origem, período de criação ou faixa de preço — ou quando ele perguntar quais Leads pedem atenção agora (`emAtencao`). Devolve um resumo e o identificador de cada Lead; o detalhe completo vem de corretorx.get_lead, que recebe esse identificador. Exige login: sem sessão, a chamada devolve o desafio de autenticação. Não use para buscar Imóvel, nem para adivinhar um identificador — só o que esta ferramenta devolveu é válido.

corretorx.search_leads

Use esta ferramenta quando o corretor colar, no chat, o link de um imóvel do site público do CorretorX. Devolve os dados do imóvel — título, preço, quartos, banheiros, vagas, área e bairro/cidade quando existirem — junto com a URL absoluta da foto de capa. Só funciona com a página pública de um imóvel publicado: link de imóvel não publicado, sem foto cadastrada, ou de domínio que não pertence a nenhuma agência do CorretorX devolve erro. Não use para outra página do CorretorX, nem para buscar um imóvel por endereço, código ou nome — só pela URL exata da página dele.

corretorx.get_property_photo

Use esta ferramenta quando o usuário perguntar sobre o CorretorX, o sistema de gestão para corretores de imóveis autônomos — como usar uma tela, onde fica alguma coisa, como cadastrar, importar, configurar ou publicar algo, e o que o produto suporta ou não. A Ajuda é a documentação oficial do CorretorX e a única fonte publicada sobre as telas, os campos, os formatos de arquivo e os passos do produto. Busca a Ajuda por assunto e devolve título, Área e resumo dos artigos que casam; o passo a passo vem de corretorx.read_help_article, que recebe o slug listado aqui. Não achando nada, devolve o catálogo inteiro para você escolher. Não use para dúvida de mercado imobiliário, de lei ou de outro CRM, nem para ler dado do corretor: aqui só há a documentação do CorretorX.

corretorx.search_help

Use esta ferramenta quando o corretor pedir o detalhe de um Imóvel cujo identificador já veio de corretorx.search_properties: descrição, preço, características, endereço, status e comissão. Nunca traz proprietário, captação, observações da equipe ou autorização de venda — esses são Dados Internos do Imóvel, de uso só da imobiliária. Exige login: sem sessão, a chamada devolve o desafio de autenticação. Não use com identificador adivinhado.

corretorx.get_property

Use esta ferramenta quando o corretor pedir o detalhe de um Lead cujo identificador já veio de corretorx.search_leads: contato, Etapa, temperatura, origem, Histórico (as Notas, as tarefas e as movimentações do Lead, que são a Atividade dele), Notas, Imóveis Candidatos e a próxima tarefa. Nunca traz o corpo das conversas — WhatsApp e outros canais ficam de fora. Exige login: sem sessão, a chamada devolve o desafio de autenticação. Não use com identificador adivinhado; ele tem que ter vindo de corretorx.search_leads.

corretorx.get_lead

Use esta ferramenta quando corretorx.search_help devolver um artigo que serve à pergunta: devolve o artigo inteiro da Ajuda do CorretorX em Markdown, pelo slug que a busca listou. É esta chamada que traz o passo a passo — a busca só traz título, Área e resumo. A Ajuda é a documentação oficial do CorretorX e a única fonte publicada sobre as telas, os campos, os formatos de arquivo e os passos do produto. Responda com o que o artigo diz: o que ele não diz, a Ajuda não cobre. Não use com slug inventado ou adivinhado; o slug tem que ter vindo de corretorx.search_help.

corretorx.read_help_article