hongkong-restaurant-skill
Hong Kong restaurant lookup across the official FEHD licensed-restaurant list, OpenRice search and Foodpanda delivery listings. Use for restaurant licences, addresses, districts, cuisine search, ratings, opening status, delivery fees or nearby Foodpanda vendors. Keeta is not covered because it has no public consumer API.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/hongkong-ai-labs--hongkong-restaurant-skill)HTML
<a href="/listings/hongkong-ai-labs--hongkong-restaurant-skill"><img src="/api/listings/hongkong-ai-labs--hongkong-restaurant-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
**Agent skill** — installs `SKILL.md` and the binary bootstrap script:
npx skills add hongkong-ai-labs/hongkong-restaurant-skill npx skills update # refresh the installed skill later
**Prebuilt binary** — macOS (Intel or Apple silicon) and Linux (x86_64 or aarch64, static musl), checksum-verified, into `~/.local/bin`:
curl -fsSL https://raw.githubusercontent.com/hongkong-ai-labs/hongkong-restaurant-skill/main/scripts/install.sh | sh
**From source** — Rust 1.89 or newer:
git clone https://github.com/hongkong-ai-labs/hongkong-restaurant-skill cd hongkong-restaurant-skill cargo install --path . --locked # or directly from GitHub: cargo install --git https://github.com/hongkong-ai-labs/hongkong-restaurant-skill --locked # or: cargo build --release --locked # target/release/hkrestaurant
Verify:
$ hkrestaurant --version
`hkrestaurant update` detects whether the binary came from cargo, the release installer, a source checkout or Homebrew, and updates with that same method. `hkrestaurant update --check` only reports.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 170 lines · 1 finding marked
- ---
- name: hongkong-restaurant-skill
- description: Hong Kong restaurant lookup across the official FEHD licensed-restaurant list, OpenRice search and Foodpanda delivery listings. Use for restaurant licences, addresses, districts, cuisine search, ratings, opening status, delivery fees or nearby Foodpanda vendors. Keeta is not covered because it has no public consumer API.
- license: MIT
- ---
- # Hong Kong restaurants
- `hkrestaurant` is a Rust CLI and MCP server that combines three restaurant
- sources. It needs no API key. It is an independent, unofficial project.
- | Source | What it is | Status |
- | --- | --- | --- |
- | **FEHD** | Official list of every licensed General, Light Refreshment and Marine restaurant | stable open data |
- | **OpenRice** | Editorial search results from the OpenRice Hong Kong website | undocumented public endpoint |
- | **Foodpanda** | Vendors delivering near a coordinate | undocumented public endpoint |
- **Keeta is deliberately not supported.** Keeta has no public consumer search
- API. Its documented OpenAPI is merchant-only and needs credentials. This skill
- does not scrape the app or bypass that boundary. Say so if the user asks for
- Keeta data, and use the Keeta app instead.
- ## Before first use
- ```console
- $ bash scripts/ensure-binary.sh
- /Users/you/.local/bin/hkrestaurant
- ```
- ```bash
- BIN="$(bash scripts/ensure-binary.sh)"
- ```
- It checks `$HKRESTAURANT_BIN`, `hkrestaurant` on `PATH`,
- `scripts/install.sh`, then `cargo build --release --locked` in the repo root.
- ### Install the binary directly
- `npx skills add` installs the skill files. If the binary is missing, install it
- with the release installer or cargo:
- ```bash
- curl -fsSL https://raw.githubusercontent.com/hongkong-ai-labs/hongkong-restaurant-skill/main/scripts/install.sh | sh
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 43 on GitHub
- # or
- cargo install --git https://github.com/hongkong-ai-labs/hongkong-restaurant-skill --locked
- ```
- Register it with any MCP client:
- ```bash
- npx add-mcp "$(command -v hkrestaurant) mcp" --name hongkong-restaurant -a claude-code -a codex -a cursor -y
- claude mcp add hongkong-restaurant -- hkrestaurant mcp
- codex mcp add hongkong-restaurant -- hkrestaurant mcp
- ```
- `add-mcp` detects the client configuration files in the current project; add
- `-g` for a global install. `$(command -v hkrestaurant)` keeps the entry correct
- when the binary is on `PATH`; substitute an absolute path if your client does
- not inherit the shell `PATH`.
- ## CLI
- ```bash
- # Official licences (best for "is this restaurant licensed?" and addresses)
- $BIN licences --query "jade" --limit 5
- $BIN licences --district "Yau Tsim" --kind "General"
- $BIN licences --query "Causeway Bay" --json
- # OpenRice editorial search (best for cuisine / dish discovery)
- $BIN openrice sushi --limit 5
- $BIN openrice "dim sum" --json
- # Foodpanda nearby delivery (best for "what can deliver here?")
- $BIN foodpanda --lat 22.2793 --lng 114.1628
- $BIN foodpanda --lat 22.2793 --lng 114.1628 --query sushi
- $BIN foodpanda --lat 22.2793 --lng 114.1628 --limit 48 --json
- # What each source covers
- $BIN sources
- $BIN mcp
- $BIN update --check
- ```
- ### Trade-offs
- - **Licences** are authoritative for existence, name, address, district,
- licence type and expiry. They do not carry ratings, menus, opening hours or
- delivery.
- - **OpenRice** gives scores, review counts, price bands, categories and a
- current open/closed flag. It returns 15 results per page; `--limit` fetches
- more pages up to 150.
- - **Foodpanda** gives rating, minimum order, delivery fee, ETA and distance for
- vendors delivering to a coordinate. The public listing has no reliable
- keyword parameter, so `--query` filters the nearby list client-side. A query
- can therefore miss a restaurant that is further away.
- - A restaurant can appear in one source and not another. Absence from OpenRice
- or Foodpanda is not evidence that it is closed.
- ## JSON fields
- `licences` returns
- `{generation_date, count, restaurants:[{licence_no,name,address,district,licence_type,licence_type_code,expiry_date,info}]}`.
- `generation_date` is the day FEHD generated the list, not the time of your call.
- `openrice` returns an array of
- `{name,name_other_lang,address,address_other_lang,district,categories,score,review_count,price,open_now,url}`.
- `score` is OpenRice's 0-5 overall score, not a hygiene rating. `open_now` is
- the website's current flag.
- `foodpanda` returns an array of
- `{code,name,address,cuisines,rating,review_count,budget,minimum_order,delivery_fee,delivery_minutes,distance_km,url}`.
- Fees and minimum orders are in HKD and can change at checkout.
- ## MCP
- ```json
- {
- "mcpServers": {
- "hongkong-restaurant": {
- "command": "/absolute/path/to/hkrestaurant",
- "args": ["mcp"]
- }
- }
- }
- ```
- Tools:
- | Tool | Arguments |
- | --- | --- |
- | `search_restaurant_licences` | `{ query?, district?, type?, limit? }` |
- | `search_openrice` | `{ query, limit? }` |
- | `list_foodpanda_vendors` | `{ lat, lng, query?, limit? }` |
- | `list_restaurant_sources` | `{}` |
- ## Answering patterns
- - "Is X licensed?" → `licences --query X`; quote the licence number, type and
- expiry, and say if there is no match.
- - "Where is X?" → `licences --query X` for the official address, not a delivery
- platform's pin.
- - "Good sushi in Causeway Bay?" → `openrice sushi`, then filter the district in
- the results. Mention scores and review counts, and that they are OpenRice's.
- - "What can deliver to me?" → `foodpanda --lat ... --lng ...`; quote minimum
- order, fee and ETA together, since a cheap fee with a high minimum is not
- cheap.
- - "What about Keeta?" → explain that Keeta has no public consumer API and this
- skill does not scrape it.
- ## Cautions
- - OpenRice and Foodpanda endpoints are undocumented consumer endpoints. They
- can change, rate-limit, or require a browser session without notice. The
- skill sends a normal browser User-Agent and does not log in.
- - Do not bulk-harvest either platform. Use small `--limit` values and keep the
- cache on (5 minutes for OpenRice, 2 minutes for Foodpanda, 6 hours for FEHD).
- - Ratings are platform-specific and not comparable across OpenRice and
- Foodpanda.
- - Prices, fees, availability and opening status are a snapshot, not a quote.
- - FEHD licence data lists licensed premises, not a food-safety grade. A valid
- licence is not a hygiene rating.
- - Do not present this as an official FEHD, OpenRice, Foodpanda or Keeta
- channel. Follow each platform's terms when redistributing its data.
- ## Sources
- - FEHD: `https://www.fehd.gov.hk/english/licensing/license/text/LP_Restaurants_EN.XML`
- - OpenRice: `https://www.openrice.com/api/pois?...`
- - Foodpanda: `https://disco.deliveryhero.io/listing/api/v1/pandora/vendors?...`
- with `x-disco-client-id: web`
README.md · README · 196 lines · 1 finding marked
- # hkrestaurant
- Hong Kong restaurant lookup as a Rust CLI and MCP server.
- Three sources:
- - **FEHD** — official licensed-restaurant list (name, address, district,
- licence type and expiry)
- - **OpenRice** — editorial search with scores, reviews, price bands and open
- status
- - **Foodpanda** — nearby delivery vendors with minimum order, fee and ETA
- Keeta is **not** supported: it has no public consumer API, only a credentialed
- merchant API. This project does not scrape the app.
- ## Install
- **Agent skill** — installs `SKILL.md` and the binary bootstrap script:
- ```bash
- npx skills add hongkong-ai-labs/hongkong-restaurant-skill
- npx skills update # refresh the installed skill later
- ```
- **Prebuilt binary** — macOS (Intel or Apple silicon) and Linux (x86_64 or
- aarch64, static musl), checksum-verified, into `~/.local/bin`:
- ```bash
- curl -fsSL https://raw.githubusercontent.com/hongkong-ai-labs/hongkong-restaurant-skill/main/scripts/install.sh | sh
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 29 on GitHub
- ```
- **From source** — Rust 1.89 or newer:
- ```bash
- git clone https://github.com/hongkong-ai-labs/hongkong-restaurant-skill
- cd hongkong-restaurant-skill
- cargo install --path . --locked
- # or directly from GitHub:
- cargo install --git https://github.com/hongkong-ai-labs/hongkong-restaurant-skill --locked
- # or: cargo build --release --locked # target/release/hkrestaurant
- ```
- Verify:
- ```console
- $ hkrestaurant --version
- ```
- `hkrestaurant update` detects whether the binary came from cargo, the release
- installer, a source checkout or Homebrew, and updates with that same
- method. `hkrestaurant update --check` only reports.
- ## CLI
- ```bash
- hkrestaurant licences --query "jade" --limit 5
- hkrestaurant licences --district "Yau Tsim" --kind General
- hkrestaurant openrice sushi --limit 5
- hkrestaurant foodpanda --lat 22.2793 --lng 114.1628
- hkrestaurant foodpanda --lat 22.2793 --lng 114.1628 --query sushi
- hkrestaurant sources
- hkrestaurant mcp
- hkrestaurant update --check
- ```
- ## MCP
- ```json
- {
- "mcpServers": {
- "hongkong-restaurant": { "command": "hkrestaurant", "args": ["mcp"] }
- }
- }
- ```
- Register it with any MCP client:
- ```bash
- npx add-mcp "$(command -v hkrestaurant) mcp" --name hongkong-restaurant -a claude-code -a codex -a cursor -y
- claude mcp add hongkong-restaurant -- hkrestaurant mcp
- codex mcp add hongkong-restaurant -- hkrestaurant mcp
- ```
- `add-mcp` detects the client configuration files in the current project; add
- `-g` for a global install. `$(command -v hkrestaurant)` keeps the entry correct
- when the binary is on `PATH`; substitute an absolute path if your client does
- not inherit the shell `PATH`.
- Tools: `search_restaurant_licences`, `search_openrice`,
- `list_foodpanda_vendors`, `list_restaurant_sources`.
- ## Limits
- OpenRice and Foodpanda are undocumented public endpoints, not partner APIs.
- They can change or rate-limit without notice and remain subject to their terms.
- Foodpanda keyword filtering is client-side over the nearby list. FEHD licences
- do not include hygiene grades, menus or opening hours.
- ## Run modes and deployment
- | Mode | Start with | Use for |
- | --- | --- | --- |
- | CLI | `hkrestaurant <command>` | Interactive use and shell scripts |
- | JSON | `<command>` with `--json` | `jq`, automation, other programs |
- | MCP stdio | `hkrestaurant mcp` | Desktop and CLI MCP clients |
- | Container | `docker run --rm -i hkrestaurant mcp` | No local Rust toolchain |
- ### MCP and authentication
- This server is **stdio-only**: the client launches the process and speaks MCP
- over stdin/stdout. There is no listening port, so there is no network
- authentication layer and no API-key setting. Optional API keys in this project
- family apply only to servers that expose an HTTP transport. Keep the process
- local and let the MCP client manage it.
- Typical client entry:
- ```json
- {
- "mcpServers": {
- "hongkong-restaurant-skill": {
- "command": "hkrestaurant",
- "args": ["mcp"]
- }
- }
- }
- ```
- If the client does not inherit `PATH`, use the absolute installed path.
- ### Docker and Apple container
- ```bash
- docker build -t hkrestaurant .
- docker run --rm hkrestaurant --help
- docker run --rm -i hkrestaurant mcp # stdio MCP
- docker compose run --rm stdio # same, through Compose
- ```
- Apple's `container` runtime uses the same OCI image:
- ```bash
- container build -t hkrestaurant .
- container run --rm hkrestaurant --help
- container run --rm -i hkrestaurant mcp
- ```
- The runtime image contains the release binary and CA certificates, runs as a
- non-root user, and defaults to `--help` so a bare `docker run` is harmless.
- ### Cloudflare and WASM
- There is no Worker or WASM deployment. The binary talks directly to upstream
- HTTP APIs over TLS and uses a Tokio runtime; packaging it as a stdio server is
- the supported integration. A Worker would need a separate HTTP/JavaScript
- adapter and is out of scope for this repo.
- ### Releases
- Pushing a `v*` tag runs the release workflow, which checks the tag against
- `Cargo.toml` and `CHANGELOG.md`, builds four targets, smoke-tests native
- binaries and publishes:
- - `hkrestaurant-<tag>-<target>.tar.gz` for macOS and static Linux
- - `SHA256SUMS` covering every tarball
- `scripts/install.sh` downloads the latest release, verifies its checksum and
- falls back to `cargo build --release --locked` when no release is available.
- `just tag X.Y.Z` creates the annotated tag locally; `just release X.Y.Z` tags
- and pushes to trigger the workflow.
- ## Development
- ```bash
- just # fmt check, clippy with -D warnings, tests
- just skill-check # validate SKILL.md and shell syntax
- just container # build the image and print CLI help
- cargo test --all --locked
- cargo clippy --all-targets --locked -- -D warnings
- cargo fmt --all -- --check
- ```
- `rust-toolchain.toml` pins the stable toolchain with `rustfmt` and
- `clippy`, so `rustup` sets contributors up automatically. `just doc`
- builds the API documentation. See `CONTRIBUTING.md` for the full check
- list and the signed-commit requirement.
- CI runs the same checks. Dependabot proposes weekly Cargo and GitHub Actions
- updates, and the audit workflow checks the lockfile against the RustSec
- advisory database.
- ## Licence
- MIT. Data remains subject to FEHD, OpenRice and Foodpanda terms.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.