核心用法
jisu-tv 是一款基于极速数据(JisuAPI)电视节目预告服务的 OpenClaw 技能,封装了两项核心能力:
1. 频道列表查询(channel):返回全量电视频道元数据,包括 tvid(频道 ID)、name(频道名)、parentid(上级分类)、istv(是否为电视频道)。
2. 节目单检索(query):需传入 tvid 与 date(YYYY-MM-DD),返回该频道指定日期的完整节目排期,含节目名称与开始时间。
脚本通过 Python 3 执行,依赖 JISU_API_KEY 环境变量进行身份鉴权,请求极速数据官方 REST API。
---
显著优点
- 数据覆盖广:支持央视、卫视及特色频道(如"中国美食"),频道列表可动态拉取,便于扩展。
- 查询粒度细:精确到分钟级节目开始时间,可针对特定日期回溯或预告,适合日程规划。
- 集成友好:返回结构化 JSON,易于在对话系统中二次加工(如按时段筛选、自然语言生成)。
潜在缺点与局限性
- 商业化依赖:必须注册极速数据账号并申请 API KEY,超出免费额度后需付费,成本随查询量线性增长。
- 地域与版权限制:部分地方台或网络频道可能缺失;节目单信息受版权方提供时效影响,偶有延迟或缺档。
- 无实时播放状态:仅提供"预告"数据,无法确认节目是否准时开播或临时调整。
- 单点故障风险:服务完全依赖第三方 JisuAPI,若官方接口维护、限速或关停,技能即时失效。
适合人群
- 需要批量查询电视排期的媒体工作者、内容运营。
- 希望自然语言交互获取节目信息的智能家居/助手用户。
- 开发电视节目提醒、EPG(电子节目指南)应用的开发者。
常规风险
- API KEY 泄露:
JISU_API_KEY以环境变量注入,若日志打印、配置不当可能导致密钥外泄,引发额度盗刷或账号封禁。 - 频率限制:官方文档明确存在请求次数限制(错误码 104/106),高频调用需实现缓存与退避策略。
- 数据时效性:历史日期节目单可查询,但越远期的准确性越低;未来节目单可能因编排调整而与实际播出不符。
- 服务连续性:技能未提供降级方案或备用数据源,建议生产环境做可用性监控。