# Airbnb Listing Detail

> Obtiene el detalle completo de un listing de Airbnb por su ID numérico vía la API interna GraphQL: título, tipo de habitación, descripción, amenities, fotos, coordenadas, ciudad, reglas, ratings y dormitorios.

Fuente: https://skillsagentes.com/skills/browser-act/skills/airbnb-listing-detail
Markdown: https://skillsagentes.com/skills/browser-act/skills/airbnb-listing-detail.md

Repositorio: https://github.com/browser-act/skills
Autor: browser-act
Licencia: MIT
Actualizado: hace 2 meses
Coste de contexto: 151 tok instalada, 1.4k tok al activarse, 4k tok con todos los archivos del bundle
Bundle: 2 archivos, 16 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add browser-act/skills --skill airbnb-listing-detail --agent claude-code
# Cursor
npx -y skills add browser-act/skills --skill airbnb-listing-detail --agent cursor
# Codex
npx -y skills add browser-act/skills --skill airbnb-listing-detail --agent codex
# Gemini CLI
npx -y skills add browser-act/skills --skill airbnb-listing-detail --agent gemini
# Windsurf
npx -y skills add browser-act/skills --skill airbnb-listing-detail --agent windsurf
# Cline
npx -y skills add browser-act/skills --skill airbnb-listing-detail --agent cline
```

## Qué hace

- Consulta la API interna GraphQL StaysPdpSections de Airbnb con un listing_id para obtener detalle completo de la propiedad
- Devuelve título, tipo de habitación, descripción, amenities, fotos, coordenadas, ciudad, reglas de la casa, highlights, ratings y configuración de dormitorios
- Ejecuta scripts/listing-detail.py vía eval con parámetros opcionales de checkin/checkout, adults, locale y currency

## Cuándo usarla

- El usuario pide detalles de un listing de Airbnb, información de propiedad, amenities, reglas de la casa o descripción
- Se necesita extraer datos de una página de detalle de Airbnb a partir de su ID numérico (airbnb.com/rooms/{listing_id})
- Se requiere hacer scraping en batch de múltiples listing IDs con delays entre llamadas

## Qué la activa

- "Obtén los detalles del listing de Airbnb 5476930"
- "Dame las amenities y reglas de la casa de esta propiedad de Airbnb"
- "Extrae título, fotos y rating de este room de Airbnb"

## Antes de instalar

- Requiere el navegador abierto (no necesita login) y disponibilidad de la herramienta browser-act.
- makes network requests

## Archivos

- SKILL.md — 5 KB
- scripts/listing-detail.py — 10 KB

## SKILL.md

Reproducido tal cual desde browser-act/skills bajo MIT. Esta sección es el documento original y está en inglés.

# Airbnb — Listing Detail

> Listing ID → full property detail via internal GraphQL API (no login required)

## Language

All process output to user (progress updates, process notifications) follows the user's language.

## Objective

Fetch comprehensive listing data for an Airbnb property using the internal StaysPdpSections GraphQL API.

## Prerequisites

- Browser is open (any page). The API call is made via `fetch()` in the browser context — no specific page navigation required.
- No login required — the API endpoint is publicly accessible

## Pre-execution Checks

### 1. Tool Readiness

If browser-act has been confirmed available in the current session → skip this step.

Invoke `browser-act` via Skill tool to load usage. If installation or configuration issues arise, follow its guidance to resolve then retry.

## Capability Components

> This Skill's operational boundary = what the user can manually do in their browser. It only reads data already displayed to the user on the page, never bypassing authentication or access controls. JS code is encapsulated in Python files under the `scripts/` directory, invoked via `eval "$(python scripts/xxx.py {params})"`. `$(...)` is bash syntax; it is recommended to use the bash tool for execution.

### API: fetch listing detail

`eval "$(python scripts/listing-detail.py '{listing_id}')"`

Parameters:
- `listing_id`: numeric Airbnb listing ID (e.g., `5476930`). Extract from listing URL: `airbnb.com/rooms/{listing_id}`
- `--checkin`: check-in date in YYYY-MM-DD format, default: none (price info unavailable without dates)
- `--checkout`: check-out date in YYYY-MM-DD format, default: none
- `--adults`: number of adult guests, default: `1`
- `--locale`: response locale, default: `en`
- `--currency`: price currency code, default: `USD`

Output example:
```json
{
  "id": "5476930",
  "url": "https://www.airbnb.com/rooms/5476930",
  "title": "Bright Studio in Notting Hill",
  "room_type": "ENTIRE_HOME",
  "description": "<p>Welcome to this charming studio...</p>",
  "photos": ["https://a0.muscache.com/im/pictures/...jpeg"],
  "lat": 51.5101,
  "lng": -0.1949,
  "city": "London, England, United Kingdom",
  "amenities": [
    {"name": "Kitchen", "available": true},
    {"name": "Wifi", "available": true}
  ],
  "house_rules": ["Check-in after 3:00 PM", "Checkout before 11:00 AM", "1 guest maximum"],
  "highlights": [
    {"title": "Self check-in", "subtitle": "Check yourself in with the keypad."}
  ],
  "rating_overall": 4.85,
  "review_count": 142,
  "ratings": [
    {"category": "CLEANLINESS", "value": "4.9"},
    {"category": "LOCATION", "value": "4.8"}
  ],
  "bedrooms": [
    {"title": "Bedroom 1", "subtitle": "1 king bed"}
  ]
}
```

Error handling: If `error: true` is returned with HTTP 4xx, verify the listing ID is valid by visiting `https://www.airbnb.com/rooms/{listing_id}` in the browser. If `No data in response` is returned, the listing may have been removed or the API schema may have changed — check the `raw` field for details.

## Pagination

Not applicable — each call returns complete detail for one listing.

## Success Criteria

`title is not null AND amenities.length >= 1 AND photos.length >= 1`

## Known Limitations

- `rating_overall` and `review_count` are null for new listings with no reviews
- `bedrooms` array may be empty for studio or hotel-style rooms
- Host personal details (bio, profile photo, response rate) are not available from this endpoint — they return as deferred sentinel sections
- Price per night is not included in the response without `--checkin` and `--checkout` dates
- Calling this endpoint too rapidly may trigger rate limiting; add 1-2 second delays between batch requests

## Execution Efficiency

- **Batch orchestration**: Write a bash script to loop through listing IDs serially with a 1-second delay between calls
- **Test before batch execution**: After writing a batch script, test with 1-2 listing IDs to verify output before running full batch
- **Error resumption**: Save results per listing ID; resume from the breakpoint on failure

## Experience Notes

Path: `{working-directory}/browser-act-skill-forge-memories/airbnb-scraper-airbnb-listing-detail.memory.md`

**Before execution**: If the file exists, read it first — it records unexpected situations encountered during past executions (e.g., a strategy has become ineffective); adjust strategy order accordingly.

**After execution**: If an unexpected situation is encountered (strategy became ineffective, page redesigned, anti-scraping upgraded, better path discovered), append a line:
`{YYYY-MM-DD}: {what happened} → {conclusion}`

Normal execution does not write to the file. Do not record what listing IDs were fetched or how many results were returned — those are task outputs, not experience.

## Dónde encaja

- Categoría: [Datos y analítica](https://skillsagentes.com/categorias/datos-analitica.md) — Consulta, limpia y visualiza datos sin salir del agente.
- Creador: [browser-act](https://skillsagentes.com/creators/browser-act.md) — 102 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Browser Act Skill Forge](https://skillsagentes.com/skills/browser-act/skills/browser-act-skill-forge.md): Forja paquetes Skill reutilizables (SKILL.md + scripts) a partir de la exploración de sitios web vía browser-act, evitando volver a explorar más tarde.
- [1688 Product Detail](https://skillsagentes.com/skills/browser-act/skills/1688-product-detail.md): Extrae datos completos de producto mayorista de páginas de detalle en 1688.com: título, precios por escalones, variantes SKU, imágenes, vendedor, puntuaciones de tienda, protección al comprador, atributos, cupones y estadísticas de reseñas.
- [Browser Act](https://skillsagentes.com/skills/browser-act/skills/browser-act.md): CLI de automatización de navegador para agentes de IA: nunca ejecutes comandos browser-act directamente vía Bash, invoca siempre este skill primero.
- [Ebay Sold Listings Search](https://skillsagentes.com/skills/browser-act/skills/ebay-sold-listings-search.md): Scraper de listados vendidos en eBay en 8 marketplaces (.com/.co.uk/.de/.fr/.it/.es/.ca/.com.au) con filtros de keyword, categoría, precio, condición, ubicación y orden, que devuelve ventas reales paginadas.
- [Threads Profile Search](https://skillsagentes.com/skills/browser-act/skills/threads-profile-search.md): Descubre cuentas de usuario de Threads por palabra clave, extrayendo datos de perfil como username, nombre visible, verificación, biografía y número de seguidores.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)