Importar Propriedades por URL

Resumo

A importação por URL permite trazer uma propriedade publicada em outro site diretamente para sua conta Mapaprop, sem precisar inserir todos os dados manualmente. Há três modos de importação (URL, HTML, JSON) — todos levam ao mesmo Editor para que você revise os dados antes de salvar.

Como funciona (visão simples)

Pegas la URL  ->  Mapaprop lee la pagina  ->  Te muestra los datos  ->  Confirmas  ->  Propiedad importada

O sistema visita a página da propriedade por você, extrai as informações disponíveis (título, preço, área, fotos, etc.) e as apresenta para que você as revise antes de salvar. Você tem a palavra final: nada é salvo até você clicar em "Importar".

Os 3 modos disponíveis

Os três modos compartilham o mesmo Editor, então o fluxo de revisão e confirmação é idêntico.

Passo a Passo

Passo 1: Colar a URL e analisar

1. Vá para Propriedades > Importar > URL.
2. Cole a URL completa da propriedade no campo de texto.
   • Exemplo: https://www.zonaprop.com.ar/propiedades/casa-en-venta-en-palermo-54321.html
3. Pressione o botão Analisar.
4. O sistema vai pedir para você confirmar antes de continuar. Clique em Aceitar.
5. Aguarde. O processo pode demorar entre 30 segundos e 2 minutos.

Durante esse tempo, o sistema está visitando a página e extraindo os dados. Não feche a janela enquanto aguarda.

Se o processo demorar mais de 3 minutos, o sistema exibe uma mensagem de erro. Nesse caso você pode tentar novamente, ou usar o método HTML explicado mais adiante.

Passo 2: Revisar os dados e preencher campos faltantes

Quando o sistema termina, ele mostra os dados que conseguiu extrair da propriedade.

Nesta etapa você pode:

• Selecionar a filial à qual a propriedade será atribuída (se você for administrador).
• Alterar a localização geográfica se o sistema não a detectou corretamente.
• Preencher campos faltantes que o sistema não conseguiu ler da página original.

Campos que podem exigir correção manual

Às vezes o site de origem não tem todas as informações visíveis, ou as tem em um formato que o sistema não consegue ler automaticamente. Nesses casos aparecem campos marcados como obrigatórios para preencher antes de poder continuar.

Os campos mais comuns que exigem correção são:

Depois de preencher todos os campos, clique em Salvar Correções e depois em Confirmar Dados para passar para a próxima etapa.

Dica: o Editor também aplica as mesmas validações da página de "Criar Propriedade" manual. Se seu título ou descrição tiverem caracteres não suportados (alguns emojis incomuns), o sistema avisará ao salvar.

Passo 3: Revisar o resumo e importar

Antes de salvar a propriedade, o sistema mostra um resumo com todos os dados que serão importados:

• Título, endereço e preço
• Tipo de propriedade e operação
• Quartos, banheiros, ambientes e áreas
• Descrição
• Fotos (se foi possível obtê-las)
• Filial atribuída

Se estiver tudo certo, clique no botão Importar. O sistema vai pedir para você confirmar mais uma vez.

A importação pode demorar alguns segundos adicionais enquanto as imagens são processadas. Ao terminar, aparece uma mensagem de confirmação com o número da propriedade criada e você é redirecionado para a página da propriedade.

Nota técnica: a propriedade é criada com o mesmo fluxo de quando você a carrega manualmente (mesmas validações, mesmo registro de atividade, mesma sincronização automática com redes e portais se você tiver integrações ativas, mesma indexação em buscas). Não há diferença entre uma propriedade importada e uma criada manualmente.

Portais e sistemas suportados

O sistema usa extração especializada para os portais e plataformas de site imobiliário que já analisamos. Para sites não listados, ele tenta uma extração genérica que pode ou não funcionar, dependendo da estrutura da página.

Portais analisados

Sistemas de site de imobiliárias analisados

Estes são os sistemas que as imobiliárias usam em seus próprios sites. Se o site do seu cliente estiver publicado em algum desses sistemas, a importação deve funcionar bem:

Outros sites

Para sites não listados acima, o sistema tenta extrair dados via OpenGraph (título, descrição, imagem) e fallback genérico com IA. A qualidade do resultado varia de acordo com a estrutura do site. Se a extração não sair bem, você pode:

• Usar o método HTML para passar o código-fonte diretamente.
• Usar o modo JSON se você tiver os dados estruturados de outra fonte.
• Carregar a propriedade manualmente em "Propriedades > Criar".

Nota sobre o MercadoLibre: Algumas propriedades no MercadoLibre exigem que o visitante esteja logado para ver o detalhe completo. Nesses casos, o sistema detecta o login wall e avisa com uma mensagem clara. Solução: usar o método HTML (você faz login no navegador e cola o código-fonte).

Nota sobre o Zonaprop: O Zonaprop tem proteção Cloudflare que ocasionalmente bloqueia a leitura automática. Quando isso ocorre, o sistema mostra uma mensagem clara de "Importação Bloqueada" e você pode:

• Esperar alguns minutos e tentar novamente (o bloqueio costuma ser temporário).
• Usar o método HTML como alternativa.

Relatório de erro com um único clique

Quando algo falha durante a importação (a URL bloqueada, o site não pôde ser lido, o processo foi interrompido, etc.), aparece um modal de erro com detalhes técnicos completos do problema.

O modal inclui um botão "Copiar relatório" que copia para a área de transferência todas as informações necessárias para que a equipe de suporte diagnostique rapidamente:

• URL que você tentou importar.
• Modo usado (URL / HTML / JSON).
• Mensagem de erro completa.
• Código HTTP interno (se aplicável).
• Origem detectada (Argenprop, Zonaprop, etc.).
• Tipo de bloqueio, se foi bloqueada (Cloudflare, login wall, etc.).
• Rastros técnicos do Step Function (executionArn) e relatórios de extração.

O mesmo modal também oferece um botão "Colar HTML manualmente" que muda diretamente para o modo HTML com a URL que falhou já preenchida, para você não precisar recomeçar o fluxo do zero.

O que fazer se a URL não funcionar: método HTML

Se o sistema não conseguir ler a URL automaticamente, existe um método alternativo que sempre funciona, independentemente do portal.

Esse método consiste em copiar o código-fonte da página diretamente do seu navegador e colá-lo na Mapaprop.

Como fazer passo a passo

1. Abra a página da propriedade no seu navegador (Chrome, Firefox, Edge, etc.).
2. Clique com o botão direito em qualquer parte da página (em uma área sem texto nem imagem).
3. No menu que aparece, clique em "Ver código-fonte da página" (ou "View Page Source"). Isso abre uma nova aba com texto.
   • Em alguns navegadores em inglês aparece "View Page Source".
   • Atalho de teclado: Ctrl+U (Windows/Linux) ou Cmd+U (Mac).
4. Nessa nova aba, pressione Ctrl+A (ou Cmd+A no Mac) para selecionar todo o texto.
5. Pressione Ctrl+C (ou Cmd+C no Mac) para copiar.
6. Volte para a Mapaprop e clique na aba HTML (ao lado da aba "URL").
7. Clique dentro do campo de texto e pressione Ctrl+V (ou Cmd+V no Mac) para colar.
8. Pressione o botão Processar HTML.

A partir daí o processo é idêntico ao método por URL: o sistema extrai os dados, os exibe para você revisar e completar, e depois você importa a propriedade.

Por que sempre funciona: nesse modo não há um robô visitando a página — é você quem a visitou (no seu navegador, já logado se necessário). O sistema apenas processa o texto que você fornece, então evita qualquer proteção anti-bot do site de origem.

Modo JSON (para usuários avançados)

Se você já tem os dados da propriedade estruturados como JSON (por exemplo, você os exportou de outro sistema), pode colá-los diretamente na aba JSON. Este modo:

• NÃO usa scraper nem IA.
• Faz apenas validação local do schema (tipos corretos, campos obrigatórios).
• É 100% confiável: se o JSON for válido, a importação sempre funciona.

É o caminho mais rápido quando você já tem os dados estruturados. Não é para uso comum das imobiliárias — é pensado para integrações ou migrações em massa.

Filiais e permissões

A filial determina quem recebe as consultas sobre a propriedade importada e quem pode administrá-la depois.

Para entender melhor como funcionam as funções e as filiais, consulte o documento Usuários, Corretores, Funções e Filiais.

Campos que são importados automaticamente

Quando o sistema consegue ler corretamente a página da propriedade, ele extrai automaticamente os seguintes dados:

• Título do anúncio
• Descrição
• Endereço
• Preço e moeda
• Tipo de propriedade (casa, apartamento, terreno, etc.)
• Operação (venda, aluguel, aluguel temporário)
• Quantidade de quartos, banheiros e ambientes
• Área total e área construída (m2)
• Idade do imóvel
• Localização geográfica (país, província, cidade, bairro)
• Imagens (até 20 por propriedade)

O que NÃO é importado automaticamente e fica para preencher manualmente (porque depende da lista interna da Mapaprop):

• Tipo de aquecimento, ar-condicionado, água quente
• Tipo de vaga de garagem (descoberta, garagem, vaga coberta, etc.)
• Tipo de sacada
• Orientação (norte/sul/leste/oeste)
• Localização do andar (frente, fundos, lateral, corredor, etc.)
• Estado da propriedade (novo, usado, na planta, etc.)

Nem todos os dados estão disponíveis em todos os anúncios. Se um dado não estiver na página original, também não poderá ser importado.

O que acontece com a propriedade importada depois

Depois de criada, a propriedade:

• Aparece na sua listagem de propriedades como rascunho (não publicada).
• Está vinculada à filial que você selecionou.
• Tem um código automático como IMP-1777347619236 (você pode editá-lo depois).
• Sincroniza automaticamente com redes e portais se você tiver integrações ativas e a rede permitir.
• Aparece nas suas buscas internas e no painel de gestão.

Para publicá-la em portais externos (Zonaprop, Argenprop, MercadoLibre, etc.) ou no seu site Mapaprop, você precisa ir até a propriedade e ativar a publicação manualmente. A importação cria a propriedade, mas NÃO a publica.

Perguntas frequentes

Quanto tempo demora a importação?

O processo de leitura da URL geralmente demora entre 30 segundos e 2 minutos. Em alguns casos pode chegar a 3 minutos. O processo final de salvar a propriedade demora alguns segundos adicionais para processar as imagens.

Posso importar de qualquer site?

Você pode tentar em qualquer site público. A maioria dos portais imobiliários conhecidos é compatível. Alguns sites bloqueiam a leitura automática; nesse caso o sistema avisa com uma mensagem clara de "Importação Bloqueada" e você pode usar o método HTML como alternativa.

As fotos são importadas?

Sim, quando as imagens estão disponíveis na página de origem. A quantidade de fotos importadas depende de quantas a propriedade original tem publicadas. O sistema as baixa, redimensiona e salva na sua conta como qualquer outra imagem de propriedade.

A propriedade fica publicada imediatamente?

Não. A propriedade é criada como rascunho. Ela fica salva na sua conta, mas não é publicada em nenhum portal. Você pode editá-la, completá-la e publicá-la quando estiver pronto, assim como qualquer propriedade carregada manualmente.

Posso editar os dados depois de importar?

Sim. Depois de importada, a propriedade se comporta como qualquer outra propriedade na Mapaprop: você pode editar todos os seus dados, adicionar ou remover imagens, alterar o preço, etc.

O que acontece se o portal mudou o design e os dados não são lidos corretamente?

O sistema pode não extrair corretamente todos os campos se o site de origem mudou sua estrutura. Nesse caso, o Passo 2 mostrará muitos campos para preencher manualmente. Se você preferir uma alternativa mais confiável, use o método HTML: copiando o código-fonte diretamente do seu navegador, o resultado costuma ser mais completo.

Posso importar a mesma propriedade duas vezes?

Sim. Cada importação cria uma nova propriedade na sua conta, independentemente de você já ter importado essa URL antes. O código da propriedade é gerado automaticamente com um timestamp (IMP-{numero}) para não colidir com códigos existentes. Se você quiser evitar duplicados, revise sua listagem antes de reimportar.

O que acontece se o processo for interrompido ou der erro?

Você pode tentar a importação novamente desde o início com a mesma URL. Não são geradas propriedades parciais se o processo não chegou até o Passo 3.

O corretor pode importar propriedades?

Sim. O corretor pode importar propriedades, e elas são atribuídas automaticamente à sua filial. Ele não pode alterar a filial ao importar (vendor isolation).

O que acontece se eu colar uma URL de um portal que exige login?

Se a URL exigir login para ver o detalhe da propriedade (como pode acontecer no MercadoLibre com alguns anúncios), o sistema pode:

1. Detectar o bloqueio e mostrar uma mensagem clara.
2. Retornar dados incompletos (porque viu apenas a página de login).

Em qualquer um dos dois casos, a solução é usar o modo HTML: você faz login no portal, copia o código-fonte da página já carregada e o cola na Mapaprop.