Movie Finder Skill

功能概述

• 搜索电影：按类型（科幻、喜剧、恐怖等）、年份、评分筛选
• 支持中英文关键词
• 展示电影海报、评分、简介、时长、导演、演员、类型标签
• 生成可播放的 HTML 页面，内嵌 iframe 播放器，支持多播放源页内切换
• 支持多结果列表，用户选择后生成播放页

安装说明见同目录 INSTALL.md。

触发词

意图解析

识别参数

意图分类

1. 搜索播放："想看[类型]"、"[电影名]在线看"、"watch [movie] online" → 搜索元数据 + 生成播放页
2. 筛选列表："2024年科幻片"、"恐怖片推荐" → 返回列表，用户选一个再生成播放页
3. 仅搜索："这部电影讲什么" → 只查元数据，不生成播放页

类型映射表

搜索策略

第一步：元数据搜索（TMDB API 优先）

TMDB（The Movie Database）提供完整的电影元数据。优先用 API 获取：

搜索电影（按片名/关键词）：

GET https://api.themoviedb.org/3/search/movie?api_key={KEY}&query={keyword}&language=zh-CN&page=1

按类型 + 年份发现电影：

GET https://api.themoviedb.org/3/discover/movie
  ?api_key={KEY}
  &language=zh-CN
  &sort_by=popularity.desc        # 或 vote_average.desc 按评分
  &with_genres={genre_id}         # 见类型映射表
  &primary_release_year={year}    # 可选
  &vote_average.gte={rating}      # 可选，评分筛选
  &page=1

获取电影详情（含导演、演员、时长）：

GET https://api.themoviedb.org/3/movie/{movie_id}?api_key={KEY}&language=zh-CN&append_to_response=credits

关键字段：

• id → TMDB ID（播放源需要）
• imdb_id → IMDb ID（部分播放源需要）
• title / release_date / vote_average / runtime / overview
• poster_path → 海报 URL：https://image.tmdb.org/t/p/w500{poster_path}
• genres[].name → 类型
• credits.crew 中 job=Director → 导演
• credits.cast[].name → 主演（取前 3-5 位）

API Key：TMDB API 需要 key。若环境中无可用 key，降级到 web_search。

第一步（降级）：web_search 搜索元数据

无 API key 时，用 web_search 获取电影信息：

• 按片名：{movie_name} 电影 简介 评分 年份
• 按类型 + 年份：{year}年 {genre} 电影 推荐 豆瓣 / best {genre} movies {year}
• 按类型 + 评分：豆瓣 {genre} 高分电影 / top rated {genre} movies
• 获取 IMDb ID：{movie_name} site:imdb.com
• 获取 TMDB ID：{movie_name} site:themoviedb.org

从搜索结果中提取：片名、年份、评分、简介、海报图 URL、IMDb ID（格式 ttd{7,8}）、TMDB ID。

第二步：构造播放源

拿到 IMDb ID 或 TMDB ID 后，按以下格式构造嵌入播放源 URL（无需额外 API）：

用 IMDb ID 优先（兼容性最好）。至少构造 2-3 个源，方便用户在播放页切换。

第三步：降级处理

• 若既无 TMDB API key、web_search 也未获取到 IMDb/TMDB ID：
  • web_search 搜索：{movie_name} watch online free embed
  • 从结果中直接提取可用的 embed URL
• 若所有方式均未找到播放源：返回电影信息 + 建议在 YouTube 等平台搜索

播放页生成

使用脚本 scripts/generate_movie_page.py 生成播放页（推荐），或直接用 HTML 模板。

方式一：脚本生成（推荐）

python scripts/generate_movie_page.py 
  --title "盗梦空间" 
  --year "2010" 
  --rating "8.8" 
  --plot "一个窃取梦境秘密的盗贼接到一项相反的任务..." 
  --poster "https://image.tmdb.org/t/p/w500/9gk7adHYeDvHkCSEqAvQNLV5Uge.jpg" 
  --runtime "148" 
  --director "克里斯托弗·诺兰" 
  --cast "莱昂纳多·迪卡普里奥, 约瑟夫·高登-莱维特" 
  --genres "科幻,动作,悬疑" 
  --sources '[{"name":"vidsrc","url":"https://vidsrc.net/embed/movie/tt1375666"},{"name":"2embed","url":"https://www.2embed.cc/embed/tt1375666"}]' 
  --output movie_inception.html

脚本特性：

• 用占位符替换（非 f-string）生成 HTML，CSS 花括号无需转义
• 多播放源页内切换（点击按钮在主播放器切换，无需跳转）
• 加载动画 + 8 秒超时兜底
• 海报加载失败时显示内置占位图（不依赖外部 placeholder 服务）
• HTML 转义防注入
• 响应式布局（移动端适配）
• 合规声明

方式二：直接写 HTML

如果无法调用脚本，直接将以下模板写入 movie_{hash}.html，替换 __占位符__：

  

    

    

      
__TITLE__
      

        __YEAR__
        ★ __RATING__
        ⏱ __RUNTIME__ 分钟
        🎬 __DIRECTOR__
      
      
__GENRE_TAGS__
      
__PLOT__
      
主演：__CAST__
    
  
  

    
  
  

    源1
    源2
  
  
播放源来自第三方，仅供学习交流，请支持正版

输出格式

1. 搜索结果列表（多条结果时）

🎬 找到以下电影：

1. 《{title}》({year}) ★{rating}
   {plot_short}

2. 《{title}》({year}) ★{rating}
   {plot_short}

...

请回复数字选择要播放的电影，或告诉我其他需求。

2. 直接播放（单条结果或用户选择后）

• 调用脚本或直接生成 HTML，写入 movie_{hash}.html
• 用 present_files 呈现给用户，告知可在浏览器中打开观看
• 文件输出到当前工作目录

3. 无播放源（找到信息但无可用源）

找到《{title}》({year})，但暂未找到可用播放源。

📖 电影信息：
- 评分：{rating}
- 类型：{genres}
- 简介：{plot}

💡 建议：可尝试在 YouTube 搜索 "{title} full movie"，或在正规流媒体平台观看。

注意事项

• TMDB ID vs IMDb ID：播放源常用 IMDb ID（tt 开头），部分支持 TMDB ID。搜索元数据时优先获取这两个 ID
• 封面图：优先用 TMDB 图片 https://image.tmdb.org/t/p/w500{poster_path}
• 年份 "最新"：优先搜索当年电影，TMDB 按 primary_release_date.desc 或 popularity.desc 排序
• 评分筛选：TMDB discover 接口加 vote_average.gte 参数；web_search 时搜 "高分/豆瓣评分"
• 播放源失效：第三方播放源域名会变动，若构造的 URL 无法播放，用 web_search 重新搜索当前可用源：{movie_name} watch online embed {imdb_id}
• 合规提示：播放页底部已内置"播放源来自第三方，仅供学习交流，请支持正版"声明。推荐正版渠道时优先提及 YouTube、各大流媒体平台
• 网络问题：播放源加载慢时耐心等待（播放页有加载动画 + 8 秒超时兜底），或切换备用源