SuperAPI AI 工具集

cia-data-integration

数据与分析

查看项目

更新于 10-15 22:11

技能介绍

用途:该技能面向 riksdagsmonitor 项目,提供消费 CIA(Citizen Intelligence Agency)平台 JSON 导出的专业知识,包括数据校验、缓存策略与数据管道集成,并强调 CIA 是唯一数据源,不得修改其预计算数据。

主要能力:从 CIA 平台获取 19 个可视化产品;处理限流与连接失败,实现指数退避重试与熔断模式;使用 CIA 提供的 JSON Schema 进行校验(示例使用 Ajv);按 current、archive、metadata 目录组织缓存并记录版本与时间戳;监控数据新鲜度,超过 24 小时告警并回退到缓存数据;记录所有数据操作以便审计。

使用方式:通过 CIAExportClient 类调用 fetchExport(productName),请求 https://www.hack23.com/cia/api/export/{productName}.json,设置 30 秒超时,随后校验 Schema 并按版本缓存。可配合 GitHub Actions 定时任务(cron '0 2 * * ')运行 scripts/fetch-cia-exports.js 与 scripts/validate-cia-data.js,数据变化时提交到仓库。该技能被 .github/workflows/news-.md 中的 11 个智能体新闻工作流消费,权威契约位于 .github/prompts/README.md。

适用场景:实现 CIA 导出获取流程、校验 CIA JSON 数据、设计缓存策略、构建数据消费管道、监控数据新鲜度、优雅处理 API 失败。

限制:资料未提供 CIA 平台的具体 API 认证方式、速率限制数值、Schema 细节及错误码;未说明收费、价格或平台支持范围。使用前需遵循 Hack23 安全开发政策,并确保不修改 CIA 预计算情报。