SuperAPI AI 工具集

broadcast-coverage-comparison

数据与分析

查看项目

更新于 10-15 20:29

技能介绍

用途:比较某话题在 GDELT 索引的电视素材中如何被不同电视台/节目呈现。查询前需确定电视台与节目、话题词、匹配频道、日期窗口和比较指标;该数据描述的是索引化覆盖,而非公众舆论或已验证的受众触达。

用法与鉴权:将 CRAWLORA_API_KEY 设为 Crawlora 密钥;已连接时优先使用所列 Crawlora MCP 工具,否则用捆绑的 scripts/crawlora.sh,它向 https://api.crawlora.net/api/v1 发送 x-api-key。具体方法与参数见 reference/endpoints.md。除 HTTP 状态外还要检查应用代码,载荷位于 data 内;遇鉴权错误应停止,遇 429 应退避,上游瞬时故障可重试一次。按请求范围与额度预算限制调用和分页,并分别保留来源 ID、URL、来源日期与观测/抓取时间。

发现与建查询:用电视台详情发现允许的台代码及其可用窗口,确认真实频道/时间覆盖,而非假定所有声明的台档案或处理新鲜度一致;公开 TV 索引结果可能滞后于播出,近期缺失可能是处理延迟。人工字幕、机器语音转文本、屏幕 OCR 文字、抽取概念与计算机视觉标签应分开处理;概念 MID/视觉值从其目录发现,视觉/概念标签是机器/索引信号,不是已验证的存在、身份、情感或背书。为所比较的台建立匹配查询台账:同一频道内重复正向词按 OR 处理,排除需满足缺失;仅有台/排除的查询无效,需提供正向内容字段;短语音/OCR 词有文档所述五词上限;不要添加假设的自由文本查询字段。相对时间跨度与绝对 from/to 窗口二选一,不可同时使用。

示例命令: scripts/crawlora.sh /gdelt/tv-stationdetails scripts/crawlora.sh /gdelt/tv-stationchart station=CNN station=MSNBC caption="climate change" timespan=7d scripts/crawlora.sh /gdelt/tv-timeline station=CNN caption="climate change" timespan=7d

指标与核验:station-chart 计数为原始匹配数;show-chart 计数为匹配结果的百分比;timeline 值描述匹配播出时长/量,按其返回指标解读。应保留单位和分母,不把三者都当作计数或可比的份额。时间线分辨率由窗口自动选择,没有 TV smooth 参数;应比较实际时间戳分箱,并将不可用时段标注为不可用,而非补零。用带时间戳与来源链接的有界片段/搜索样本核对框架、误配或重复片段;一次播出内多次匹配不等同于独立观众、不同故事或独立报道。引用要简短并注明捕获的语音/文字来源,OCR/ASR 输出不是已验证转写。没有独立来源提供的兼容分母,不要计算总播出时长份额或跨台受众份额。

输出与限制:返回查询/覆盖台账、按指标区分的比较表/时间线、抽样素材、处理与覆盖缺口,以及有依据的框架观察。更多索引覆盖不能证明信念、背书、偏见、流行度或对受众的因果影响;不要因一次性比较请求去安排跟踪或联系电视台。