核心用法
jisu-tv 是一个基于极速数据(Jisu Data)电视节目预告 API 的 OpenClaw 技能,提供两个核心功能:获取全国电视频道列表(/tv/channel)和查询指定频道某日的详细节目单(/tv/query)。用户通过命令行调用 Python 脚本,传入频道 ID 和日期参数即可获取结构化数据。
显著优点:
- 数据源权威:对接极速数据商业 API,覆盖央视、卫视及地方频道,节目信息更新及时
- 结构化输出:返回 JSON 格式数据,便于程序解析和二次处理
- 双模式设计:频道列表功能帮助用户发现可用频道,查询功能支持精确到日的节目检索
- 灵活查询:支持历史日期回溯(如示例中的 2015 年数据),便于回顾或数据积累
潜在缺点与局限性:
- 依赖外部服务:完全依赖极速数据 API 的可用性与数据质量,若 API 故障或调整则技能失效
- 地域覆盖限制:主要覆盖中国大陆电视频道,港澳台及海外频道支持有限
- 实时性延迟:节目单数据可能存在更新延迟,突发节目变更无法实时同步
- 需要 API Key:商业 API 需注册申请,存在调用次数限制(免费额度有限)和过期风险
- 无智能推荐:仅提供原始数据,需用户自行筛选时段、类型,无「今晚热门综艺」等智能分析
适合人群:
- 需要批量获取电视节目数据的开发者或数据分析师
- 习惯提前规划观看内容的传统电视观众
- 构建家庭媒体中心、EPG(电子节目指南)系统的技术用户
- 需要节目单数据用于内容研究、舆情分析的媒体从业者
常规风险:
- API 密钥泄露:
JISU_API_KEY需妥善保管,硬编码或日志泄露可能导致额度被盗用 - 调用频率超限:免费/付费套餐均有次数限制,高频调用可能触发 104/106 错误码
- IP 封禁风险:106(IP 请求超过限制)、105(IP 被禁止)等错误可能影响服务连续性
- 数据准确性:201-203 类错误提示频道为空或信息缺失,需做好异常处理
- 服务终止风险:108 接口已停用、107 维护中等状态提示第三方服务依赖的固有不稳定性