Jlm Coffee

Search Jerusalem specialty coffee shops by name, amenities, ratings, and opening hours. Use when user asks about "coffee in Jerusalem", "Jerusalem cafe", "בי...

Security Scan

This skill is internally consistent: a small Python CLI that fetches a public JSON export, caches it locally, and exposes search/filter commands — it does not request credentials or perform unexpected actions.

Purpose & Capability

The name/description (Jerusalem coffee finder) aligns with the included files and behavior. The script fetches a public JSON export, parses shop records, and implements list/search/filter/open-now commands as described. Required binary (python3) and OS restrictions are appropriate.

Instruction Scope

SKILL.md instructs the agent to run the provided CLI with specific commands; the instructions are limited to searching/filtering/reading the public data source and formatting output. There are no instructions to read unrelated files, env vars, or send data to unexpected endpoints.

Install Mechanism

No install spec; the skill is instruction-only plus a single Python script. No downloads or archive extraction are performed. This is the lowest-risk installation model and matches the declared 'no dependencies'.

Credentials

The skill requests no environment variables, no credentials, and no config paths. It only performs outbound HTTPS GET to a Google Docs export URL (public) and uses the system temp directory for a best-effort cache, which is proportionate to its purpose.

Persistence & Privilege

always is false and the skill does not modify other skills or system-wide settings. It writes a transient cache under the OS temp directory only (CACHE_DIR in tempfile.gettempdir()), which is expected and limited in scope.

Assessment

This skill fetches a public JSON export from a Google Docs URL and caches it under your system temp directory; it does not ask for credentials or install additional software. If you trust the data source (coffee.amsterdamski.com / the Google Doc owner), using the skill is reasonable. If you have concerns: inspect the DOC_ID URL in a browser to verify the data, run the script in an isolated environment, or review the upstream GitHub repo linked in SKILL.md before enabling. Also note the script makes outbound HTTPS requests (network access) and stores a cache file in /tmp (or your platform's temp dir).

Jerusalem Coffee Finder

Search specialty coffee shops in Jerusalem - ratings, amenities, opening hours, reviews, and locations from coffee.amsterdamski.com, created and curated by Shaul Amsterdamski (@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

# 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

# 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

# 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