AirROI (STR comps and market series)¶
Role¶
AirROI is the live short-term rental (STR) source for agents. It finds STR comps near a subject property and supplies the market-level STR series (ADR, occupancy, revenue) in catalog trends. It is not sale ingest.
Tools¶
| Job | MCP tool | Needs |
|---|---|---|
| STR listing comps near lat/lng | airroi_listings_comparables |
AIRROI_API_KEY; deal lat/lng |
| Market STR series | refresh_deal_trends(gap_fill=true) / refresh_airroi_trends |
AIRROI_API_KEY |
Both are paid. Call them only when STR is in scope (str in comps_kinds / strategy_intent) — never for LTR-only, flip-only or wholesale-only runs.
Usage¶
airroi_listings_comparables(…)returns candidates only — review them before saving.- Persist with
add_deal_comps(kind=str, source=airroi); keepimage_urlwhen present. - Market-level STR series go through
get_agent_manual(workflow=trends). Coverage is zip, neighborhood, city and county (county only for county geos), up to 60 months; state and MSA are unsupported.
Gotchas¶
- Never invent ADR or occupancy; patch
adr_nightly/occupancy_pctonly after evidence. - Catalog trends are not listing comps — they answer different questions.
- Optional add-ons: VRBO geo comps, and AirDNA for known Airbnb URLs when AirDNA credentials are configured.
Related¶
- Research comps:
get_agent_manual(workflow=research) - Trends:
get_agent_manual(workflow=trends) - Catalog:
get_agent_manual(workflow=data-sources)