用途：借助 GDELT 项目自身的公开索引，检索并绘制全球新闻与美国电视新闻的报道情况，适合 OSINT、媒体监测、政治与社会科学研究等需要免费、免认证全球新闻/电视语料的场景。
主要能力：网页新闻方面提供 /gdelt/search（全文搜索，支持国家、域名、语言、时间范围、排序、最大记录数）、/gdelt/context（句子级共现搜索，仅覆盖最近 72 小时）、/gdelt/timeline（报道量或语气随时间变化）、/gdelt/tonechart（情感直方图）。美国电视（GDELT Television 2.0 AI）方面提供 /gdelt/tv-search（按电视台搜索转录、字幕、OCR 文字与计算机视觉标签，支持节目、排除项、星期过滤）、/gdelt/tv-timeline、/gdelt/tv-showchart、/gdelt/tv-stationchart、/gdelt/tv-wordcloud（需 station 与 channel），以及 /gdelt/tv-stationdetails、/gdelt/tv-concept-entities、/gdelt/tv-visual-entities 等参考列表。
使用方式：先在 https://crawlora.net 获取免费 Crawlora API 密钥（每月 2000 积分，无需信用卡），将 CRAWLORA_API_KEY 写入环境变量，再通过 scripts/crawlora.sh 调用，例如 scripts/crawlora.sh /gdelt/search query="semiconductor export controls" | jq '.'。请求发往 https://api.crawlora.net/api/v1，密钥缺失或无效返回 401。完整端点与参数见 reference/endpoints.md。
限制：仅使用 GDELT 公开索引，无上游认证；按成功计费，仅 2xx 计费；/gdelt/context 仅覆盖最近 72 小时；每个电视端点都要求 station，tv-wordcloud 还要求 channel；timespan 与 from/to 不可混用，只能选其一；密钥只应保存在 CRAWLORA_API_KEY 中，切勿硬编码、放入查询参数或提交到仓库。