Free Booking.com API (MCP Server) 🏨

The only free, real-time Booking.com scraper for AI Agents, Claude, and Python.

⭐️ Star this repo if you want to skip the API fees.

This tool uses a headless browser (Playwright) to scrape Booking.com search results in real-time, bypassing the need for expensive commercial APIs. It outputs clean JSON for LLMs.

🚀 Features

• Real-time Pricing: Scrapes live data from Booking.com.

• No API Keys: Runs locally using headless Chrome.

• AI-Native: Returns structured JSON optimized for Agents.

• MCP Compatible: Works natively with Claude Desktop.

Related MCP server: 1Stay Hotel Booking

📦 Installation

1. Clone the repo:

   git clone https://github.com/Anmoldureha/hotels-skill.git
   cd hotels-skill

2. Set up Python environment:

   python3 -m venv venv
   source venv/bin/activate
   pip install playwright
   playwright install chromium

🛠️ Usage

Run the script directly:

# python booking.py LOCATION CHECKIN CHECKOUT ADULTS
python booking.py "Bangkok" 2026-03-15 2026-03-22 2

Output:

{
  "hotels": [
    {
      "title": "Hilton Sukhumvit Bangkok",
      "price": "₹ 110,363",
      "rating": "8.5",
      "link": "https://www.booking.com/..."
    }
  ]
}

🤖 Agent Integration (MCP)

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "hotels": {
      "command": "/absolute/path/to/hotels-skill/venv/bin/python3",
      "args": ["/absolute/path/to/hotels-skill/mcp_server.py"]
    }
  }
}

⚠️ Note

This uses web scraping. Booking.com may change their DOM structure or block IPs if abused. Use responsibly (add delays between requests).