airbnb-listing-detail

Name: airbnb-listing-detail
Author: browser-act

4.6kstars220forks

How to install airbnb-listing-detail?

browser-act/skills/airbnb-listing-detail

$npx -y skills add browser-act/skills --skill airbnb-listing-detail

Installs into the current project.

Summary

Fetches complete Airbnb listing details for a given numeric listing ID via the internal GraphQL API, returning title, room type, description, amenities, photos, coordinates, city, house rules, highlights, ratings, review count, bedroom configuration, and property overview. Use wh

Files · 1

View on GitHub

SKILL.md

1	# Airbnb — Listing Detail
2
3	> Listing ID → full property detail via internal GraphQL API (no login required)
4
5	## Language
6
7	All process output to user (progress updates, process notifications) follows the user's language.
8
9	## Objective
10
11	Fetch comprehensive listing data for an Airbnb property using the internal StaysPdpSections GraphQL API.
12
13	## Prerequisites
14
15	- Browser is open (any page). The API call is made via `fetch()` in the browser context — no specific page navigation required.
16	- No login required — the API endpoint is publicly accessible
17
18	## Pre-execution Checks
19
20	### 1. Tool Readiness
21
22	If browser-act has been confirmed available in the current session → skip this step.
23
24	Invoke `browser-act` via Skill tool to load usage. If installation or configuration issues arise, follow its guidance to resolve then retry.
25
26	## Capability Components
27
28	> 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.
29
30	### API: fetch listing detail
31
32	`eval "$(python scripts/listing-detail.py '{listing_id}')"`
33
34	Parameters:
35	- `listing_id`: numeric Airbnb listing ID (e.g., `5476930`). Extract from listing URL: `airbnb.com/rooms/{listing_id}`
36	- `--checkin`: check-in date in YYYY-MM-DD format, default: none (price info unavailable without dates)
37	- `--checkout`: check-out date in YYYY-MM-DD format, default: none
38	- `--adults`: number of adult guests, default: `1`
39	- `--locale`: response locale, default: `en`
40	- `--currency`: price currency code, default: `USD`
41
42	Output example:
43	```json
44	{
45	"id": "5476930",
46	"url": "https://www.airbnb.com/rooms/5476930",
47	"title": "Bright Studio in Notting Hill",
48	"room_type": "ENTIRE_HOME",
49	"description": "<p>Welcome to this charming studio...</p>",
50	"photos": ["https://a0.muscache.com/im/pictures/...jpeg"],
51	"lat": 51.5101,
52	"lng": -0.1949,
53	"city": "London, England, United Kingdom",
54	"amenities": [
55	{"name": "Kitchen", "available": true},
56	{"name": "Wifi", "available": true}
57	],
58	"house_rules": ["Check-in after 3:00 PM", "Checkout before 11:00 AM", "1 guest maximum"],
59	"highlights": [
60	{"title": "Self check-in", "subtitle": "Check yourself in with the keypad."}
61	],
62	"rating_overall": 4.85,
63	"review_count": 142,
64	"ratings": [
65	{"category": "CLEANLINESS", "value": "4.9"},
66	{"category": "LOCATION", "value": "4.8"}
67	],
68	"bedrooms": [
69	{"title": "Bedroom 1", "subtitle": "1 king bed"}
70	]
71	}
72	```
73
74	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.
75
76	## Pagination
77
78	Not applicable — each call returns complete detail for one listing.
79
80	## Success Criteria
81
82	`title is not null AND amenities.length >= 1 AND photos.length >= 1`
83
84	## Known Limitations
85
86	- `rating_overall` and `review_count` are null for new listings with no reviews
87	- `bedrooms` array may be empty for studio or hotel-style rooms
88	- Host personal details (bio, profile photo, response rate) are not available from this endpoint — they return as deferred sentinel sections
89	- Price per night is not included in the response without `--checkin` and `--checkout` dates
90	- Calling this endpoint too rapidly may trigger rate limiting; add 1-2 second delays between batch requests
91
92	## Execution Efficiency
93
94	- Batch orchestration: Write a bash script to loop through listing IDs serially with a 1-second delay between calls
95	- Test before batch execution: After writing a batch script, test with 1-2 listing IDs to verify output before running full batch
96	- Error resumption: Save results per listing ID; resume from the breakpoint on failure
97
98	## Experience Notes
99
100	Path: `{working-directory}/browser-act-skill-forge-memories/airbnb-scraper-airbnb-listing-detail.memory.md`
101
102	Before execution: If the file exists, read it first — it records unexpected situations encountered during past executions (e.g

People who liked this also viewed

6 picks

Type

airbnb-listing-detail

4.6kstars220forks

View on GitHub

How to install airbnb-listing-detail?

browser-act/skills/airbnb-listing-detail

$npx -y skills add browser-act/skills --skill airbnb-listing-detail

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Airbnb — Listing Detail
2
3	> Listing ID → full property detail via internal GraphQL API (no login required)
4
5	## Language
6
7	All process output to user (progress updates, process notifications) follows the user's language.
8
9	## Objective
10
11	Fetch comprehensive listing data for an Airbnb property using the internal StaysPdpSections GraphQL API.
12
13	## Prerequisites
14
15	- Browser is open (any page). The API call is made via `fetch()` in the browser context — no specific page navigation required.
16	- No login required — the API endpoint is publicly accessible
17
18	## Pre-execution Checks
19
20	### 1. Tool Readiness
21
22	If browser-act has been confirmed available in the current session → skip this step.
23
24	Invoke `browser-act` via Skill tool to load usage. If installation or configuration issues arise, follow its guidance to resolve then retry.
25
26	## Capability Components
27
28	> 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.
29
30	### API: fetch listing detail
31
32	`eval "$(python scripts/listing-detail.py '{listing_id}')"`
33
34	Parameters:
35	- `listing_id`: numeric Airbnb listing ID (e.g., `5476930`). Extract from listing URL: `airbnb.com/rooms/{listing_id}`
36	- `--checkin`: check-in date in YYYY-MM-DD format, default: none (price info unavailable without dates)
37	- `--checkout`: check-out date in YYYY-MM-DD format, default: none
38	- `--adults`: number of adult guests, default: `1`
39	- `--locale`: response locale, default: `en`
40	- `--currency`: price currency code, default: `USD`
41
42	Output example:
43	```json
44	{
45	"id": "5476930",
46	"url": "https://www.airbnb.com/rooms/5476930",
47	"title": "Bright Studio in Notting Hill",
48	"room_type": "ENTIRE_HOME",
49	"description": "<p>Welcome to this charming studio...</p>",
50	"photos": ["https://a0.muscache.com/im/pictures/...jpeg"],
51	"lat": 51.5101,
52	"lng": -0.1949,
53	"city": "London, England, United Kingdom",
54	"amenities": [
55	{"name": "Kitchen", "available": true},
56	{"name": "Wifi", "available": true}
57	],
58	"house_rules": ["Check-in after 3:00 PM", "Checkout before 11:00 AM", "1 guest maximum"],
59	"highlights": [
60	{"title": "Self check-in", "subtitle": "Check yourself in with the keypad."}
61	],
62	"rating_overall": 4.85,
63	"review_count": 142,
64	"ratings": [
65	{"category": "CLEANLINESS", "value": "4.9"},
66	{"category": "LOCATION", "value": "4.8"}
67	],
68	"bedrooms": [
69	{"title": "Bedroom 1", "subtitle": "1 king bed"}
70	]
71	}
72	```
73
74	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.
75
76	## Pagination
77
78	Not applicable — each call returns complete detail for one listing.
79
80	## Success Criteria
81
82	`title is not null AND amenities.length >= 1 AND photos.length >= 1`
83
84	## Known Limitations
85
86	- `rating_overall` and `review_count` are null for new listings with no reviews
87	- `bedrooms` array may be empty for studio or hotel-style rooms
88	- Host personal details (bio, profile photo, response rate) are not available from this endpoint — they return as deferred sentinel sections
89	- Price per night is not included in the response without `--checkin` and `--checkout` dates
90	- Calling this endpoint too rapidly may trigger rate limiting; add 1-2 second delays between batch requests
91
92	## Execution Efficiency
93
94	- Batch orchestration: Write a bash script to loop through listing IDs serially with a 1-second delay between calls
95	- Test before batch execution: After writing a batch script, test with 1-2 listing IDs to verify output before running full batch
96	- Error resumption: Save results per listing ID; resume from the breakpoint on failure
97
98	## Experience Notes
99
100	Path: `{working-directory}/browser-act-skill-forge-memories/airbnb-scraper-airbnb-listing-detail.memory.md`
101
102	Before execution: If the file exists, read it first — it records unexpected situations encountered during past executions (e.g

People who liked this also viewed

6 picks

Type