AirROI

Análises de mercado do Airbnb e aluguéis de curto prazo — ocupação, ADR, RevPAR, receita, comparáveis e estimativas de receita por ML para mais de 30.000 mercados no mundo todo, com base em mais de 20 milhões de anúncios monitorados.

GitHubExperimente este MCPPatrocinado

Documentação

AirROI Airbnb MCP Server

Dados de mercado para aluguel de curta temporada para assistentes de IA · Remoto · HTTP Streamable · com.airroi/mcp

O servidor MCP da AirROI para Airbnb oferece ao Claude, Codex, Cursor, VS Code e qualquer outro cliente do Model Context Protocol 29 ferramentas para dados de mercado do Airbnb e aluguel de curta temporada: ocupação, ADR, RevPAR, percentis de receita, comparáveis, estimativas de receita, calendários ao vivo do Airbnb e ranking de busca, além de recomendações de preço. Ele cobre mais de 20 milhões de anúncios em mais de 190 países e responde a partir de um conjunto de dados mantido, para que seu assistente nunca precise fazer scraping no airbnb.com.

Este repositório contém apenas documentação. O servidor é totalmente remoto em https://mcp.airroi.com; não há nada para instalar ou executar. A AirROI é um provedor de dados independente e não é afiliada ao Airbnb. Em setembro de 2026, o Airbnb não possui servidor MCP oficial nem API pública.


Endpoint	`https://mcp.airroi.com`
Transporte	HTTP Streamable (remoto)
Autenticação	Cabeçalho `X-API-KEY`, obrigatório em todas as solicitações
Ferramentas	29 (11 de mercado, 13 de anúncios, 3 de consulta e estimativa, 2 de precificação)
Preço	A partir de US$ 0,01 por chamada, pague conforme o uso
Registro	`com.airroi/mcp` no Registro MCP oficial
Documentação	https://www.airroi.com/mcp-server

Qual servidor MCP do Airbnb você precisa?

"Servidor MCP do Airbnb" pode significar três coisas diferentes. Escolha pela tarefa:

Você quer…	Tipo de servidor	Exemplos	AirROI?
Encontrar um lugar para ficar	Scraper de busca de anúncios	Apify, Bright Data	Não
Gerenciar seus próprios anúncios (mensagens, reservas, calendários)	Servidor de gestão de propriedades	Hospitable, Guesty	Não
Analisar um mercado, uma propriedade ou um conjunto comparável	MCP de dados de mercado	AirROI	Sim

Uma comparação lado a lado com preços e limitações: https://www.airroi.com/mcp-server/compare

Obtenha uma chave de API

Cadastre-se para obter uma chave de API gratuita em https://www.airroi.com/api
Ative-a no painel do desenvolvedor em https://www.airroi.com/api/developer/activate e copie a chave.
Use-a como valor do cabeçalho X-API-KEY nos trechos abaixo. Substitua apenas YOUR_API_KEY.

Descobrir ferramentas (tools/list) não é cobrado, mas toda solicitação precisa da chave.

Configuração

Guias completos por cliente: Claude · Codex e ChatGPT · todos os outros clientes

Claude Code

claude mcp add --transport http airroi \
  https://mcp.airroi.com \
  --header "X-API-KEY: YOUR_API_KEY" --scope user

Verifique com claude mcp get airroi e depois faça uma pergunta de mercado ao Claude.

Claude Desktop

O Claude Desktop se conecta a servidores remotos com cabeçalhos personalizados por meio da ponte mcp-remote (requer Node.js). Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) e reinicie o aplicativo:

{
  "mcpServers": {
    "airroi": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.airroi.com",
        "--header",
        "X-API-KEY:${AIRROI_API_KEY}"
      ],
      "env": { "AIRROI_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Mantenha X-API-KEY:${AIRROI_API_KEY} sem espaços ao redor dos dois-pontos.

Codex (CLI, extensão de IDE e aplicativo de desktop do ChatGPT)

Todos os três leem ~/.codex/config.toml:

[mcp_servers.airroi]
url = "https://mcp.airroi.com"
env_http_headers = { "X-API-KEY" = "AIRROI_API_KEY" }

Depois, export AIRROI_API_KEY=YOUR_API_KEY no seu perfil de shell. codex mcp list mostra Auth: Unsupported para autenticação por cabeçalho; isso é esperado. O ChatGPT na web (modo desenvolvedor) não suporta servidores com chave de API, então use o Codex.

Cursor

~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto):

{
  "mcpServers": {
    "airroi": {
      "url": "https://mcp.airroi.com",
      "headers": { "X-API-KEY": "${env:AIRROI_API_KEY}" }
    }
  }
}

VS Code (modo agente do Copilot)

.vscode/mcp.json. A chave de nível superior é servers, não mcpServers:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "airroi-key",
      "description": "AirROI API key",
      "password": true
    }
  ],
  "servers": {
    "airroi": {
      "type": "http",
      "url": "https://mcp.airroi.com",
      "headers": { "X-API-KEY": "${input:airroi-key}" }
    }
  }
}

Devin Desktop (antigo Windsurf)

~/.config/devin/mcp_config.json (Windows: %APPDATA%\devin\mcp_config.json):

{
  "mcpServers": {
    "airroi": {
      "serverUrl": "https://mcp.airroi.com",
      "headers": { "X-API-KEY": "${env:AIRROI_API_KEY}" }
    }
  }
}

CLI Antigravity (sucessor do Gemini CLI)

~/.gemini/config/mcp_config.json (global) ou .agents/mcp_config.json (projeto):

{
  "mcpServers": {
    "airroi": {
      "serverUrl": "https://mcp.airroi.com",
      "headers": { "X-API-KEY": "YOUR_API_KEY" }
    }
  }
}

n8n

Adicione um nó AI Agent e anexe um nó MCP Client Tool a ele.
Defina o endpoint para https://mcp.airroi.com e o transporte para HTTP Streamable.
Escolha Header Auth e crie uma credencial com o nome X-API-KEY e sua chave como valor.

OpenAI Agents SDK (Python)

import asyncio, os
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    async with MCPServerStreamableHttp(
        name="airroi",
        params={
            "url": "https://mcp.airroi.com",
            "headers": {"X-API-KEY": os.environ["AIRROI_API_KEY"]},
        },
    ) as airroi:
        agent = Agent(name="STR analyst", mcp_servers=[airroi])
        result = await Runner.run(
            agent, "Occupancy and ADR for 2-bedroom homes in Nashville?"
        )
        print(result.final_output)

asyncio.run(main())

Qualquer cliente somente stdio

npx mcp-remote https://mcp.airroi.com --header X-API-KEY:${AIRROI_API_KEY}

Uma sessão real

Prompt, executado no servidor ao vivo em mcp.airroi.com:

Compare Austin e Nashville para um Airbnb inteiro de 2 quartos: ocupação, ADR, RevPAR, receita anual e quantos anúncios concorrentes eu enfrentaria.

Chamadas de ferramentas: airroi_search_markets → airroi_search_markets → airroi_market_summary → airroi_market_summary → airroi_market_revenue → airroi_market_revenue (custo US$ 0,42)

Nos últimos 12 meses, casas inteiras de 2 quartos em Nashville ganharam mais por anúncio: US$ 40.075 em receita anual média contra US$ 24.965 em Austin. A ocupação é quase idêntica (49% vs 48%), então a diferença vem da diária: o ADR de Nashville é US$ 296 contra US$ 236 em Austin, resultando em RevPAR de US$ 146 versus US$ 114. Nashville também tem menos oferta de 2 quartos, cerca de 1.270 anúncios ativos por mês contra cerca de 2.029 em Austin. Outubro de 2025 foi o mês mais forte para o anúncio mediano em ambos os mercados, com US$ 5.009 em Nashville e US$ 3.941 em Austin.

Mais sessões (ranking de busca ao vivo, relatórios de proprietários, ritmo futuro, Lisboa): https://www.airroi.com/mcp-server/use-cases

Ferramentas (29)

Nenhuma ferramenta pode alterar um anúncio, preço, reserva ou mensagem. 26 ferramentas são marcadas como somente leitura; as outras 3 criam um arquivo para download ou um cursor de varredura.

Análise de mercado (11)

Ferramenta	O que faz	Preço por chamada
`airroi_market_min_nights`	Acompanhe as médias mensais de noites mínimas e a distribuição percentual em um mercado. Use para entender restrições locais de estadia junto com tendências de ocupação e preço.	US$ 0,10
`airroi_market_summary`	Obtenha uma visão geral rápida do mercado com estatísticas-chave: ocupação, ADR, RevPAR, receita anual média por anúncio, prazo de antecedência de reserva, duração da estadia, noites mínimas e número de anúncios ativos. Retorna um instantâneo de 12 meses em uma única resposta para qualquer mercado.	US$ 0,10
`airroi_market_metrics_all`	Acesse todas as métricas de mercado combinadas em uma única resposta. Retorna séries temporais mensais com distribuições percentuais (média, p25, p50, p75, p90) para ocupação, ADR, RevPAR, receita, antecedência, duração da estadia, noites mínimas e anúncios ativos — a ferramenta única mais abrangente.	US$ 0,50
`airroi_market_occupancy`	Acompanhe tendências históricas e sazonais da taxa de ocupação com séries temporais mensais. Retorna médias e distribuições percentuais para identificar períodos de pico de demanda e padrões de reserva.	US$ 0,10
`airroi_market_adr`	Analise tendências da Diária Média (ADR) com séries temporais mensais e distribuições percentuais. Acompanhe compressão de preços, flutuações sazonais e crescimento de tarifas em todo o mercado.	US$ 0,10
`airroi_market_revpar`	Monitore a Receita por Aluguel Disponível, combinando ocupação e preço em uma única métrica de desempenho. Retorna séries temporais mensais com distribuições percentuais para benchmarking.	US$ 0,10
`airroi_market_revenue`	Acompanhe a receita mensal dos anúncios com séries temporais e distribuições percentuais. Analise tendências de crescimento de receita e padrões sazonais para dimensionar oportunidades de investimento.	US$ 0,10
`airroi_market_lead_time`	Entenda com quanta antecedência os hóspedes reservam em qualquer mercado, medido em dias. Retorna séries temporais mensais com percentis para otimizar estratégias de preço e timing de marketing.	US$ 0,10
`airroi_market_los`	Analise padrões médios de duração da estadia dos hóspedes, medidos em noites. Retorna séries temporais mensais com distribuições percentuais para planejamento operacional e otimização da estadia mínima.	US$ 0,10
`airroi_market_active_listings`	Monitore o crescimento da oferta do mercado acompanhando o número de anúncios ativos ao longo do tempo. Identifique novos entrantes, saturação do mercado e mudanças no cenário competitivo com séries temporais mensais.	US$ 0,10
`airroi_market_future_pacing`	Acesse o ritmo de reservas futuro para datas próximas. Retorna dados diários de ritmo com número de reservados, disponíveis, tarifas médias e taxa de preenchimento para previsão de demanda e receita.	US$ 0,20

Consulta de mercado e estimativas de receita (3)

Ferramenta	O que faz	Preço por chamada
`airroi_search_markets`	Pesquise mercados de aluguel de curta temporada por nome com correspondência de prefixo. Retorna os identificadores exatos do mercado (país, região, localidade, distrito) com contagens de anúncios ativos necessários para todas as ferramentas de mercado.	US$ 0,01
`airroi_lookup_market`	Resolva coordenadas GPS brutas para os identificadores exatos do mercado (país, região, localidade, distrito) que toda ferramenta de mercado exige. O inverso de search_markets — use quando você tiver latitude/longitude em vez de um nome de lugar.	US$ 0,01
`airroi_estimate_revenue`	Gere projeções de receita para qualquer local com base em quartos, banheiros e capacidade de hóspedes. Retorna receita anual projetada, ADR, ocupação com distribuições percentuais (p25-p90), distribuição mensal e anúncios comparáveis.	US$ 0,20

Dados de anúncios (4)

Ferramenta	O que faz	Preço por chamada
`airroi_get_listing`	Recupere dados completos de um anúncio do Airbnb por ID: detalhes da propriedade, texto da descrição, URLs de fotos, horários de check-in e check-out, status de favorito dos hóspedes, preços, avaliações e métricas de desempenho, incluindo ocupação, ADR e receita dos últimos 12 meses e dos últimos 90 dias.	US$ 0,10
`airroi_batch_listings`	Busque informações detalhadas de até 25 propriedades em uma única solicitação cobrada. Retorna contagens e um recurso JSON baixável com detalhes completos das propriedades e quaisquer erros por ID. Baixar o recurso não repete a chamada de API.	US$ 1,00
`airroi_find_comparables`	Descubra até 25 propriedades semelhantes classificadas por relevância com base em localização, quartos, banheiros e capacidade de hóspedes. Especifique a localização por coordenadas ou endereço físico e, opcionalmente, um raio de 1 a 10 milhas e tipo de quarto, para benchmarking competitivo.	US$ 0,10
`airroi_listing_metrics`	Acesse até 60 meses de dados históricos de desempenho por anúncio: ocupação mensal, ADR, RevPAR, receita e média de noites mínimas. Ideal para análise de tendências, detecção de sazonalidade e subscrição de investimentos.	US$ 0,10

Busca e exportação de anúncios (4)

Ferramenta	O que faz	Preço por chamada
`airroi_search_by_market`	Busque anúncios ativos em uma cidade, região ou bairro usando definições de mercado do OpenStreetMap, ou globalmente quando nenhum mercado é informado. Filtre por atributos da propriedade, dados do anfitrião, preços, avaliações e métricas de desempenho; retorna até 10 resumos compactos por chamada.	US$ 0,50
`airroi_search_by_radius`	Encontre propriedades em um raio de 1 a 100 milhas de quaisquer coordenadas GPS. Suporta os mesmos filtros e ordenação da busca de mercado para análise competitiva baseada em localização; retorna até 10 resumos compactos por chamada.	US$ 0,50
`airroi_search_by_polygon`	Busque anúncios dentro de limites geográficos personalizados definidos por 3 ou mais pontos de coordenadas. Desenhe qualquer formato para definir sua área de busca para segmentação precisa de mercado e análise de bairro; retorna até 10 resumos compactos por chamada.	US$ 0,50
`airroi_export`	Exporte todos os anúncios que correspondem a um seletor de mercado, raio ou polígono personalizado para um único arquivo baixável, entregue como uma URL de download pré-assinada válida por 7 dias. O conjunto de dados completo nunca é transmitido na conversa — você recebe metadados, uma prévia curta e o link de download para salvar localmente. Escolha JSONL (um objeto de anúncio aninhado completo por linha) ou CSV (colunas resumidas achatadas). A paginação é tratada internamente até um limite de 100.000 anúncios; exportações muito grandes retornam um arquivo parcial com contagens se o orçamento de tempo for atingido. Ideal para análise em massa, pipelines de dados e scripts offline.	US$ 0,50 (1 chamada por 10 anúncios)

Dados ao vivo do Airbnb (5)

Ferramenta	O que faz	Preço por chamada
`airroi_live_calendar`	Busca o calendário de um anúncio ao vivo no Airbnb: tarifas noturnas (excluindo a taxa de limpeza), disponibilidade e estadias mínimas para os próximos 12 meses, além da taxa de limpeza do anfitrião e da taxa de limpeza para estadias curtas. Noites reservadas e bloqueadas pelo anfitrião aparecem como indisponíveis.	$0,20
`airroi_live_rates`	Busca apenas as tarifas noturnas de um anúncio ao vivo para os próximos 12 meses, na moeda local ou em dólares americanos. Use para acompanhar preços de concorrentes quando a disponibilidade não for necessária.	$0,10
`airroi_live_availability`	Busca a disponibilidade e as regras de estadia de um anúncio ao vivo para os próximos 12 meses: noites abertas ou indisponíveis, estadia mínima e máxima, e se os hóspedes podem fazer check-in ou check-out em cada data.	$0,10
`airroi_live_search_ranking`	Veja os anúncios que a busca do Airbnb mostra para um retângulo no mapa, em ordem de classificação (até 270). Use para verificar onde um anúncio aparece na busca em relação aos concorrentes.	$0,20
`airroi_live_scan`	Encontre todos os IDs de anúncios do Airbnb dentro de um polígono personalizado, ao vivo, até 100 IDs por página. Continue com o scan_id curto que ele retorna; o servidor mantém o progresso da varredura, então cada página permanece pequena. Combine com get_listing ou batch_listings para detalhes completos.	$0,50

Recomendações de preço (2)

Ferramenta	O que faz	Preço por chamada
`airroi_recommend_base_price`	Estima um preço noturno inicial para o ano todo a partir das coordenadas da propriedade e fatos conhecidos sobre ela. Comodidades opcionais, avaliações e outros detalhes podem refinar a estimativa. Nada é salvo ou publicado.	$0,10
`airroi_recommend_calendar_prices`	Calcula preços noturnos a partir de coordenadas, moeda e um preço base. Sazonalidade modelada, dias da semana, eventos e demanda combinam-se com regras de preço opcionais, ajustes sazonais, limites de preço e restrições de estadia.	$0,10

Referência completa com parâmetros: https://www.airroi.com/mcp-server/tools

Quanto custa uma pergunta

Uma análise de mercado típica leva seis chamadas:

Chamada	Preço
`airroi_search_markets`	$0,01
`airroi_market_summary`	$0,10
`airroi_market_occupancy`	$0,10
`airroi_market_adr`	$0,10
`airroi_market_revenue`	$0,10
`airroi_market_future_pacing`	$0,20
Total	$0,61

Lista de preços: https://www.airroi.com/api/pricing

Cobertura de dados

Mais de 20 milhões de anúncios em mais de 190 países e mais de 30.000 mercados
Ocupação mensal, ADR, RevPAR e receita com percentis p25/p50/p75/p90, até 60 meses por solicitação
Calendários, tarifas, disponibilidade e classificação de busca ao vivo do Airbnb, até 12 meses à frente
Moedas locais, ou USD sob solicitação

Licença

MIT, veja LICENSE.