🏠 Airbnb Search Assistant
- agent-framework
About
What is 🏠 Airbnb Search Assistant?
🏠 Airbnb Search Assistant is a Streamlit-based chatbot application that uses AI to help users find Airbnb properties worldwide. It runs in a web browser and is designed for travelers seeking personalized accommodation recommendations.
How to use 🏠 Airbnb Search Assistant?
Install Python 3.10+, Node.js, and an OpenAI API key. Clone the repository, install dependencies with pip, install the @openbnb/mcp-server-airbnb globally, and set your OPENAI_API_KEY in a .env file. Run the application with python chatbot.py and open the provided localhost URL. Then enter queries like “Find me a beachfront villa in Bali for 4 people.”
Key features of 🏠 Airbnb Search Assistant
- Airbnb-inspired UI with custom styling
- AI-powered property search and recommendations
- Worldwide property search with amenity filters
- Interactive chat interface for natural language queries
- Automatic fallback to basic chat if MCP fails
- Responsive design for all devices
Use cases of 🏠 Airbnb Search Assistant
- Finding beachfront villas for groups in Bali
- Discovering luxury apartments with landmark views in Paris
- Locating pet-friendly houses with gardens in London
- Filtering properties by amenities like beachfront, luxury, or pet-friendly
FAQ from 🏠 Airbnb Search Assistant
What platforms and models does 🏠 Airbnb Search Assistant support?
It requires Python 3.10+, Node.js, and an OpenAI API key. The AI model used is GPT-4o-mini.
Does the assistant work without an MCP server?
Yes, it has an automatic fallback to basic chat mode if the MCP connection fails.
Can I search for properties worldwide?
Yes, the assistant supports worldwide property search and can filter by amenities and preferences.
What license does this project use?
It is licensed under the MIT License.
What are the prerequisites to run the application?
You need Python 3.10+,
Details
- Author
- akktrsst
- GitHub stars
- 3
- Category
- agent-framework
- Repository
- akktrsst/mcp_agent_airbnb
🏠 Airbnb Search Assistant
A Gradio-based chatbot application that helps users find their perfect accommodation using AI-powered search capabilities. The assistant can search for properties worldwide, filter by amenities, and provide personalized recommendations.
✨ Features
- 🎨 Beautiful, Airbnb-inspired UI with custom styling
- 🔍 AI-powered property search and recommendations
- 🌍 Worldwide property search capabilities
- 🏡 Filter by amenities and preferences
- 💬 Interactive chat interface
- 🔄 Automatic fallback to basic chat mode if MCP connection fails
- 📱 Responsive design for all devices
🚀 Getting Started
Prerequisites
- Python 3.10 or higher
- Node.js (for MCP server)
- OpenAI API key
Installation
1. Clone the repository:
git clone git@github.com:akktrsst/MCP_Agent_Airbnb.git
2. Install Python dependencies:
pip install -r requirements.txt
3. Install MCP server:
npm install -g @openbnb/mcp-server-airbnb
4. Create a .env file in the examples directory with your API keys:
OPENAI_API_KEY=your_openai_api_key
Running the Application
1. Start the Streamlit app:
python chatbot.py
2. Open your browser and navigate to:
http://localhost:XXXX
💡 Usage
1. Enter your search query in the chat input, for example:
- "Find me a beachfront villa in Bali for 4 people"
- "Show luxury apartments in Paris with Eiffel Tower views"
- "Search for pet-friendly houses in London with a garden"
2. The assistant will provide detailed responses about properties, including:
- Amenities
- Location benefits
- Pricing information
- Reviews and ratings
3. Use the "Clear Chat" button to start a new conversation
🛠️ Technical Details
Architecture
- Frontend: Streamlit
- Backend: Python with LangChain
- AI Model: GPT-4o-mini
- MCP Integration: Airbnb MCP Server
Key Components
- chatbot.py: Main application file
- airbnb_mcp.json: MCP server configuration
- Custom CSS styling for Airbnb-like interface
- Error handling and fallback mechanisms
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
📝 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
- Special thanks to openbnb-org/mcp-server-airbnb for the MCP server
- OpenAI for the GPT models
- Gradio for the web framework
📞 Support
For support, please open an issue in the repository or contact the maintainers.
---
Made with ❤️ by [Abhishek Kumar]
