jlm-coffee

# Jerusalem Coffee Finder Search specialty coffee shops in Jerusalem - ratings, amenities, opening hours, reviews, and locations from [coffee.amsterdamski.com](https://coffee.amsterdamski.com), created and curated by [Shaul Amsterdamski](https://x.com/amsterdamski2) ([@amsterdamski2](https://x.com/amsterdamski2)). > Data from the official public JSON export provided by the site maintainer. May not reflect current status. Provided "as is" without warranty of any kind. ## Quick Start ```bash # List all coffee shops python3 {baseDir}/scripts/jlm-coffee.py list # Find a shop by name python3 {baseDir}/scripts/jlm-coffee.py search "סיבריס" ``` ## Commands | Command | Description | |---------|-------------| | `list` | List all approved specialty coffee shops | | `search <query>` | Search shops by name (Hebrew or English) | | `get <id_or_name>` | Get full details for a specific shop | | `filter <amenity>` | Filter shops by amenity (wifi, dogs, kosher, etc.) | | `open-now` | Show shops currently open | | `amenities` | List all available amenity filters | | `surprise` | Pick a random coffee shop (prefers open ones) | ## Search and Filter Examples ```bash # Search by name (Hebrew or English) python3 {baseDir}/scripts/jlm-coffee.py search "רוסטרס" python3 {baseDir}/scripts/jlm-coffee.py search "Cafe Pepa" # Filter by amenity python3 {baseDir}/scripts/jlm-coffee.py filter wifi python3 {baseDir}/scripts/jlm-coffee.py filter dogs python3 {baseDir}/scripts/jlm-coffee.py filter kosher python3 {baseDir}/scripts/jlm-coffee.py filter laptop # Shops open right now python3 {baseDir}/scripts/jlm-coffee.py open-now # Full details for a shop python3 {baseDir}/scripts/jlm-coffee.py get "בארוק" python3 {baseDir}/scripts/jlm-coffee.py get EljFiggwObssQpypWMf0 ``` ## Options Reference | Option | Commands | Description | |--------|----------|-------------| | `--json` | all | Output in JSON format (agent-friendly) | | `--no-color` | all | Disable colored output (auto-detected for non-TTY) | ## Amenity Filters | Key | Label | Aliases | |-----|-------|---------| | `wifi` | WiFi | | | `dogs` | Dog-friendly | dog, dog-friendly | | `laptop` | Laptop-friendly | laptops | | `outdoor` | Outdoor seating | outside, terrace | | `accessible` | Wheelchair accessible | wheelchair | | `vegan` | Vegan options | | | `kids` | Kid-friendly | children, kid-friendly | | `quiet` | Quiet atmosphere | | | `smoking` | Smoking area | | | `local-roasting` | Local roasting | roasting | | `sell-beans` | Sells beans | beans | | `filter-coffee` | Filter coffee | filter | | `kosher` | Kosher | | | `open-saturday` | Open Saturday | saturday, shabbat | | `power` | Power outlets | outlets | | `parking` | Parking | | ## Workflow Example ```bash # 1. Find shops with WiFi and look at the list python3 {baseDir}/scripts/jlm-coffee.py filter wifi # 2. Get details on one that looks good python3 {baseDir}/scripts/jlm-coffee.py get "מטאפורה" # 3. Check what's open right now python3 {baseDir}/scripts/jlm-coffee.py open-now # 4. Feeling lucky? Get a random pick python3 {baseDir}/scripts/jlm-coffee.py surprise ``` ## Notes - **Community-curated**: All specialty coffee in Jerusalem, community-reviewed - **Official data source**: Reads from a public JSON export provided by the site maintainer (no API key, no Firestore) - **Bilingual**: Search works with Hebrew and English names - **Opening hours**: Based on Google Places data, cached by the site - **Reviews included**: Shop details show community reviews with ratings - **Color output**: ANSI colors in terminal (respects `NO_COLOR` env var and `--no-color` flag) - **CLI shortcut**: Install as `jlm-coffee` via symlink to the wrapper script - **No dependencies**: Python stdlib only (urllib, json) - **Fast caching**: 15-minute local cache TTL - one fetch covers all commands