TV Program Preview - 电视节目预告

核心用法

本技能基于极速数据（Jisu Data）电视节目预告 API，提供两大核心功能：

1. 频道列表获取（/tv/channel）：返回全部可用电视频道，包含 tvid、name、parentid、istv 字段，便于用户查找目标频道 ID。

2. 节目单查询（/tv/query）：通过 tvid + 日期参数，获取指定频道当日完整节目单，包含节目名称与开始时间。

显著优点

• 数据覆盖广：支持全国主流卫视、央视及地方频道
• 使用门槛低：仅需配置 JISU_API_KEY 环境变量即可调用
• 场景适配强：可回答"今晚有什么综艺""明天某频道晚间节目"等自然语言查询
• 结构化输出：JSON 格式便于程序化处理与时间筛选

潜在局限

• 数据时效性：依赖第三方 API 更新频率，可能存在节目临时调整未同步的情况
• 地域限制：部分地方频道覆盖不全
• 历史数据：通常仅支持近期日期查询，远期节目单可能为空
• 认证门槛：需单独申请 API Key，非完全零配置

适合人群

• 电视观众：想提前规划观看时间
• 内容运营：需要抓取节目单做数据分析
• 智能家居开发者：集成语音查询电视节目功能

常规风险

• API 配额限制：免费额度用尽后需付费或受限
• IP/频率限制：高频调用可能触发 104/106 错误码
• 密钥泄露：JISU_API_KEY 需妥善保管，避免硬编码

核心用法

jisu-tv 是一款面向日常娱乐场景的实用技能，通过调用极速数据官方电视节目预告 API，为用户提供两大核心功能：频道列表获取与指定频道某日节目单查询。使用时需先通过 channel 指令拉取全量频道信息（含 tvid、频道名称、上级分类等），再基于目标频道的 tvid 和日期参数调用 query 指令，即可返回结构化节目数据，包括节目名称、开始时间等关键信息。典型应用场景包括：查询"今晚 CCTV-3 有什么节目"、"湖南卫视本周晚间综艺安排"或"获取所有可用频道及 ID"等自然语言需求。

显著优点

数据权威可靠：依托极速数据（jisuapi.com）多年运营的商业数据服务，覆盖央视、卫视及地方频道，数据源稳定更新；接口简洁高效：仅需 tvid 和 date 两个必填参数，返回格式清晰易解析，便于 Agent 进行二次加工和自然语言生成；使用成本可控：标准 API 调用模式，无复杂依赖，仅需 Python3 和 requests 库即可运行；安全合规：敏感信息通过环境变量 JISU_API_KEY 管理，无硬编码密钥风险，HTTPS 加密传输保障通信安全。

潜在缺点与局限性

外部服务依赖：核心功能完全依赖极速数据 API，存在服务可用性、响应延迟及接口变更风险，若服务商维护或限流将直接影响技能功能；数据时效边界：电视节目单通常按日更新，当日临时编排变更可能无法实时同步；地域覆盖限制：主要聚焦中国大陆电视频道，海外频道支持有限；无内置缓存机制：每次查询均触发 API 请求，高频使用可能快速消耗调用配额；错误处理较基础：当前仅返回原始 API 错误信息，缺乏更友好的用户提示和自动降级方案。

适合的目标群体

家庭娱乐用户：需要快速了解当晚或近期电视节目安排，避免频繁切换遥控器翻阅；内容创作者/媒体人：追踪特定频道节目编排，分析时段竞争格局；智能家居/语音助手开发者：集成到语音交互场景，实现"今天有什么好看的"等自然语言查询；老年关怀场景：简化电视收看决策流程，降低数字设备使用门槛。

使用风险说明

API 配额与成本：极速数据 API 通常按调用次数计费，高频场景需关注用量控制和预算规划；服务连续性风险：作为第三方依赖服务，建议生产环境配置备用数据源或降级提示；网络稳定性：API 调用受网络环境影响，已设置 10 秒超时但无自动重试，弱网环境可能体验不佳；密钥管理责任：用户需自行妥善保管 JISU_API_KEY，避免环境变量泄露导致配额被盗用；数据准确性兜底：电视编排偶有临时调整，关键节目建议二次确认官方渠道信息。