AirDNA (listing connector)¶
AirROI is the live STR source
Agents' default STR source is AirROI. AirDNA is an optional enrich step for known Airbnb URLs and only works when AirDNA credentials (AIRDNA_*) are configured for the workspace. If the run fails on auth, stop and tell the user.
Role¶
Enrich known Airbnb listing URLs with AirDNA metrics (ADR / occupancy / revenue when unlocked). Not a market finder and not sale ingest.
Lead source¶
Optional source=airdna on comps; not a sale lead_source_code.
Tools¶
| Job | Actor id | MCP tool |
|---|---|---|
| Airbnb / AirDNA | corent1robert/airdna-scraper |
corent1robert--airdna-scraper |
Input recipe¶
fetch-actor-details→ confirm schema.- Call with:
airbnbListingUrls:https://www.airbnb.com/rooms/...(one or more)currency:usdfor US deals (Actor default is ofteneur)marketId: AirDNA market id when known — without it, revenue / occupancy / revenue_potential are often redacted- Cap
maxTotalChargeUsd. get-dataset-items→ map metrics.
Gotchas¶
- Prefer platform-configured Actor secrets (
AIRDNA_*). Do not put email/password/bearer in tool args unless a workspace admin explicitly asks. - If the run fails on auth/rental/permissions, stop and tell the user — do not switch to another Actor.
- Prefer AirROI listings, VRBO geo, or web STR comps as market finders. Booking.com is not allowlisted.
- Never invent ADR/occ.
Persist hints¶
- Deal:
update_dealadr_nightly,occupancy_pctonly after evidence. - Comps:
add_deal_comp(kind=str)withsource=airdna+ listing URL; persistimage_urlwhen present. - Market-level STR series still go through
get_agent_manual(workflow=trends)/refresh_airroi_trends(catalog ≠ this Actor).
Related¶
- Research comps:
get_agent_manual(workflow=research) - Catalog:
get_agent_manual(workflow=data-sources)