Agoda Hotel Agent

Overview

AI-powered hotel research assistant that analyzes Agoda listings to find your perfect stay. A team of specialized agents evaluates locations, amenities, reviews, and value propositions to create comprehensive accommodation guides.

Features

Smart Hotel Search — City-based discovery with flexible date ranges, room configuration, and advanced filters (star rating, price, amenities, traveler type)

Comprehensive Analysis — Location, rooms, value, quality ratings, facilities, and guest type suitability

Visual Content — Hotel property photos, room imagery, facility showcases

Expert Insights — Location advantages, room selections, value analysis, booking strategies

Travel Tips — Check-in optimization, extra charges, upgrade opportunities, loyalty benefits

Architecture

Multi-agent system with specialized roles:

Scraper Agent — Hotel listing discovery, property details extraction, photo collection

Relevance Agent — Criteria matching, amenity verification, price validation

Analyzer Agent — Detailed property analysis, review sentiment, value assessment

Aggregator Agent — Guide organization, category sorting, comparative analysis

Tech Stack

Python 3.11+ with Poetry

crewAI — Agent orchestration

crawl4ai — Web crawling

langchain + langchain-openai — LLM integration

beautifulsoup4 — HTML parsing

Pillow — Image processing

Usage

bash

# Install
git clone https://github.com/jiaweing/agoda-agent.git
poetry install

# Configure
cp .env.example .env

# Run
python src/main.py

Select city (Singapore, Bangkok, Tokyo, Seoul, Hong Kong), enter stay details and preferences to generate categorized hotel guides (Luxury, Upscale, Mid-range, Budget, Special picks).