---
title: "美食神仙籤筒 API 與 MCP"
canonical: https://food.penguindriver.com/api
markdown: https://food.penguindriver.com/api.md
retrieved: 2026-10-01
language: zh-Hant-TW
content_sha256: 626556b22400904f0fe8353d43ec6213b6f224bc42edb89024697c9c6fe0970a
cite: https://food.penguindriver.com/cite?path=%2Fapi
sources:
  - https://pay.penguindriver.com/pass
  - https://www.openstreetmap.org/copyright
  - https://overpass-api.de/
  - https://www.google.com/maps
  - https://www.ubereats.com/tw
---

# 美食神仙籤筒 API 與 MCP

今天吃什麼的美食抽籤 API（繁體中文，JSON，CORS 開放）。每分鐘免費額度用完後可用 x402（Base 或 Solana 上的 USDC）付費，或購買通行證：https://pay.penguindriver.com/pass

## 端點

- GET https://food.penguindriver.com/api/draw?deity=mazu&meal=lunch&category=auto&budget=300&people=2&lat=25.0418&lon=121.5435 — 抽籤（籤詩、料理、附近店家）
- GET https://food.penguindriver.com/api/nearby?lat=&lon=&category=ramen&radius=1500 — 附近符合種類、營業中的店家（依距離）
- GET https://food.penguindriver.com/api/categories?meal=dinner&budget=500&people=2 — 美食種類與價格帶
- GET https://food.penguindriver.com/api/deities — 10 位神明與美食風格
- GET https://food.penguindriver.com/api/meals — 五個餐別
- GET https://food.penguindriver.com/api/ads — 贊助店家（工商）
- 付費：GET https://food.penguindriver.com/api/pro/week-plan?deity=guangong&meals=lunch,dinner&budget=200&days=7 — 1～14 天菜單規劃（0.01 USDC）
- 付費：GET https://food.penguindriver.com/api/pro/pack — 整站離線資料包

## MCP

POST https://food.penguindriver.com/mcp（JSON-RPC 2.0，Streamable HTTP）

工具：draw_food_fortune、find_nearby_restaurants、list_food_categories、list_deities

## 資料來源與授權

- [OpenStreetMap 開放街圖（店家位置、營業時間；ODbL 授權）](https://www.openstreetmap.org/copyright)
- [Overpass API（開放街圖查詢服務）](https://overpass-api.de/)
- [Google 地圖（評分與路線請以 Google 地圖為準）](https://www.google.com/maps)
- [Uber Eats 臺灣（外送與店家菜單請以 Uber Eats 為準）](https://www.ubereats.com/tw)

店家資料 © OpenStreetMap 貢獻者，依 ODbL 授權；使用時請標示。