Skip to content

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

  1. fetch-actor-details → confirm schema.
  2. Call with:
  3. airbnbListingUrls: https://www.airbnb.com/rooms/... (one or more)
  4. currency: usd for US deals (Actor default is often eur)
  5. marketId: AirDNA market id when known — without it, revenue / occupancy / revenue_potential are often redacted
  6. Cap maxTotalChargeUsd.
  7. 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_deal adr_nightly, occupancy_pct only after evidence.
  • Comps: add_deal_comp(kind=str) with source=airdna + listing URL; persist image_url when present.
  • Market-level STR series still go through get_agent_manual(workflow=trends) / refresh_airroi_trends (catalog ≠ this Actor).
  • Research comps: get_agent_manual(workflow=research)
  • Catalog: get_agent_manual(workflow=data-sources)