SuperAPI AI 工具集

pp-us-data

数据与分析

查看项目

更新于 10-16 01:32

技能介绍

用途:当智能体需要 BLS、Census 或 BEA 等官方美国经济与人口数据作为有来源的上下文时使用。该技能驱动 us-data-pp-cli 二进制,充当“配方优先”的封装,而非完整 API 镜像。

主要能力:CPI 快照(us-data-pp-cli cpi --agent),返回最新值、前值、计算出的百分比变化及时效性说明;全国失业率快照(us-data-pp-cli unemployment --agent),州或地方失业率需显式传入 BLS 系列 ID;人口设置或查询(us-data-pp-cli population --place "Austin, TX" --agent);区域对比(us-data-pp-cli compare-regions "Seattle, WA" "Austin, TX" --agent),用于准备代理可读的对比框架;来源检查(us-data-pp-cli sources --agent),在大简报前确认当前环境可用的数据源。

使用方式:先安装 CLI:npx -y @mvanhorn/printing-press-library install us-data --cli-only;用 us-data-pp-cli --version 验证,并确保 $GOPATH/bin 或 $HOME/go/bin 在 $PATH 中。若 npx 安装失败,可退回 Go 安装(需 Go 1.26.6 或更新):go install github.com/mvanhorn/printing-press-library/library/other/us-data/cmd/us-data-pp-cli@latest。BLS 的 CPI 与全国失业率命令默认无需凭证;Census 查询需 export US_DATA_CENSUS_API_KEY="...";BEA 查询需 export US_DATA_BEA_API_KEY="..."。缺少对应密钥时,命令会返回设置指引。--agent 启用紧凑 JSON,结果包含来源名称与注意事项。

适用场景:需要最新 CPI 或全国失业率、需要对受支持城市/州做人口查询、需要说明 Census/BEA 缺少哪种认证、或需要区域对比简报框架时。

限制:不用于预测、投资建议、法律建议或政策结论;不得将缺失数据视为事实不存在的证明;不能当作完整的 Census/BLS/BEA 端点镜像;未成功后跳过验证前不应继续执行技能命令。公开数据集有发布计划、版本与修订,结果会附时效性说明。