BLS
美国劳工统计局（BLS）发布美国官方的消费者价格和生产者价格、就业、失业、收入和生产率数据。通过 ScholarMuse，agent 可以用 find_series 从一份全国主要序列的短清单里挑选，也可以用 get_series 按 BLS 序列编号取任意序列，例如失业率的编号是 LNS14000000。
对应的 ScholarMuse 工具：find_series、get_series。每次成功调用都会扣积分。
可以这样问你的 agent
你的 agent 会拿到什么
每条记录都带有 id、source、title、url、license、attribution 和 retrievedAt。下面是来自 BLS 的数据字段。
find_series
搜索的是连接器内置的 17 条美国全国序列，而不是整个 BLS 数据库。查询里提到美国以外的国家时，会跳过 BLS。
- seriesId
- 如 bls:LNS14000000
- title
- 内置清单中的序列标题
- frequency
- 月度或季度
- units
- 单位，如 Index 1982-84=100 或 Percent
- geography
- 固定为 United States
get_series
不在内置清单里的序列，标题只是序列编号，也没有 units 和 geography。
- seriesId
- 实际取回的 BLS 序列编号
- title
- 序列标题（仅限清单内的序列）
- units
- 单位（仅限清单内的序列）
- frequency
- 月度、季度或年度
- geography
- United States（仅限清单内的序列）
- start
- 返回的首个时期
- end
- 返回的最后时期
- count
- 返回的观测值个数
- observations
- 时期与数值组成的列表
覆盖范围
- find_series 内置 17 条美国主要序列，包括 CPI-U 全部项目（CUUR0000SA0）、核心 CPI、PPI 最终需求（WPUFD4）、失业率（LNS14000000）、U-6、非农就业人数（CES0000000001）、平均时薪、JOLTS 职位空缺、生产率和就业成本指数。
- get_series 接受任意 BLS 序列编号，所以只要你已经知道编号，州、都会区或行业层面的序列也能取。
- 可读取月度、季度、半年度和年度时期。内置序列都是月度的，只有生产率和就业成本指数是季度的。
限制
- 无法对 BLS 做关键词搜索。17 条内置序列之外的数据必须用准确的序列编号来取。
- 不指定 start 时，一次调用返回最近 10 年（有 key 时为 20 年）。一次调用最多回溯三个这样的时间窗口，即 30 年或 60 年；更早的数据请用 start 和 end 指定。
- BLS 在月度和季度序列里附带的年度平均值行不会返回。
- 每次调用只取一条序列，没有国家参数：数据只针对美国。
ScholarMuse 怎么访问 BLS
连接器直接向 BLS Public Data API 的 timeseries 接口发送 POST 请求。ScholarMuse 配置了注册 key 时使用 v2，没有 key 时使用 v1。find_series 不会请求 BLS，因为 BLS 没有搜索接口。
响应最多缓存 12 小时，当天上午刚发布的数字可能要这么久才会出现。
API key：上游 API 不用 key 也能调用，你不用申请。
许可与署名
许可：Public domain (US Government work)
Source: US Bureau of Labor Statistics (bls.gov). BLS.gov cannot vouch for the data or analyses derived from these data after retrieval.
来自 BLS 的记录都带这段许可和署名。 在论文里引用时，请按 BLS 自己的引用要求来写。
