Communitygithub.com

propertyiq

Analisa e subscrição de investimentos residenciais de pequeno porte (SFR, duplex, triplex, quadplex e 5–20 unidades) com relatórios individuais e comparação lado a lado.

O que é propertyiq?

O PropertyIQ é um agente especializado em subscrição de imóveis residenciais de pequeno porte para investidores. Ele aceita URLs de listagens (Zillow, Realtor.com, etc.) ou endereços e preços diretamente, e realiza uma análise completa de viabilidade: desde a extração dos dados do anúncio, pesquisa de aluguéis comparáveis, impostos, seguro e índice de criminalidade, até a geração de relatórios markdown detalhados com fluxo de caixa, cap rate, retorno cash-on-cash, DSCR, LTV e verificações como a regra dos 1%. O skill suporta modo individual ou multi-propriedade (até 3 imóveis), gerando relatórios individuais e um comparativo lado a lado. É útil para investidores que desejam uma triagem rápida e padronizada antes de aprofundar a due diligence. As informações são baseadas em defaults de mercado (tabelas de referência) e dados públicos, com transparência sobre o nível de confiança das estimativas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ah20-dev/propertyiq/tree/main

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

propertyiq — Subscrição de Investimentos Residenciais de Pequeno Porte

Comando de Barra

Esta skill pode ser invocada diretamente com: /propertyiq [URL da listagem] /propertyiq [URL1] [URL2] [URL3] /propertyiq [endereço] [preço pedido] /propertyiq (sem argumento — solicita URL ou endereço do usuário)

Aceita 1, 2 ou 3 URLs de listagem em uma única invocação. Quando várias URLs são fornecidas, execute um relatório individual completo para cada propriedade e, em seguida, gere uma comparação lado a lado. Quando chamado via comando de barra, ignore a detecção de gatilho ambiente e prossiga diretamente para a Etapa 1 com o que o usuário forneceu após o comando.

Escopo

O propertyiq cobre apenas propriedades de investimento residencial de pequeno porte:

  • Aluguéis de Família Única (SFR) — 1 unidade
  • Pequeno Multifamiliar — Duplex, Triplex, Quadplex (2–4 unidades)
  • Multifamiliar Médio — 5–20 unidades

Fora do escopo (não tratado por esta skill):

  • Multifamiliar grande (21+ unidades) — requer subscrição de dívida institucional, T-12 real, perda por aluguel
  • Parques de casas móveis — modelo de renda apenas do terreno, estrutura de aluguel do lote
  • Aluguéis de curto prazo (Airbnb/VRBO) — requer modelagem ADR/ocupação, taxas de plataforma
  • Habitação estudantil — precificação por cama, estrutura de aluguel por ano letivo
  • Comercial / uso misto — estrutura de renda e despesas totalmente diferente

Se um usuário fornecer um tipo de propriedade fora do escopo, informe claramente e explique que tipo de análise seria necessária.


Etapa 1 — Detectar Modo e Raspar Listagens

1a. Detectar Modo Único vs. Multi-Propriedade

Conte o número de URLs de listagem na mensagem do usuário:

  • 1 URL → Modo propriedade única. Execute as Etapas 2–6 uma vez. Produza um arquivo .md de relatório.
  • 2–3 URLs → Modo multi-propriedade. Execute as Etapas 2–5 para CADA propriedade de forma independente. Em seguida, execute a Etapa 6 (Relatório de Comparação) após todos os relatórios individuais estarem concluídos. Produza um arquivo .md por propriedade MAIS um arquivo .md de comparação.

Máximo suportado: 3 URLs. Se o usuário colar mais de 3, processe as 3 primeiras e observe que apenas 3 são suportadas por execução.

1b. Raspar Cada Listagem

Para cada URL, use web_fetch para extrair:

Dados da propriedade:

  • Endereço, cidade, estado, CEP
  • Tipo de propriedade (SFR, duplex, triplex, quadplex, 5–20 unidades, uso misto)
  • Número de unidades
  • Ano de construção
  • Metragem quadrada (total e por unidade, se disponível)
  • Quartos/banheiros por unidade
  • Preço pedido
  • Aluguéis listados (se mostrados) — atuais e/ou pro-forma
  • Despesas listadas (impostos, seguros, HOA, se houver)
  • Estrutura de utilidades (pago pelo inquilino vs. pago pelo proprietário — liste quais)
  • Estacionamento, lavanderia, notas de comodidades
  • Dias no mercado, histórico de preços se visível
  • Qualquer cap rate ou GRM mencionado na listagem

Se a página estiver atrás de um login ou retornar dados incompletos, use web_search para pesquisar o endereço diretamente (ex.: "123 Main St Springfield IL" site:zillow.com OR site:realtor.com) e tente web_fetch no melhor resultado.


Etapa 2 — Preencher Lacunas com Pesquisa de Mercado

2a. Comparáveis de Aluguel (SEMPRE execute esta etapa se os aluguéis da listagem estiverem ausentes ou não verificados)

Pesquise aluguéis comparáveis no mesmo CEP ou bairro:

web_search: "[cidade] [estado] [quarto/banheiro] preço de aluguel [ano]"
web_search: "[CEP] aluguel médio [tipo de unidade]"
web_search: "rentometer [cidade] [estado] [número de quartos]"

Obtenha 2–3 pontos de dados. Use a mediana dos comparáveis como sua estimativa de aluguel. Anote a faixa. Se a listagem já mostrar aluguéis, ainda pesquise comparáveis para validar — sinalize um delta >15% como risco.

2b. Imposto Predial Local

Se não estiver na listagem, pesquise: "[endereço] imposto predial" ou "[condado] taxa de imposto predial". Use valor avaliado × taxa do moinho se encontrar. Estime conservadoramente se incerto.

2c. Estimativa de Seguro

Se não estiver listado, use benchmarks regionais de references/insurance-benchmarks.md.

2d. Índice de Segurança — Dados de Crime e Bairro

SEMPRE execute esta etapa para cada análise. Pesquise dados de crime e segurança para o CEP e bairro da propriedade. Esses dados afetam diretamente o risco de vacância, qualidade do inquilino, prêmios de seguro e valorização de longo prazo — tudo que é preocupação do investidor.

Consultas de pesquisa a executar:

web_search: "[CEP] taxa de criminalidade estatísticas [ano]"
web_search: "[cidade] [bairro] índice de criminalidade pontuação de segurança"
web_search: "NeighborhoodScout [CEP] crime"
web_search: "SpotCrime OR CrimeGrade [CEP]"

Pontos de dados a coletar (use o que estiver disponível — nem todos serão encontrados):

  • Índice geral de criminalidade / pontuação de segurança (ex.: nota CrimeGrade A–F, percentil NeighborhoodScout, pontuação SpotCrime)
  • Taxa de crimes violentos (por 1.000 residentes) vs. média nacional
  • Taxa de crimes contra a propriedade (por 1.000 residentes) vs. média nacional — mais relevante para proprietários
  • Tendência: o crime está aumentando, diminuindo ou estável nos últimos 3 anos?
  • Qualquer contexto específico do bairro (proximidade a áreas de alta criminalidade, gentrificação, etc.)

Escala de classificação a aplicar consistentemente: A (Muito Seguro): Crime bem abaixo da média nacional — top 20% mais seguro nacionalmente B (Seguro): Crime significativamente abaixo da média nacional C (Médio): Próximo da média nacional — aceitável, mas sinalizar para conscientização do investidor D (Abaixo da Média): Crime acima da média nacional — risco elevado de vacância/inquilino/seguro F (Alto Risco): Crime significativamente acima da média nacional — grande sinal de risco de investimento

Enquadramento de impacto para o investidor — inclua sempre pelo menos uma destas observações:

  • Alto crime contra a propriedade → prêmios de seguro elevados, vacância maior, risco de rotatividade de inquilinos
  • Alto crime violento → impacta demanda de inquilinos, escrutínio de credores, arrasto na valorização
  • Tendência de melhora (crime em declínio) → positivo para valorização; sinal potencial de value-add se comprar antes da melhoria do bairro; observe que a gentrificação pode deslocar inquilinos existentes
  • Tendência de piora (crime em ascensão) → risco crescente de vacância, pressão no seguro, arrasto de valor

Se os dados não estiverem disponíveis: Anote "Dados de segurança indisponíveis para este CEP — recomenda-se verificar CrimeGrade.org, NeighborhoodScout.com ou mapa de crimes da polícia local antes de prosseguir."


Etapa 3 — Confirmar Suposições com o Usuário

Modo propriedade única: Apresente os dados raspados e as suposições propostas para a única propriedade.

Modo multi-propriedade: Apresente um bloco de confirmação combinado mostrando todas as propriedades lado a lado. Use os mesmos padrões de financiamento para todas as propriedades, a menos que o usuário especifique o contrário (diferentes tipos de propriedade podem ter padrões diferentes conforme a tabela de referência).

Exemplo (propriedade única):

Encontrei o seguinte da listagem. Por favor, confirme ou corrija antes de eu executar a análise:

  Endereço:          123 Main St, Trenton, NJ 08611
  Tipo de Propriedade:    Triplex (3 unidades)
  Ano de Construção:       1922
  Preço Pedido:     $485.000
  Mix de Unidades:         3x 2BR/1BA (~70 m² cada)
  Aluguéis Atuais:    $1.400/unidade/mês (listagem)
  Comparáveis de Aluguel:       $1.350–$1.550/mês (Zillow/Rentometer mediana ~$1.450)
  Imposto Predial:     $9.200/ano (registro público)
  Utilidades:        Pagas pelo inquilino (todas)

  Padrões de Financiamento que usarei:
    Entrada:     25% ($121.250)
    Taxa de Juros:    7,25% (média comercial 30 anos atual)
    Amortização:     25 anos
    Vacância:          7% (padrão multifamiliar)
    Reserva CapEx:    $125/unidade/mês ($4.500/ano)
    Manutenção:      $60/unidade/mês ($2.160/ano)
    Taxa de Administração:         8% da RBE (padrão terceirizado)
    Pontos:           0 (empréstimo convencional)

  Deseja alterar algo? Ou digite "executar" para prosseguir.

Exemplo (multi-propriedade — condensado):

Encontradas 3 propriedades. Os mesmos padrões de financiamento se aplicarão a todas, a menos que você especifique o contrário.

  Propriedade 1:  123 Main St, Trenton NJ  — Triplex — $485.000 — Aluguéis $1.400/unidade
  Propriedade 2:  456 Oak Ave, Newark NJ   — Duplex  — $320.000 — Aluguéis $1.600/unidade
  Propriedade 3:  789 Pine St, Camden NJ   — SFR     — $185.000 — Aluguel  $1.800/mês

  Padrões de financiamento: 25% entrada | 7,25% | 25 anos amortização | vacância de mercado | reservas padrão

  Deseja alterar algo? Ou digite "executar" para prosseguir.

Se o usuário disser "executar" ou não fornecer correções, prossiga com os padrões.


Etapa 4 — Executar os Cálculos de Subscrição

Padrões do Setor por Tipo de Propriedade

Leia references/defaults-by-property-type.md para a tabela completa. Resumo:

MétricaSFR2–4 Unidades5–20 Unidades
Entrada25%25%25–30%
Taxa de Jurosmédia conv. 30 anos atualmédia conv. 30 anos atualmédia comercial atual
Amortização30 anos25 anos25 anos
Vacância5%7%8%
Reserva CapEx5–8% aluguel bruto$100–150/unidade/mês$75–100/unidade/mês
Manutenção$75–125/mês$50–75/unidade/mês$40–60/unidade/mês
Taxa de Administração10% RBE10% RBE8% RBE
Meta de Razão de OpEx45–55%45–55%45–55%

Sempre use o ponto médio ou o extremo conservador das faixas — estas são telas de viabilidade, não projeções de melhor caso.

Cálculos a Realizar

Renda Potencial Bruta (RPB)      = soma de todos os aluguéis mensais das unidades × 12
Perda por Vacância                      = RPB × taxa de vacância
Renda Bruta Efetiva (RBE)      = RPB − Perda por Vacância
Despesas Operacionais                = Impostos + Seguro + Taxa de Admin. + Reserva CapEx
                                    + Manutenção/Reparos + Outros
  NOTA: Reserva CapEx e Manutenção são itens de linha SEPARADOS:
    Reserva CapEx   = itens de capital importantes (telhado, HVAC, eletrodomésticos) — reservado, não gasto anualmente
                      SFR: 5–8% aluguel bruto | 2–4 unidades: $100–150/unidade/mês | 5–20 unidades: $75–100/unidade/mês
    Manutenção     = reparos menores contínuos
                      SFR: $75–125/mês | 2–4 unidades: $50–75/unidade/mês | 5–20 unidades: $40–60/unidade/mês
Renda Operacional Líquida (ROL)        = RBE − Despesas Operacionais
Serviço da Dívida Anual               = P&I mensal × 12  [usar fórmula de amortização padrão]
Fluxo de Caixa Anual                  = ROL − Serviço da Dívida Anual
Fluxo de Caixa Mensal                 = Fluxo de Caixa Anual / 12

Taxa de Capitalização (Cap Rate)                          = ROL / Preço de Compra
Retorno Cash-on-Cash (CoC)         = Fluxo de Caixa Anual / Caixa Total Investido
  Mostrar DUAS versões:
    CoC (Apenas Entrada)       = Fluxo de Caixa Anual / Entrada
    CoC (Tudo Incluído)                  = Fluxo de Caixa Anual / (Entrada + Custos de Fechamento + Pontos)
  CoC primário = apenas entrada (corresponde à convenção do investidor).
  Caixa Total para Fechar = Entrada + Custos de Fechamento + Pontos de Originação
    Custos de Fechamento = 2,5% (SFR/2–4 unidades) ou 3% (5–20 unidades) do preço de compra
    Pontos de Originação = 0 para convencional | 1–2% do valor do empréstimo para empréstimos comerciais/DSCR
Índice de Cobertura do Serviço da Dívida (ICSD)= ROL / Serviço da Dívida Anual
Relação Loan-to-Value (LTV)               = Valor do Empréstimo / Preço de Compra
Multiplicador de Aluguel Bruto (GRM)       = Preço de Compra / RPB
Ponto de Equilíbrio de Aluguel/Unidade              = (Serviço da Dívida Anual + Despesas Operacionais) / (unidades × 12)
Preço por Unidade                    = Preço de Compra / unidades
Verificação da Regra de 1%                     = (Aluguel Mensal / Preço de Compra) × 100
  ≥1,0%  → passa na triagem rápida; vale a subscrição completa
  0,7–1,0% → limítrofe; depende do mercado e da tese de valorização
  <0,7%  → falha na regra; fluxo de caixa muito improvável com financiamento convencional
  Nota: A regra de 1% é um filtro grosseiro, não uma decisão — sempre execute a ROL completa independentemente

Para P&I mensal use: M = P × [r(1+r)^n] / [(1+r)^n − 1] onde P = valor do empréstimo, r = taxa mensal, n = meses de amortização


Etapa 5 — Construir o Relatório de Propriedade Individual (.md)

Produza cada relatório como um arquivo Markdown formatado corretamente usando o modelo abaixo. Use cabeçalhos Markdown, tabelas e negrito — NÃO divisores ASCII. Salve como:

  • Propriedade única: propertyiq-[endereço-curto].md (ex.: propertyiq-403-leverett-staten-island.md)
  • Multi-propriedade: propertyiq-[endereço-curto]-1.md, propertyiq-[endereço-curto]-2.md, etc.

Leia templates/report.md e preencha cada [placeholder] com os valores calculados para esta propriedade. Não pule nenhuma seção. Não altere a estrutura.


Etapa 6 — Construir o Relatório de Comparação (.md) [APENAS MODO MULTI-PROPRIEDADE]

Após todos os relatórios individuais estarem concluídos, gere um único arquivo de comparação chamado propertyiq-comparison.md. Este arquivo apresenta as principais métricas de tomada de decisão lado a lado para que o investidor possa classificar e escolher.

Leia templates/comparison.md e preencha cada [placeholder] com os valores calculados para cada propriedade. Não pule nenhuma seção. Não altere a estrutura.


Etapa 7 — Notas sobre Qualidade dos Dados

Ao final de cada relatório individual, seja transparente sobre o nível de confiança:

  • ALTA: Todos os dados-chave raspados ou confirmados de registros públicos
  • MÉDIA: 1–2 entradas estimadas (sinalizar quais)
  • BAIXA: Aluguéis ou despesas são estimados — sinalizar proeminentemente e recomendar verificação pelo usuário

Referências

  • references/defaults-by-property-type.md — Tabela completa de suposições padrão por tipo de propriedade
  • references/insurance-benchmarks.md — Estimativas regionais de custo de seguro
  • references/cap-rate-benchmarks.md — Faixas de cap rate de mercado por nível metropolitano

Leia esses arquivos de referência quando precisar dos benchmarks detalhados. Eles não são carregados por padrão para manter o contexto enxuto — puxe-os conforme necessário.

Habilidades Relacionadas