名称： event-planner
描述： 通过 Google Places API 搜索场所来规划活动（夜生活、周末、约会之夜、团队出游、用餐、旅行）。根据地点、预算、人数和偏好自动选择最佳餐厅、酒吧和活动。生成包含时间和 Google 地图链接的详细行程。适用于被要求规划出游、创建行程、寻找活动场所或组织活动时。
主页： https://github.com/clawdbot/clawdbot
元数据： {"clawdbot":{"emoji":"🎉","requires":{"bins":["uv"],"env":["GOOGLE_PLACES_API_KEY"]},"primaryEnv":"GOOGLE_PLACES_API_KEY","install":[{"id":"uv-brew","kind":"brew","formula":"uv","bins":["uv"],"label":"安装 uv (brew)"}]}}

活动规划器

通过搜索场所并生成带有 Google 地图链接的行程来规划活动。

快速开始

规划一次夜生活：

uv run {baseDir}/scripts/plan_event.py "night out" \
  --location "纽约时代广场" \
  --party-size 4 \
  --budget medium \
  --duration 4h

规划一个周末日：

uv run {baseDir}/scripts/plan_event.py "weekend day" \
  --location "纽约中央公园" \
  --party-size 2 \
  --budget "每人 100 美元" \
  --preferences "户外活动，休闲餐饮"

规划一个约会之夜：

uv run {baseDir}/scripts/plan_event.py "date night" \
  --location "纽约苏豪区" \
  --budget high \
  --duration 3h

活动类型

• 夜生活：晚餐 + 1-2 家酒吧/酒廊（3-4 小时）
• 周末日：早午餐/午餐 + 活动 + 晚餐（6-8 小时）
• 约会之夜：浪漫餐厅 + 甜品/饮品店（2-3 小时）
• 团队活动：团体活动 + 晚餐场所（3-5 小时）
• 午餐：单一餐厅推荐
• 晚餐：单一餐厅推荐
• 旅行：包含每日计划的多日行程

参数

• --location：城市、地址或地标（必需）
• --party-size：人数（默认：2）
• --budget："low/medium/high" 或 "每人 $X"（默认：medium）
• --duration：可用时长（例如："3h"、"full day"）
• --preferences：逗号分隔的偏好（例如："素食、户外座位、现场音乐"）
• --start-time：开始时间（默认：根据活动类型推断）
• --output：text|json（默认：text）
• --date：目标日期，格式为 YYYY-MM-DD，用于特定日期的检查（默认：今天）

输出格式

默认（文本）：包含时间线、场所详情、交通信息和 Google 地图链接的 Markdown 行程

JSON：包含所有场所详情、坐标和解析后元数据的结构化数据

限制

• API 限制：Google Places API 有使用配额（请检查您的账单）
• 实时数据：场所营业时间可能变更；前往前请务必确认
• 预算估算：基于 Google 的价格等级（0-4），非精确成本
• 行程时间：在可用时使用 Google Directions API；否则回退到基于距离的估算，并增加 30% 的缓冲时间
• 营业时间：未经验证营业时间的场所将显示警告；请勿假设其可用性
• 活动场所：文化中心、剧院和活动空间可能因预定活动而有不同的营业时间

API 要求

活动规划器使用：
- Google Places API (新版)：场所搜索所必需
- Google Directions API：可选但推荐，用于获取准确的行程时间

如果已在 Google Cloud Console 中启用，两个 API 可以使用相同的 GOOGLE_PLACES_API_KEY。

错误处理

• 无效位置 → 返回错误及建议
• 未找到场所 → 放宽过滤器并重试
• API 失败 → 使用指数退避策略重试（最多 3 次）