音乐剧演出信息搜索 Skill
musical-search
音乐剧演出信息搜索。查询音乐剧演出排期、卡司、剧院等信息。当用户问"某日有什么音乐剧"、"某剧什么时候演"、"某城市音乐剧排期"时使用。支持按日期、城市、剧目查询演出信息。
SKILL.md
Full skill instructions
音乐剧演出信息搜索 Skill
通过骚菊音乐剧数据库 API(https://y.saoju.net/yyj/api/)查询音乐剧演出信息。
使用场景
- 用户问"今天/明天/某日有什么音乐剧"
- 用户问"某城市最近有什么音乐剧"
- 用户问"某剧什么时候演、在哪演"
- 用户问"某剧的卡司/演员"
API 接口说明
1. 查询某日演出
https://y.saoju.net/yyj/api/search_day/?date={YYYY-MM-DD}
返回指定日期的全部演出列表。
示例:
curl -s "https://y.saoju.net/yyj/api/search_day/?date=2026-04-10"
返回字段:
date: 日期show_list: 演出列表city: 城市musical: 音乐剧名称theatre: 剧院time: 演出时间cast: 卡司信息(角色+演员)
2. 查询某日某城市演出
https://y.saoju.net/yyj/api/search_day/?date={YYYY-MM-DD}&city={城市名}
示例:
curl -s "https://y.saoju.net/yyj/api/search_day/?date=2026-04-10&city=上海"
3. 查询某剧在时间范围内的演出
https://y.saoju.net/yyj/api/search_musical_show/?musical={剧名}&begin_date={开始日期}&end_date={结束日期}
示例:
curl -s "https://y.saoju.net/yyj/api/search_musical_show/?musical=阿波罗尼亚&begin_date=2026-04-01&end_date=2026-04-30"
4. 获取全部音乐剧列表
https://y.saoju.net/yyj/api/musical/
返回所有音乐剧的基础信息。
5. 获取全部城市列表
https://y.saoju.net/yyj/api/city/
6. 获取全部剧院列表
https://y.saoju.net/yyj/api/theatre/
7. 获取全部演员列表
https://y.saoju.net/yyj/api/artist/
工作流程
场景一:用户问某日演出
用户:"明天有什么音乐剧?" 用户:"4月15日上海有什么音乐剧?"
步骤:
- 解析日期(支持"今天"、"明天"、"后天"等相对日期)
- 构造 API URL
- 调用 API 获取数据
- 格式化输出结果
# 获取明天日期
DATE=$(date -v+1d +%Y-%m-%d)
# 调用 API
curl -s "https://y.saoju.net/yyj/api/search_day/?date=$DATE"
场景二:用户问某剧演出排期
用户:"阿波罗尼亚最近在哪演?" 用户:"粉丝来什么时候有票?"
步骤:
- 解析剧名
- 确定查询时间范围(默认未来30天)
- 调用 API
- 输出排期列表
curl -s "https://y.saoju.net/yyj/api/search_musical_show/?musical=阿波罗尼亚&begin_date=2026-04-09&end_date=2026-05-09"
场景三:用户问某城市演出
用户:"深圳最近有什么音乐剧?"
步骤:
- 获取未来7天的日期范围
- 逐日查询该城市演出
- 汇总输出
输出格式
演出列表输出模板
🎭 {日期} 音乐剧演出信息
📍 {城市}
🎬 **{音乐剧名称}**
🏛️ {剧院}
⏰ {时间}
👥 卡司:
• {角色}: {演员}
• {角色}: {演员}
---
注意事项
- API 不需要认证,直接调用即可
- 城市名使用中文,如"上海"、"北京"、"深圳"
- 剧名需要准确匹配,可以先调用
/api/musical/获取完整列表 - 日期格式必须为
YYYY-MM-DD - 时间可能包含时区信息,注意转换
错误处理
- 如果 API 返回空列表,说明当天没有演出
- 如果剧名不存在,提示用户检查剧名
- 如果网络错误,重试一次
示例命令
查询今天的演出
TODAY=$(date +%Y-%m-%d)
curl -s "https://y.saoju.net/yyj/api/search_day/?date=$TODAY" | python3 -m json.tool
查询本周上海演出
TODAY=$(date +%Y-%m-%d)
WEEK=$(date -v+7d +%Y-%m-%d)
curl -s "https://y.saoju.net/yyj/api/search_day/?date=$TODAY&city=上海"
搜索某剧
curl -s "https://y.saoju.net/yyj/api/search_musical_show/?musical=粉丝来&begin_date=2026-04-09&end_date=2026-04-30"
