tripadvisor-cli

cli-web-tripadvisor

Search TripAdvisor for locations, hotels, restaurants, and attractions (read-only, no auth, DataDome bypass built in). Install: pip install cli-web-tripadvisor

Commands

Command	Purpose	Key options
locations search QUERY	Resolve destinations to geo_id	--max N (default 6)
hotels search LOCATION	Hotels in a destination	--geo-id ID, --page N
hotels get URL	Full hotel detail by TripAdvisor URL
restaurants search LOCATION	Restaurants in a destination	--geo-id ID, --page N
restaurants get URL	Full restaurant detail by URL
attractions search LOCATION	Things to do in a destination	--geo-id ID, --page N
attractions get URL	Full attraction detail by URL

Search commands take a destination name ("Paris") and resolve it to a geo_id automatically; pass --geo-id to skip that lookup (faster). Results are 30 per page. get commands take the url field from search results.

Examples

# Hotels in a city (returns name, rating, review_count, price_range, address, url per hotel)
cli-web-tripadvisor hotels search "Paris" --json

# Skip location lookup with a known geo_id, paginate
cli-web-tripadvisor restaurants search "Tokyo" --geo-id 298184 --page 2 --json

# Resolve a destination to geo_id first
cli-web-tripadvisor locations search "New York" --max 10 --json

# Things to do
cli-web-tripadvisor attractions search "London" --json

# Detail lookup from a search-result URL
cli-web-tripadvisor hotels get "https://www.tripadvisor.com/Hotel_Review-g187147-d229968-Reviews-..." --json

JSON output

Every command accepts --json. Success responses are keyed by resource, e.g. {"success": true, "location": "Paris", "geo_id": 187147, "count": 30, "hotels": [...]} (or "hotel", "restaurants", "attractions" accordingly). Errors return {"error": true, "code": "...", "message": "..."}.

Utilities

cli-web-tripadvisor doctor [--json] self-diagnoses the local setup (install, auth, dependencies). cli-web-tripadvisor mcp-serve serves the commands as MCP tools over stdio.