airbnb-listing-details-scraper-api-skill

This skill helps users run the Airbnb Listing Details Scraper BrowserAct template and extract structured public data. Use this skill when users ask to collect airbnb listing details scraper data, scrape airbnb listing details scraper results, monitor public records from this source, export structure

Airbnb Listing Details Scraper Automation Skill

📖 Brief

This skill uses BrowserAct's Airbnb Listing Details Scraper API template to extract structured public data. It starts the official workflow template, waits for completion, and prints the returned result so the Agent can use the data for research, monitoring, reporting, or downstream automation.

✨ Features

1. No hallucinations, ensuring stable and accurate data extraction: Pre-set workflows avoid AI generative hallucinations, ensuring stable and precise data extraction.
2. No CAPTCHA issues: No need to handle reCAPTCHA or other verification challenges.
3. No IP restrictions or geo-blocking: No need to handle regional IP restrictions or geofencing.
4. Faster execution: Tasks execute faster compared to pure AI-driven browser automation solutions.
5. Extremely high cost-efficiency: Significantly lowers data acquisition costs compared to high-token-consuming AI solutions.

🔑 API Key Guide

Before running, check the BROWSERACT_API_KEY environment variable. If not set, do not take other measures; ask and wait for the user to provide it. Agent must inform the user:

"Since you haven't configured the BrowserAct API Key yet, please go to the BrowserAct Console to get your Key."

🛠️ Input Parameters

Agent should configure the following parameters based on user requirements:

1. Listing ID or URL
   • Type: string
   • Description: Public Airbnb listing ID or full listing URL.
   • Example: 5476930
   • Default: 5476930
2. Check In
   • Type: string
   • Description: Optional arrival date used for dated pricing.
   • Example: empty
3. Check Out
   • Type: string
   • Description: Optional departure date used for dated pricing.
   • Example: empty
4. Adults
   • Type: number
   • Description: Adult guest count used for availability and pricing.
   • Example: 1
   • Default: 1
5. Currency
   • Type: string
   • Description: Preferred currency for price output when supported.
   • Example: USD
   • Default: USD

🚀 Invocation Method

Agent should run the standalone script from this skill directory:

bash

python -u ./scripts/airbnb_listing_details_scraper_api.py "5476930" "empty" "empty" "1" "USD"

⏳ Running Status Monitoring

Since this task involves automated browser operations, it may take several minutes. The script continuously outputs timestamped status logs such as [14:30:05] Task Status: running. Agent guidelines:

• Keep monitoring terminal output while waiting for the script result.
• As long as new status logs appear, the task is running normally; do not mistake it for a deadlock or unresponsiveness.
• Only if the status remains unchanged for a long time or the script stops outputting without returning a result should you consider the retry mechanism.

📊 Data Output

After successful execution, the script retrieves and prints the BrowserAct API response. The returned data may include these fields:

• listing_id: Extracted listing id value when available.
• listing_url: Extracted listing url value when available.
• title: Extracted title value when available.
• room_type: Extracted room type value when available.
• property_type: Extracted property type value when available.
• person_capacity: Extracted person capacity value when available.
• location: Extracted location value when available.
• overall_rating: Extracted overall rating value when available.
• review_count: Extracted review count value when available.
• photo_urls: Extracted photo urls value when available.
• amenities: Extracted amenities value when available.

Ground conclusions in the extracted data and handle missing fields gracefully.

⚠️ Error Handling & Retry

If an error occurs during script execution such as network fluctuations or task failure, the Agent should follow this logic:

1. Check Output Content:

   • If the output contains "Invalid authorization", it means the API Key is invalid or expired. Do not retry; guide the user to re-check and provide the correct API Key.
   • If the output contains "concurrent" or "too many running tasks" or similar concurrency limit messages, it means the current subscription plan's concurrent task limit has been reached. Do not retry; guide the user to upgrade their plan. Agent must inform the user:

     "The current task cannot be executed because your BrowserAct account has reached the limit of concurrent tasks. Please go to the BrowserAct Plan Upgrade Page to upgrade your subscription plan and enjoy more concurrent task benefits."

   • If the output does not contain the above error keywords but the task failed such as output starts with Error: or returns empty results, the Agent should automatically try to re-execute the script once.

2. Retry Limit:

   • Automatic retry is limited to one time. If the second attempt fails, stop retrying and report the specific error information to the user.

🌟 Typical Use Cases

1. Market research: Collect structured public records for quick analysis.
2. Competitive monitoring: Compare public products, listings, reviews, prices, or availability.
3. Dataset enrichment: Add clean fields to spreadsheets, CRMs, or BI workflows.
4. Lead generation: Identify relevant entities and URLs for downstream outreach.
5. Review analysis: Collect ratings and text signals where the template exposes review fields.
6. Pricing checks: Track current prices, total prices, or availability where supported.
7. Content research: Extract public text, metadata, or search results for editorial workflows.
8. Trend discovery: Find ranked or recent records around a destination, keyword, category, or source.
9. Operational reporting: Produce repeatable JSON output for scheduled reports.
10. API automation: Use BrowserAct workflow results as an input to other applications.