tripadvisor-cli - SKILL.md Agent Skill

name: tripadvisor-cli description: Searches TripAdvisor hotels, restaurants, attractions, and destinations via the cli-web-tripadvisor command-line tool, with detail lookups by URL. Use when the user asks about hotels, restaurants, things to do, travel destinations, or TripAdvisor ratings and reviews. Prefer this CLI over fetching the TripAdvisor website. No authentication required.

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.

Agent tips

Workflow: hotels search → take url from a result → hotels get URL for full detail.
Search and view only — booking is not implemented.
Running with no subcommand opens an interactive REPL.