SuperAPI AI 工具集

coverage-check

智能体与模型

查看项目

更新于 10-16 09:35

技能介绍

用途:在核查某个说法是否被多方证实、且看似有大量搜索结果支持时,用来判断这些结果究竟来自多个独立新闻机构,还是同一篇通稿、通讯社稿件或研究的反复转载。搜索结果在两种情况下看起来相同,该工具用于区分。

主要能力:查询 GDELT 获取匹配文章,合并重复 URL(跟踪参数、www.、结尾斜杠等),按标题相似度将文章聚类为“不同故事簇”作为来源数量估计;标出 24 小时内同一故事被多家媒体发布的转载簇,以及标题中带有通讯社或新闻稿分发商(如 Reuters、AP、PR Newswire)的线索;给出时间跨度以判断是短时爆发(可能源于新闻稿或解禁)还是持续数周的独立报道。结果可输出 JSON 并作为报告证据栏中的来源计数。

使用方式:uv run scripts/coverage.py "<query>" [--timespan 3m] [--max 250] [--sort dateasc] [--timeout 120] [--json]。查询支持 GDELT 运算符,如 "exact phrase"、(a OR b)、-exclude、domain:example.com、sourcelang:english;引用说法中独特的措辞有助于捕捉转载。运行较慢属正常,缩小 --timespan 是提速手段,不要过早判定卡死而应先提高 --timeout。无需 API 密钥或认证。

适用场景:核查某说法是否被多家独立媒体证实、识别通稿或通讯社稿件的广泛转载。

限制:仅覆盖 GDELT DOC 2.0 的滚动 3 个月窗口,更早的说法会返回空,而空不等于未被报道;无结果不可当作反证。聚类基于标题相似度,无法识别用完全不同措辞独立得出同一结论的两家媒体,这类会显示为不同簇(保守方向)。单次查询上限 250 条,达到上限时所有计数只是下界,应缩小时间范围。免费端点不可靠,可能在没有达到频率限制时返回限流,脚本退避重试后以退出码 3 结束;退出码 3 表示“未测量”而非“无覆盖”,不得据此加强或削弱结论,也不得记为搜索为空。覆盖广泛不等于可信,判定仍需来源层级规则。该工具不抓取文章正文,也不做任何判断。