权威韩影票房数据一站式查询

基于韩国电影振兴委员会官方数据，聚合三大院线实时票房与待映影片信息，为影迷提供权威、精准的韩影资讯查询服务。

基本信息

• 技能名称?k-cinema-bridge
• 中文名称?权威韩影票房数据一站式查询
• 作者?uyeong
• 分类?内容创作
• 版本?v0.1.1
• 标签?content-media, api, data-analytics, entertainment

使用方法

使用说明
核心用法
k-cinema-bridge 是一款专注于韩国电影市场的数据查询技能，通过统一的 JSON API 接口，整合 Lotte Cinema、CGV、Megabox 三大连锁院线的票房排行与即将上映影片数据，并叠加 KOBIS（韩国电影振兴委员会）官方提供的详细影片信息。用户可通过自然语言询问当前热映电影、票房排名、即将上映新片，或按导演、演员、类型、分级等维度进行筛选查询。API 设计简洁，所有端点均为 GET 请求，无需认证即可访问，数据每日 UTC 00:00 自动刷新。
显著优点
数据权威性高 ：直接对接 KOBIS 官方数据库，影片的导演、演员、类型、时长、制作国家等信息均来自韩国电影振兴委员会，避免网络爬虫数据的不准确性。 多源聚合能力 ：同时覆盖韩国三大院线，支持跨平台票房对比，可识别同一影片在不同院线的排名差异，提供更全面的市场视角。 零门槛使用 ：无需 API Key，无需注册，GitHub Pages 托管保证高可用性与访问稳定性。 响应结构清晰 ：完整的数据模型定义，包含影片基础信息、海报 URL、分级标识及可空的详细元数据，便于开发者解析与展示。 多语言适配 ：技能内置语言响应机制，可根据用户提问语言自动切换输出语种。
潜在缺点与局限性
数据时效性受限 ：每日仅刷新一次，对于票房波动剧烈的首映周末，数据可能存在 24 小时延迟。 信息字段不完整 ： info 字段可能为 null ，部分新片或小众影片缺少导演、演员等详细信息，需调用方做好空值处理。 地域局限性 ：仅覆盖韩国本土院线市场，无法查询其他国家/地区的上映信息或全球票房数据。 功能边界明确 ：纯数据查询技能，不支持购票、选座、影院定位等交易类或 LBS 功能。 依赖外部服务稳定性 ：数据源托管于 GitHub Pages，若遇 GitHub 服务波动或 KOBIS 接口变更，可能影响数据获取。
适合的目标群体
韩影爱好者与影迷 ：希望及时了解韩国本土票房动态、追踪心仪导演或演员新作的用户。 影视行业研究者 ：需要韩国电影市场数据进行分析的学者、记者、市场分析师。 内容创作者与博主 ：撰写韩影推荐、票房解读、新片前瞻等内容的自媒体运营者。 旅行社与地接服务 ：为赴韩游客提供当地观影建议的行程规划人员。 多语言 AI 应用开发者 ：需要集成权威韩影数据源以丰富对话能力的 Agent 构建者。
使用风险
网络依赖风险 ：所有数据实时拉取，若用户网络环境受限或 GitHub Pages 访问不畅，将导致查询失败。 数据解析风险 ： info 字段的可空性要求调用方必须实现健壮的 null-check 逻辑，否则可能引发运行时错误。 API 变更风险 ：当前版本为 0.1.1，若作者后续调整端点路径或响应结构，可能造成兼容性问题。 分级信息误读风险 ：韩国电影分级制度（전체 관람가/12세/15세/청소년 관람불가）与其他国家存在差异，面向国际用户时需附加说明避免误解。 无缓存机制 ：高频调用可能触发 GitHub Pages 的速率限制，建议在实际应用中实现客户端缓存策略。