data-analyst-mcp 0.0.0-stage → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (640) hide show
  1. package/README.md +262 -3
  2. package/dist/adapters/_acf_tidy.d.ts +18 -0
  3. package/dist/adapters/_acf_tidy.js +432 -0
  4. package/dist/adapters/_acf_tidy.js.map +1 -0
  5. package/dist/adapters/_actuaries_read.d.ts +38 -0
  6. package/dist/adapters/_actuaries_read.js +728 -0
  7. package/dist/adapters/_actuaries_read.js.map +1 -0
  8. package/dist/adapters/_census_micro.d.ts +70 -0
  9. package/dist/adapters/_census_micro.js +622 -0
  10. package/dist/adapters/_census_micro.js.map +1 -0
  11. package/dist/adapters/_census_util.d.ts +40 -0
  12. package/dist/adapters/_census_util.js +275 -0
  13. package/dist/adapters/_census_util.js.map +1 -0
  14. package/dist/adapters/_dol_states.d.ts +6 -0
  15. package/dist/adapters/_dol_states.js +58 -0
  16. package/dist/adapters/_dol_states.js.map +1 -0
  17. package/dist/adapters/_govinfo_entities.d.ts +4 -0
  18. package/dist/adapters/_govinfo_entities.js +6 -0
  19. package/dist/adapters/_govinfo_entities.js.map +1 -0
  20. package/dist/adapters/_govinfo_json.d.ts +13 -0
  21. package/dist/adapters/_govinfo_json.js +107 -0
  22. package/dist/adapters/_govinfo_json.js.map +1 -0
  23. package/dist/adapters/_govinfo_py.d.ts +22 -0
  24. package/dist/adapters/_govinfo_py.js +272 -0
  25. package/dist/adapters/_govinfo_py.js.map +1 -0
  26. package/dist/adapters/_govinfo_xml.d.ts +22 -0
  27. package/dist/adapters/_govinfo_xml.js +233 -0
  28. package/dist/adapters/_govinfo_xml.js.map +1 -0
  29. package/dist/adapters/_hud_excel.d.ts +2 -0
  30. package/dist/adapters/_hud_excel.js +166 -0
  31. package/dist/adapters/_hud_excel.js.map +1 -0
  32. package/dist/adapters/_omb_grid.d.ts +17 -0
  33. package/dist/adapters/_omb_grid.js +132 -0
  34. package/dist/adapters/_omb_grid.js.map +1 -0
  35. package/dist/adapters/_omb_util.d.ts +40 -0
  36. package/dist/adapters/_omb_util.js +192 -0
  37. package/dist/adapters/_omb_util.js.map +1 -0
  38. package/dist/adapters/_usaspending_state.d.ts +6 -0
  39. package/dist/adapters/_usaspending_state.js +54 -0
  40. package/dist/adapters/_usaspending_state.js.map +1 -0
  41. package/dist/adapters/_usda-fna_book.d.ts +59 -0
  42. package/dist/adapters/_usda-fna_book.js +869 -0
  43. package/dist/adapters/_usda-fna_book.js.map +1 -0
  44. package/dist/adapters/_usda-fna_pdf.d.ts +20 -0
  45. package/dist/adapters/_usda-fna_pdf.js +361 -0
  46. package/dist/adapters/_usda-fna_pdf.js.map +1 -0
  47. package/dist/adapters/_usda-outlook_read.d.ts +70 -0
  48. package/dist/adapters/_usda-outlook_read.js +362 -0
  49. package/dist/adapters/_usda-outlook_read.js.map +1 -0
  50. package/dist/adapters/acf.d.ts +3 -0
  51. package/dist/adapters/acf.js +187 -0
  52. package/dist/adapters/acf.js.map +1 -0
  53. package/dist/adapters/actuaries.d.ts +3 -0
  54. package/dist/adapters/actuaries.js +293 -0
  55. package/dist/adapters/actuaries.js.map +1 -0
  56. package/dist/adapters/bts.d.ts +3 -0
  57. package/dist/adapters/bts.js +26 -0
  58. package/dist/adapters/bts.js.map +1 -0
  59. package/dist/adapters/census-geocoder.d.ts +10 -0
  60. package/dist/adapters/census-geocoder.js +47 -0
  61. package/dist/adapters/census-geocoder.js.map +1 -0
  62. package/dist/adapters/census.d.ts +17 -0
  63. package/dist/adapters/census.js +983 -0
  64. package/dist/adapters/census.js.map +1 -0
  65. package/dist/adapters/cfpb.d.ts +7 -0
  66. package/dist/adapters/cfpb.js +348 -0
  67. package/dist/adapters/cfpb.js.map +1 -0
  68. package/dist/adapters/clinical-trials.d.ts +3 -0
  69. package/dist/adapters/clinical-trials.js +135 -0
  70. package/dist/adapters/clinical-trials.js.map +1 -0
  71. package/dist/adapters/cms.d.ts +3 -0
  72. package/dist/adapters/cms.js +292 -0
  73. package/dist/adapters/cms.js.map +1 -0
  74. package/dist/adapters/college-scorecard.d.ts +3 -0
  75. package/dist/adapters/college-scorecard.js +122 -0
  76. package/dist/adapters/college-scorecard.js.map +1 -0
  77. package/dist/adapters/congress.d.ts +33 -0
  78. package/dist/adapters/congress.js +589 -0
  79. package/dist/adapters/congress.js.map +1 -0
  80. package/dist/adapters/dhs-ohss.d.ts +13 -0
  81. package/dist/adapters/dhs-ohss.js +598 -0
  82. package/dist/adapters/dhs-ohss.js.map +1 -0
  83. package/dist/adapters/doj-news.d.ts +7 -0
  84. package/dist/adapters/doj-news.js +286 -0
  85. package/dist/adapters/doj-news.js.map +1 -0
  86. package/dist/adapters/dol.d.ts +4 -0
  87. package/dist/adapters/dol.js +634 -0
  88. package/dist/adapters/dol.js.map +1 -0
  89. package/dist/adapters/eia.d.ts +15 -0
  90. package/dist/adapters/eia.js +456 -0
  91. package/dist/adapters/eia.js.map +1 -0
  92. package/dist/adapters/epa-aqs.d.ts +3 -0
  93. package/dist/adapters/epa-aqs.js +357 -0
  94. package/dist/adapters/epa-aqs.js.map +1 -0
  95. package/dist/adapters/epa.d.ts +3 -0
  96. package/dist/adapters/epa.js +298 -0
  97. package/dist/adapters/epa.js.map +1 -0
  98. package/dist/adapters/fbi.d.ts +3 -0
  99. package/dist/adapters/fbi.js +192 -0
  100. package/dist/adapters/fbi.js.map +1 -0
  101. package/dist/adapters/fda.d.ts +5 -0
  102. package/dist/adapters/fda.js +184 -0
  103. package/dist/adapters/fda.js.map +1 -0
  104. package/dist/adapters/fdic.d.ts +4 -0
  105. package/dist/adapters/fdic.js +95 -0
  106. package/dist/adapters/fdic.js.map +1 -0
  107. package/dist/adapters/fec.d.ts +3 -0
  108. package/dist/adapters/fec.js +142 -0
  109. package/dist/adapters/fec.js.map +1 -0
  110. package/dist/adapters/fed-board.d.ts +12 -0
  111. package/dist/adapters/fed-board.js +581 -0
  112. package/dist/adapters/fed-board.js.map +1 -0
  113. package/dist/adapters/federal-register.d.ts +11 -0
  114. package/dist/adapters/federal-register.js +43 -0
  115. package/dist/adapters/federal-register.js.map +1 -0
  116. package/dist/adapters/fhfa.d.ts +3 -0
  117. package/dist/adapters/fhfa.js +253 -0
  118. package/dist/adapters/fhfa.js.map +1 -0
  119. package/dist/adapters/fsa.d.ts +9 -0
  120. package/dist/adapters/fsa.js +335 -0
  121. package/dist/adapters/fsa.js.map +1 -0
  122. package/dist/adapters/govinfo.d.ts +30 -0
  123. package/dist/adapters/govinfo.js +636 -0
  124. package/dist/adapters/govinfo.js.map +1 -0
  125. package/dist/adapters/gsa-calc.d.ts +10 -0
  126. package/dist/adapters/gsa-calc.js +318 -0
  127. package/dist/adapters/gsa-calc.js.map +1 -0
  128. package/dist/adapters/hud.d.ts +3 -0
  129. package/dist/adapters/hud.js +200 -0
  130. package/dist/adapters/hud.js.map +1 -0
  131. package/dist/adapters/index.d.ts +3 -0
  132. package/dist/adapters/index.js +25 -0
  133. package/dist/adapters/index.js.map +1 -0
  134. package/dist/adapters/irs-soi.d.ts +6 -0
  135. package/dist/adapters/irs-soi.js +576 -0
  136. package/dist/adapters/irs-soi.js.map +1 -0
  137. package/dist/adapters/naep.d.ts +15 -0
  138. package/dist/adapters/naep.js +341 -0
  139. package/dist/adapters/naep.js.map +1 -0
  140. package/dist/adapters/nhtsa.d.ts +10 -0
  141. package/dist/adapters/nhtsa.js +239 -0
  142. package/dist/adapters/nhtsa.js.map +1 -0
  143. package/dist/adapters/nih.d.ts +5 -0
  144. package/dist/adapters/nih.js +196 -0
  145. package/dist/adapters/nih.js.map +1 -0
  146. package/dist/adapters/noaa.d.ts +3 -0
  147. package/dist/adapters/noaa.js +148 -0
  148. package/dist/adapters/noaa.js.map +1 -0
  149. package/dist/adapters/nrel.d.ts +3 -0
  150. package/dist/adapters/nrel.js +186 -0
  151. package/dist/adapters/nrel.js.map +1 -0
  152. package/dist/adapters/nws.d.ts +3 -0
  153. package/dist/adapters/nws.js +119 -0
  154. package/dist/adapters/nws.js.map +1 -0
  155. package/dist/adapters/omb.d.ts +15 -0
  156. package/dist/adapters/omb.js +517 -0
  157. package/dist/adapters/omb.js.map +1 -0
  158. package/dist/adapters/open-payments.d.ts +5 -0
  159. package/dist/adapters/open-payments.js +149 -0
  160. package/dist/adapters/open-payments.js.map +1 -0
  161. package/dist/adapters/pbgc.d.ts +13 -0
  162. package/dist/adapters/pbgc.js +283 -0
  163. package/dist/adapters/pbgc.js.map +1 -0
  164. package/dist/adapters/philfed.d.ts +12 -0
  165. package/dist/adapters/philfed.js +59 -0
  166. package/dist/adapters/philfed.js.map +1 -0
  167. package/dist/adapters/regulations.d.ts +6 -0
  168. package/dist/adapters/regulations.js +58 -0
  169. package/dist/adapters/regulations.js.map +1 -0
  170. package/dist/adapters/sec.d.ts +13 -0
  171. package/dist/adapters/sec.js +504 -0
  172. package/dist/adapters/sec.js.map +1 -0
  173. package/dist/adapters/senate-lobbying.d.ts +3 -0
  174. package/dist/adapters/senate-lobbying.js +181 -0
  175. package/dist/adapters/senate-lobbying.js.map +1 -0
  176. package/dist/adapters/snapqc.d.ts +32 -0
  177. package/dist/adapters/snapqc.js +701 -0
  178. package/dist/adapters/snapqc.js.map +1 -0
  179. package/dist/adapters/treasury-yields.d.ts +3 -0
  180. package/dist/adapters/treasury-yields.js +170 -0
  181. package/dist/adapters/treasury-yields.js.map +1 -0
  182. package/dist/adapters/usaspending.d.ts +3 -0
  183. package/dist/adapters/usaspending.js +340 -0
  184. package/dist/adapters/usaspending.js.map +1 -0
  185. package/dist/adapters/usda-fna.d.ts +7 -0
  186. package/dist/adapters/usda-fna.js +707 -0
  187. package/dist/adapters/usda-fna.js.map +1 -0
  188. package/dist/adapters/usda-fooddata.d.ts +3 -0
  189. package/dist/adapters/usda-fooddata.js +101 -0
  190. package/dist/adapters/usda-fooddata.js.map +1 -0
  191. package/dist/adapters/usda-nass.d.ts +3 -0
  192. package/dist/adapters/usda-nass.js +108 -0
  193. package/dist/adapters/usda-nass.js.map +1 -0
  194. package/dist/adapters/usda-outlook.d.ts +12 -0
  195. package/dist/adapters/usda-outlook.js +696 -0
  196. package/dist/adapters/usda-outlook.js.map +1 -0
  197. package/dist/adapters/usgs.d.ts +9 -0
  198. package/dist/adapters/usgs.js +265 -0
  199. package/dist/adapters/usgs.js.map +1 -0
  200. package/dist/adapters/usitc.d.ts +18 -0
  201. package/dist/adapters/usitc.js +170 -0
  202. package/dist/adapters/usitc.js.map +1 -0
  203. package/dist/adapters/uspto.d.ts +3 -0
  204. package/dist/adapters/uspto.js +47 -0
  205. package/dist/adapters/uspto.js.map +1 -0
  206. package/dist/adapters/world-bank.d.ts +3 -0
  207. package/dist/adapters/world-bank.js +163 -0
  208. package/dist/adapters/world-bank.js.map +1 -0
  209. package/dist/analysis/cite.d.ts +31 -0
  210. package/dist/analysis/cite.js +229 -0
  211. package/dist/analysis/cite.js.map +1 -0
  212. package/dist/analysis/combine.d.ts +27 -0
  213. package/dist/analysis/combine.js +198 -0
  214. package/dist/analysis/combine.js.map +1 -0
  215. package/dist/analysis/compute.d.ts +62 -0
  216. package/dist/analysis/compute.js +583 -0
  217. package/dist/analysis/compute.js.map +1 -0
  218. package/dist/analysis/expr.d.ts +69 -0
  219. package/dist/analysis/expr.js +780 -0
  220. package/dist/analysis/expr.js.map +1 -0
  221. package/dist/analysis/factfmt.d.ts +16 -0
  222. package/dist/analysis/factfmt.js +187 -0
  223. package/dist/analysis/factfmt.js.map +1 -0
  224. package/dist/analysis/facts.d.ts +63 -0
  225. package/dist/analysis/facts.js +355 -0
  226. package/dist/analysis/facts.js.map +1 -0
  227. package/dist/analysis/handoff.d.ts +58 -0
  228. package/dist/analysis/handoff.js +208 -0
  229. package/dist/analysis/handoff.js.map +1 -0
  230. package/dist/analysis/pyfmt.d.ts +16 -0
  231. package/dist/analysis/pyfmt.js +156 -0
  232. package/dist/analysis/pyfmt.js.map +1 -0
  233. package/dist/analysis/rerun.d.ts +13 -0
  234. package/dist/analysis/rerun.js +125 -0
  235. package/dist/analysis/rerun.js.map +1 -0
  236. package/dist/analysis/table.d.ts +18 -0
  237. package/dist/analysis/table.js +109 -0
  238. package/dist/analysis/table.js.map +1 -0
  239. package/dist/analysis/tools.d.ts +67 -0
  240. package/dist/analysis/tools.js +217 -0
  241. package/dist/analysis/tools.js.map +1 -0
  242. package/dist/analysis/write_table.d.ts +13 -0
  243. package/dist/analysis/write_table.js +59 -0
  244. package/dist/analysis/write_table.js.map +1 -0
  245. package/dist/bin/cli.d.ts +10 -0
  246. package/dist/bin/cli.js +177 -0
  247. package/dist/bin/cli.js.map +1 -0
  248. package/dist/core/cache.d.ts +14 -0
  249. package/dist/core/cache.js +90 -0
  250. package/dist/core/cache.js.map +1 -0
  251. package/dist/core/context.d.ts +12 -0
  252. package/dist/core/context.js +15 -0
  253. package/dist/core/context.js.map +1 -0
  254. package/dist/core/env.d.ts +14 -0
  255. package/dist/core/env.js +52 -0
  256. package/dist/core/env.js.map +1 -0
  257. package/dist/core/generic-rest.d.ts +61 -0
  258. package/dist/core/generic-rest.js +639 -0
  259. package/dist/core/generic-rest.js.map +1 -0
  260. package/dist/core/http.d.ts +120 -0
  261. package/dist/core/http.js +514 -0
  262. package/dist/core/http.js.map +1 -0
  263. package/dist/core/keys.d.ts +43 -0
  264. package/dist/core/keys.js +174 -0
  265. package/dist/core/keys.js.map +1 -0
  266. package/dist/core/manual.d.ts +41 -0
  267. package/dist/core/manual.js +218 -0
  268. package/dist/core/manual.js.map +1 -0
  269. package/dist/core/package.d.ts +58 -0
  270. package/dist/core/package.js +228 -0
  271. package/dist/core/package.js.map +1 -0
  272. package/dist/core/packs.d.ts +139 -0
  273. package/dist/core/packs.js +173 -0
  274. package/dist/core/packs.js.map +1 -0
  275. package/dist/core/policy.d.ts +69 -0
  276. package/dist/core/policy.js +189 -0
  277. package/dist/core/policy.js.map +1 -0
  278. package/dist/core/py.d.ts +40 -0
  279. package/dist/core/py.js +171 -0
  280. package/dist/core/py.js.map +1 -0
  281. package/dist/core/routing.d.ts +10 -0
  282. package/dist/core/routing.js +39 -0
  283. package/dist/core/routing.js.map +1 -0
  284. package/dist/core/tabular.d.ts +21 -0
  285. package/dist/core/tabular.js +229 -0
  286. package/dist/core/tabular.js.map +1 -0
  287. package/dist/deep/_bea_api.d.ts +102 -0
  288. package/dist/deep/_bea_api.js +457 -0
  289. package/dist/deep/_bea_api.js.map +1 -0
  290. package/dist/deep/_bea_fetch.d.ts +151 -0
  291. package/dist/deep/_bea_fetch.js +1274 -0
  292. package/dist/deep/_bea_fetch.js.map +1 -0
  293. package/dist/deep/_bea_util.d.ts +14 -0
  294. package/dist/deep/_bea_util.js +156 -0
  295. package/dist/deep/_bea_util.js.map +1 -0
  296. package/dist/deep/_bls_api.d.ts +84 -0
  297. package/dist/deep/_bls_api.js +231 -0
  298. package/dist/deep/_bls_api.js.map +1 -0
  299. package/dist/deep/_bls_ids.d.ts +43 -0
  300. package/dist/deep/_bls_ids.js +188 -0
  301. package/dist/deep/_bls_ids.js.map +1 -0
  302. package/dist/deep/_bls_lib.d.ts +61 -0
  303. package/dist/deep/_bls_lib.js +442 -0
  304. package/dist/deep/_bls_lib.js.map +1 -0
  305. package/dist/deep/_fred_api.d.ts +148 -0
  306. package/dist/deep/_fred_api.js +545 -0
  307. package/dist/deep/_fred_api.js.map +1 -0
  308. package/dist/deep/_fred_pack.d.ts +162 -0
  309. package/dist/deep/_fred_pack.js +1027 -0
  310. package/dist/deep/_fred_pack.js.map +1 -0
  311. package/dist/deep/_fred_py.d.ts +40 -0
  312. package/dist/deep/_fred_py.js +199 -0
  313. package/dist/deep/_fred_py.js.map +1 -0
  314. package/dist/deep/_ipums_bundle.d.ts +29 -0
  315. package/dist/deep/_ipums_bundle.js +194 -0
  316. package/dist/deep/_ipums_bundle.js.map +1 -0
  317. package/dist/deep/_ipums_ddi.d.ts +23 -0
  318. package/dist/deep/_ipums_ddi.js +162 -0
  319. package/dist/deep/_ipums_ddi.js.map +1 -0
  320. package/dist/deep/_opm_io.d.ts +26 -0
  321. package/dist/deep/_opm_io.js +383 -0
  322. package/dist/deep/_opm_io.js.map +1 -0
  323. package/dist/deep/_opm_parquet.d.ts +31 -0
  324. package/dist/deep/_opm_parquet.js +744 -0
  325. package/dist/deep/_opm_parquet.js.map +1 -0
  326. package/dist/deep/_opm_py.d.ts +6 -0
  327. package/dist/deep/_opm_py.js +74 -0
  328. package/dist/deep/_opm_py.js.map +1 -0
  329. package/dist/deep/_treasury_api.d.ts +48 -0
  330. package/dist/deep/_treasury_api.js +221 -0
  331. package/dist/deep/_treasury_api.js.map +1 -0
  332. package/dist/deep/_treasury_context.d.ts +34 -0
  333. package/dist/deep/_treasury_context.js +142 -0
  334. package/dist/deep/_treasury_context.js.map +1 -0
  335. package/dist/deep/_treasury_lib.d.ts +109 -0
  336. package/dist/deep/_treasury_lib.js +686 -0
  337. package/dist/deep/_treasury_lib.js.map +1 -0
  338. package/dist/deep/bea.d.ts +3 -0
  339. package/dist/deep/bea.js +248 -0
  340. package/dist/deep/bea.js.map +1 -0
  341. package/dist/deep/bls.d.ts +3 -0
  342. package/dist/deep/bls.js +220 -0
  343. package/dist/deep/bls.js.map +1 -0
  344. package/dist/deep/fred.d.ts +3 -0
  345. package/dist/deep/fred.js +325 -0
  346. package/dist/deep/fred.js.map +1 -0
  347. package/dist/deep/ipums.d.ts +59 -0
  348. package/dist/deep/ipums.js +744 -0
  349. package/dist/deep/ipums.js.map +1 -0
  350. package/dist/deep/opm.d.ts +56 -0
  351. package/dist/deep/opm.js +1033 -0
  352. package/dist/deep/opm.js.map +1 -0
  353. package/dist/deep/treasury.d.ts +3 -0
  354. package/dist/deep/treasury.js +218 -0
  355. package/dist/deep/treasury.js.map +1 -0
  356. package/dist/envelope.d.ts +47 -0
  357. package/dist/envelope.js +88 -0
  358. package/dist/envelope.js.map +1 -0
  359. package/dist/index.d.ts +277 -0
  360. package/dist/index.js +106 -0
  361. package/dist/index.js.map +1 -0
  362. package/dist/remote/app.d.ts +21 -0
  363. package/dist/remote/app.js +218 -0
  364. package/dist/remote/app.js.map +1 -0
  365. package/dist/remote/oauth.d.ts +14 -0
  366. package/dist/remote/oauth.js +90 -0
  367. package/dist/remote/oauth.js.map +1 -0
  368. package/dist/remote/pages.d.ts +8 -0
  369. package/dist/remote/pages.js +56 -0
  370. package/dist/remote/pages.js.map +1 -0
  371. package/dist/remote/sign.d.ts +4 -0
  372. package/dist/remote/sign.js +40 -0
  373. package/dist/remote/sign.js.map +1 -0
  374. package/dist/remote/store.d.ts +31 -0
  375. package/dist/remote/store.js +129 -0
  376. package/dist/remote/store.js.map +1 -0
  377. package/dist/report/audit_answer.d.ts +94 -0
  378. package/dist/report/audit_answer.js +1349 -0
  379. package/dist/report/audit_answer.js.map +1 -0
  380. package/dist/report/audit_report.d.ts +23 -0
  381. package/dist/report/audit_report.js +637 -0
  382. package/dist/report/audit_report.js.map +1 -0
  383. package/dist/report/build_report.d.ts +27 -0
  384. package/dist/report/build_report.js +1168 -0
  385. package/dist/report/build_report.js.map +1 -0
  386. package/dist/report/method_audit.d.ts +47 -0
  387. package/dist/report/method_audit.js +710 -0
  388. package/dist/report/method_audit.js.map +1 -0
  389. package/dist/report/policyset.d.ts +50 -0
  390. package/dist/report/policyset.js +421 -0
  391. package/dist/report/policyset.js.map +1 -0
  392. package/dist/report/py.d.ts +58 -0
  393. package/dist/report/py.js +311 -0
  394. package/dist/report/py.js.map +1 -0
  395. package/dist/report/scan_secrets.d.ts +21 -0
  396. package/dist/report/scan_secrets.js +234 -0
  397. package/dist/report/scan_secrets.js.map +1 -0
  398. package/dist/report/style_check.d.ts +29 -0
  399. package/dist/report/style_check.js +173 -0
  400. package/dist/report/style_check.js.map +1 -0
  401. package/dist/report/tools.d.ts +87 -0
  402. package/dist/report/tools.js +167 -0
  403. package/dist/report/tools.js.map +1 -0
  404. package/dist/server.d.ts +5 -0
  405. package/dist/server.js +246 -0
  406. package/dist/server.js.map +1 -0
  407. package/dist/session.d.ts +47 -0
  408. package/dist/session.js +107 -0
  409. package/dist/session.js.map +1 -0
  410. package/dist/toolkit.d.ts +21 -0
  411. package/dist/toolkit.js +2 -0
  412. package/dist/toolkit.js.map +1 -0
  413. package/dist/tools.d.ts +299 -0
  414. package/dist/tools.js +491 -0
  415. package/dist/tools.js.map +1 -0
  416. package/guide/WORKFLOW.md +134 -0
  417. package/guide/assets/disclaimer.txt +1 -0
  418. package/guide/assets/download_data.ps1 +162 -0
  419. package/guide/assets/download_data.sh +143 -0
  420. package/guide/assets/report_template.html +597 -0
  421. package/guide/references/report_patterns.md +199 -0
  422. package/guide/references/routing.md +171 -0
  423. package/guide/references/style_guide.md +398 -0
  424. package/package.json +56 -6
  425. package/packs/acf/endpoints.json +114 -0
  426. package/packs/acf/policy.json +104 -0
  427. package/packs/acf/source.md +138 -0
  428. package/packs/actuaries/endpoints.json +82 -0
  429. package/packs/actuaries/policy.json +109 -0
  430. package/packs/actuaries/source.md +137 -0
  431. package/packs/bea/assets/download_bea.ps1 +182 -0
  432. package/packs/bea/assets/download_bea.sh +144 -0
  433. package/packs/bea/docs/bea_api.md +461 -0
  434. package/packs/bea/docs/datasets.md +157 -0
  435. package/packs/bea/docs/report_patterns.md +112 -0
  436. package/packs/bea/policy.json +170 -0
  437. package/packs/bea/source.md +152 -0
  438. package/packs/bls/assets/download_bls.ps1 +152 -0
  439. package/packs/bls/assets/download_bls.sh +167 -0
  440. package/packs/bls/docs/analysis_patterns.md +108 -0
  441. package/packs/bls/docs/bls_api.md +73 -0
  442. package/packs/bls/docs/series_ids.md +149 -0
  443. package/packs/bls/policy.json +238 -0
  444. package/packs/bls/series_ids.json +1375 -0
  445. package/packs/bls/source.md +156 -0
  446. package/packs/bts/endpoints.json +347 -0
  447. package/packs/bts/policy.json +94 -0
  448. package/packs/bts/source.md +97 -0
  449. package/packs/cdc/endpoints.json +197 -0
  450. package/packs/cdc/policy.json +83 -0
  451. package/packs/cdc/source.md +74 -0
  452. package/packs/census/endpoints.json +99 -0
  453. package/packs/census/policy.json +238 -0
  454. package/packs/census/source.md +304 -0
  455. package/packs/census-geocoder/endpoints.json +70 -0
  456. package/packs/census-geocoder/policy.json +80 -0
  457. package/packs/census-geocoder/source.md +53 -0
  458. package/packs/cfpb/endpoints.json +327 -0
  459. package/packs/cfpb/policy.json +119 -0
  460. package/packs/cfpb/source.md +96 -0
  461. package/packs/clinical-trials/endpoints.json +167 -0
  462. package/packs/clinical-trials/policy.json +84 -0
  463. package/packs/clinical-trials/source.md +82 -0
  464. package/packs/cms/endpoints.json +69 -0
  465. package/packs/cms/policy.json +96 -0
  466. package/packs/cms/source.md +112 -0
  467. package/packs/college-scorecard/endpoints.json +253 -0
  468. package/packs/college-scorecard/policy.json +106 -0
  469. package/packs/college-scorecard/source.md +92 -0
  470. package/packs/congress/endpoints.json +1701 -0
  471. package/packs/congress/policy.json +117 -0
  472. package/packs/congress/source.md +190 -0
  473. package/packs/dhs-ohss/endpoints.json +66 -0
  474. package/packs/dhs-ohss/policy.json +107 -0
  475. package/packs/dhs-ohss/source.md +120 -0
  476. package/packs/doj-news/endpoints.json +59 -0
  477. package/packs/doj-news/policy.json +96 -0
  478. package/packs/doj-news/source.md +99 -0
  479. package/packs/dol/endpoints.json +818 -0
  480. package/packs/dol/policy.json +135 -0
  481. package/packs/dol/source.md +181 -0
  482. package/packs/eia/endpoints.json +718 -0
  483. package/packs/eia/policy.json +112 -0
  484. package/packs/eia/source.md +112 -0
  485. package/packs/epa/endpoints.json +292 -0
  486. package/packs/epa/policy.json +99 -0
  487. package/packs/epa/source.md +99 -0
  488. package/packs/epa-aqs/endpoints.json +174 -0
  489. package/packs/epa-aqs/policy.json +96 -0
  490. package/packs/epa-aqs/source.md +97 -0
  491. package/packs/fbi/endpoints.json +1842 -0
  492. package/packs/fbi/policy.json +118 -0
  493. package/packs/fbi/source.md +108 -0
  494. package/packs/fda/endpoints.json +238 -0
  495. package/packs/fda/policy.json +121 -0
  496. package/packs/fda/source.md +117 -0
  497. package/packs/fdic/endpoints.json +417 -0
  498. package/packs/fdic/policy.json +83 -0
  499. package/packs/fdic/source.md +92 -0
  500. package/packs/fec/endpoints.json +708 -0
  501. package/packs/fec/policy.json +93 -0
  502. package/packs/fec/source.md +90 -0
  503. package/packs/fed-board/endpoints.json +89 -0
  504. package/packs/fed-board/policy.json +136 -0
  505. package/packs/fed-board/source.md +118 -0
  506. package/packs/federal-register/endpoints.json +143 -0
  507. package/packs/federal-register/policy.json +86 -0
  508. package/packs/federal-register/source.md +98 -0
  509. package/packs/fema/endpoints.json +646 -0
  510. package/packs/fema/policy.json +103 -0
  511. package/packs/fema/source.md +103 -0
  512. package/packs/fhfa/endpoints.json +105 -0
  513. package/packs/fhfa/policy.json +109 -0
  514. package/packs/fhfa/source.md +108 -0
  515. package/packs/fred/assets/download_fred.ps1 +122 -0
  516. package/packs/fred/assets/download_fred.sh +123 -0
  517. package/packs/fred/docs/analysis_patterns.md +124 -0
  518. package/packs/fred/docs/fred_api.md +94 -0
  519. package/packs/fred/docs/series.md +188 -0
  520. package/packs/fred/policy.json +253 -0
  521. package/packs/fred/source.md +142 -0
  522. package/packs/fsa/endpoints.json +150 -0
  523. package/packs/fsa/policy.json +99 -0
  524. package/packs/fsa/source.md +102 -0
  525. package/packs/govinfo/endpoints.json +520 -0
  526. package/packs/govinfo/policy.json +116 -0
  527. package/packs/govinfo/source.md +241 -0
  528. package/packs/gsa-calc/endpoints.json +93 -0
  529. package/packs/gsa-calc/policy.json +97 -0
  530. package/packs/gsa-calc/source.md +108 -0
  531. package/packs/hud/endpoints.json +147 -0
  532. package/packs/hud/policy.json +84 -0
  533. package/packs/hud/source.md +97 -0
  534. package/packs/ipums/assets/download_ipums.ps1 +215 -0
  535. package/packs/ipums/assets/download_ipums.sh +192 -0
  536. package/packs/ipums/docs/ipums_api.md +67 -0
  537. package/packs/ipums/docs/report_patterns.md +117 -0
  538. package/packs/ipums/docs/variables.md +284 -0
  539. package/packs/ipums/lib/fetch_text.json +112 -0
  540. package/packs/ipums/policy.json +215 -0
  541. package/packs/ipums/source.md +169 -0
  542. package/packs/irs-soi/endpoints.json +114 -0
  543. package/packs/irs-soi/policy.json +107 -0
  544. package/packs/irs-soi/source.md +124 -0
  545. package/packs/medicaid/endpoints.json +412 -0
  546. package/packs/medicaid/policy.json +108 -0
  547. package/packs/medicaid/source.md +136 -0
  548. package/packs/naep/endpoints.json +217 -0
  549. package/packs/naep/policy.json +100 -0
  550. package/packs/naep/source.md +120 -0
  551. package/packs/nhtsa/endpoints.json +132 -0
  552. package/packs/nhtsa/policy.json +93 -0
  553. package/packs/nhtsa/source.md +109 -0
  554. package/packs/nih/endpoints.json +453 -0
  555. package/packs/nih/policy.json +86 -0
  556. package/packs/nih/source.md +108 -0
  557. package/packs/noaa/endpoints.json +432 -0
  558. package/packs/noaa/policy.json +95 -0
  559. package/packs/noaa/source.md +88 -0
  560. package/packs/nrel/endpoints.json +328 -0
  561. package/packs/nrel/policy.json +96 -0
  562. package/packs/nrel/source.md +91 -0
  563. package/packs/nws/endpoints.json +272 -0
  564. package/packs/nws/policy.json +82 -0
  565. package/packs/nws/source.md +81 -0
  566. package/packs/nyfed/endpoints.json +80 -0
  567. package/packs/nyfed/policy.json +92 -0
  568. package/packs/nyfed/source.md +89 -0
  569. package/packs/omb/endpoints.json +460 -0
  570. package/packs/omb/policy.json +106 -0
  571. package/packs/omb/source.md +130 -0
  572. package/packs/open-payments/endpoints.json +298 -0
  573. package/packs/open-payments/policy.json +101 -0
  574. package/packs/open-payments/source.md +99 -0
  575. package/packs/opm/assets/download_opm.ps1 +125 -0
  576. package/packs/opm/assets/download_opm.sh +85 -0
  577. package/packs/opm/docs/fields.md +184 -0
  578. package/packs/opm/docs/opm_api.md +71 -0
  579. package/packs/opm/docs/report_patterns.md +83 -0
  580. package/packs/opm/lib/data_dictionary.csv +73 -0
  581. package/packs/opm/policy.json +142 -0
  582. package/packs/opm/source.md +137 -0
  583. package/packs/pbgc/endpoints.json +483 -0
  584. package/packs/pbgc/policy.json +94 -0
  585. package/packs/pbgc/source.md +95 -0
  586. package/packs/philfed/endpoints.json +85 -0
  587. package/packs/philfed/policy.json +94 -0
  588. package/packs/philfed/source.md +125 -0
  589. package/packs/port.json +287 -0
  590. package/packs/regulations/endpoints.json +288 -0
  591. package/packs/regulations/policy.json +86 -0
  592. package/packs/regulations/source.md +84 -0
  593. package/packs/sec/endpoints.json +237 -0
  594. package/packs/sec/policy.json +86 -0
  595. package/packs/sec/source.md +101 -0
  596. package/packs/senate-lobbying/endpoints.json +554 -0
  597. package/packs/senate-lobbying/policy.json +99 -0
  598. package/packs/senate-lobbying/source.md +100 -0
  599. package/packs/snapqc/endpoints.json +1426 -0
  600. package/packs/snapqc/policy.json +92 -0
  601. package/packs/snapqc/source.md +96 -0
  602. package/packs/treasury/catalog.json +2267 -0
  603. package/packs/treasury/docs/api_guide.md +245 -0
  604. package/packs/treasury/docs/datasets.md +56 -0
  605. package/packs/treasury/docs/report_patterns.md +126 -0
  606. package/packs/treasury/policy.json +159 -0
  607. package/packs/treasury/source.md +165 -0
  608. package/packs/treasury-yields/endpoints.json +226 -0
  609. package/packs/treasury-yields/policy.json +86 -0
  610. package/packs/treasury-yields/source.md +80 -0
  611. package/packs/usaspending/endpoints.json +1316 -0
  612. package/packs/usaspending/policy.json +109 -0
  613. package/packs/usaspending/source.md +103 -0
  614. package/packs/usda-fna/endpoints.json +427 -0
  615. package/packs/usda-fna/policy.json +133 -0
  616. package/packs/usda-fna/source.md +217 -0
  617. package/packs/usda-fooddata/endpoints.json +181 -0
  618. package/packs/usda-fooddata/policy.json +94 -0
  619. package/packs/usda-fooddata/source.md +105 -0
  620. package/packs/usda-nass/endpoints.json +324 -0
  621. package/packs/usda-nass/policy.json +95 -0
  622. package/packs/usda-nass/source.md +85 -0
  623. package/packs/usda-outlook/endpoints.json +86 -0
  624. package/packs/usda-outlook/policy.json +109 -0
  625. package/packs/usda-outlook/source.md +144 -0
  626. package/packs/usgs/endpoints.json +313 -0
  627. package/packs/usgs/policy.json +95 -0
  628. package/packs/usgs/source.md +96 -0
  629. package/packs/usitc/endpoints.json +74 -0
  630. package/packs/usitc/policy.json +111 -0
  631. package/packs/usitc/source.md +90 -0
  632. package/packs/uspto/endpoints.json +141 -0
  633. package/packs/uspto/policy.json +95 -0
  634. package/packs/uspto/source.md +101 -0
  635. package/packs/va/endpoints.json +414 -0
  636. package/packs/va/policy.json +101 -0
  637. package/packs/va/source.md +129 -0
  638. package/packs/world-bank/endpoints.json +122 -0
  639. package/packs/world-bank/policy.json +101 -0
  640. package/packs/world-bank/source.md +93 -0
@@ -0,0 +1,156 @@
1
+ # Bureau of Labor Statistics Public Data API
2
+ Depth: deep. Key: optional (BLS_API_KEY). BLS time series: jobs (CES, CPS, JOLTS), prices (CPI, PPI), wages
3
+ (CES earnings, ECI, OEWS), productivity, and state, metro and county labor markets (LAUS, state CES).
4
+
5
+ ## When to use
6
+ - Unemployment (U-3, U-6), participation, payrolls by industry, job openings and quits, CPI and its
7
+ components, PPI, average hourly earnings and real wages, the ECI, productivity and unit labor costs,
8
+ state and county unemployment (LAUS), state payrolls, wages by occupation (OEWS), QCEW series (prefix EN).
9
+ - Questions phrased as "the jobs report", "inflation", "wage growth", even with no series ID: picking and
10
+ verifying the ID is your job, never a question for the user.
11
+ - Not here: PCE prices, GDP, income (bea; fred mirrors them); interest rates and budget series (fred,
12
+ treasury); worker microdata (ipums CPS); federal employees (opm). FRED mirrors many BLS series, but this
13
+ pack keeps BLS's preliminary flags, footnotes and gaps.
14
+
15
+ ## Endpoints and datasets
16
+ | What | How | Notes |
17
+ |---|---|---|
18
+ | Time series data | spec `series` / `build` → POST `api.bls.gov/publicAPI/v2` (key) or `/v1` (no key) | monthly (M01-M12), quarterly (Q01-Q04), semiannual (S01-S02), annual (A01; M13/Q05/S03 = BLS annual averages, v2 only) |
19
+ | Series titles | `request_schema` search `describe ID ...` (or just the IDs; data.bls.gov/timeseries/ID; no key, no query used) | read title, SA/NSA, units back against the concept; a missing title = no such ID, except OEWS (OE...), whose IDs are only decoded from their layout (a `note` says so) |
20
+ | Offline decode | `request_schema` search `decode ID ...` | survey prefix and S/U code |
21
+ | Topic catalog | `request_schema` search `"words"` (offline, about 70 common series by topic: employment, unemployment, wages, cpi, cpi_components, ppi, productivity, jolts, oews) | |
22
+ | ID builders | spec `build` entries: `{"kind": "laus", "state": "MD", "measure": "unemployment_rate", "seasonal": "U"}`, `{"kind": "laus", "county": "24005"}`, `{"kind": "ces_state", "state": "MD", "industry": "<8 digits>"}`, `{"kind": "state", "state": "MD"}`, `{"kind": "oews", "occupation": "15-1252", "state": "MD", "measure": "annual_median_wage"}`, `{"kind": "jolts", "industry": "all", "measure": "quits"}` (national JOLTS by industry; rate, or level with `"rate": false`). The search `build {json}` previews the IDs an entry makes | patterns and measures in docs/series_ids.md §4; `request_schema` names `["build"]` lists every kind's parameters |
23
+
24
+ Verified common IDs (docs/series_ids.md has the full table and the ID structure of every survey):
25
+ U-3 `LNS14000000` (NSA `LNU04000000`); U-6 `LNS13327709`; participation `LNS11300000`; prime-age
26
+ employment-population ratio `LNS12300060`; payrolls `CES0000000001` (thousands); private AHE
27
+ `CES0500000003`; CPI-U all items `CUUR0000SA0` (NSA) / `CUSR0000SA0` (SA); core `CUUR0000SA0L1E`; CPI-W
28
+ `CWUR0000SA0`; chained CPI-U `SUUR0000SA0`; PPI final demand `WPSFD4`; job openings `JTS000000000000000JOL`;
29
+ quits rate `JTS000000000000000QUR`; ECI `CIS1010000000000I`; productivity `PRS85006092`; state
30
+ unemployment `LASST<fips>0000000000003`.
31
+
32
+ ## Spec examples
33
+ ```json
34
+ {"description": "CPI-U all items, U.S. city average, 2017-2026",
35
+ "series": [{"id": "CUUR0000SA0", "label": "CPI-U all items (NSA)"}],
36
+ "start_year": 2017, "end_year": 2026}
37
+ ```
38
+ ```json
39
+ {"description": "Unemployment rate and nonfarm payrolls, 2017-2026",
40
+ "series": [{"id": "LNS14000000", "label": "Unemployment rate"},
41
+ {"id": "CES0000000001", "label": "Total nonfarm payrolls"}],
42
+ "start_year": 2017, "end_year": 2026}
43
+ ```
44
+ ```json
45
+ {"description": "Maryland labor market and software developer wages",
46
+ "series": ["LNS13327709"],
47
+ "build": [{"kind": "state", "state": "MD"}, {"kind": "laus", "county": "24005"},
48
+ {"kind": "oews", "occupation": "15-1252", "measure": "annual_median_wage", "state": "MD"}],
49
+ "start_year": 2025, "end_year": 2026}
50
+ ```
51
+ Options: `annual_average`, `calculations` (BLS's 1/3/6/12-month changes, the best benchmark) and `catalog`
52
+ need a key; without one they are dropped and request.json records that. Ask for one extra year before the
53
+ start when computing 12-month changes. Tools: `request_schema` (the spec format; a search such as
54
+ `describe CUUR0000SA0` gives a series' title and dimensions), `fetch` with the spec (without a key it takes the
55
+ keyless route and drops the key-only options), and `manual_bundle` then `ingest` for files the user downloads.
56
+
57
+ ## Data format and traps
58
+ Output in `data/bls/`: `bls_series.csv` (series_id, label, year, period, period_name, freq, date,
59
+ value, value_raw, preliminary, footnote_codes, footnotes, latest; plus `bls_net_*m` / `bls_pct_*m` with
60
+ calculations), `series.csv` (title, title_source, survey, seasonal, frequency, first/last period, n_obs,
61
+ n_missing, n_preliminary, has_annual_average, bls_messages), `raw/response_NN.json`, `request.json`, `README.md`.
62
+ Build tables from `bls_series.csv` with `compute` (filter by series_id, `pivot_wider` on date for one column per
63
+ series) and register cited numbers with `facts`.
64
+ - **Wrong series is the classic silent error**: SA vs NSA (third letter S/U), U-3 vs U-6, all employees vs
65
+ production workers, levels in thousands (CES, CPS, JOLTS levels) vs rates, CPI is an index (1982-84=100),
66
+ never a price. Read every title (`request_schema` search with the IDs) before use.
67
+ - **Missing values**: BLS shows `-` (value empty, footnote says why), or returns no row at all for the period
68
+ (some CPI items in November 2025): `series.csv` counts both in `n_missing` and lists the second kind in
69
+ `absent_periods`. October 2025 was not collected for the CPI, CPS and LAUS (lapse in appropriations); CPS weekly earnings 2025 Q4 not produced. A change across a
70
+ gap is missing: match each value to the period a month or year earlier by date, never by row position (a
71
+ `lag()` over rows silently steps over an absent period). BLS's FAQ on the lapse says
72
+ October 2025 rents were carried forward from April 2025, which held down shelter and core CPI from November
73
+ 2025 to about April 2026: say so when a change spans those months.
74
+ - **Preliminary values** carry footnote `P` (`preliminary` = 1) per series, not per row: national CES the two latest (state and metro CES, SM, only the latest)
75
+ months, JOLTS and LAUS the latest month. Label them "preliminary" wherever cited. Import/export price
76
+ indexes (MXP, `EI...`) are revised for three months after release but carry no `P` flag: register those
77
+ months in `facts` with `preliminary: true` yourself. MXP indexes are not seasonally adjusted (use NSA for every change).
78
+ - **Revisions**: CES revises two prior months each release and benchmarks each February; CPI seasonal
79
+ factors are revised each February for five years; LAUS and state CES are model-based and revised each
80
+ March; chained CPI-U is interim for 10 to 12 months. State the retrieval date.
81
+ - **Federal employment (CES)**: `CES9091000001` federal, `CES9091100001` except USPS (the closest match to
82
+ OPM's FWD, which leaves out USPS), `CES9091912001` USPS. CES counts anyone paid for the pay period that
83
+ includes the 12th: employees on paid leave or ongoing severance and furloughed staff paid later are
84
+ employed, so 2025's deferred resignations left CES only when they came off payrolls (October 2025, first
85
+ printed as -179,000; Economics Daily, "Federal employment reached lowest level since 2014"). OPM counts
86
+ on-board staff on the month's last day: the two differ in timing as well as coverage.
87
+ - **CPS January population controls** (footnote 12): levels jump December to January; compare rates.
88
+ - **BLS answers HTTP 200 on failure**; the pack checks `status`. A bad ID returns no data with a message
89
+ ("Series does not exist", "No Data Available for Series X Year: 2026"): fetch lists it in `problems`.
90
+ v1 silently truncates to 10 years; the pack splits requests so this cannot happen and stops if it does.
91
+ - **OEWS** (period A01) returns only the latest survey year (2025 on 2026-10-20), with May of that year as
92
+ the reference period (the CSV's July 1 `date` is a placeholder). BLS still defines a top-code footnote
93
+ ("equal to or greater than $115.00 per hour or $239,200 per year", May 2025), but values above it are
94
+ published as point estimates when BLS has them (anesthesiologists' national median 391,490 with no
95
+ footnote, verified 2026-10-22): read `footnotes` per value; only a footnoted value is a bound ("at least"). County LAUS is NSA only and lags a month.
96
+ - **Productivity and costs (PR)**: BLS's annual change comes from annual output over annual hours, not the
97
+ mean of the quarterly indexes (2025 productivity on 2026-10 data: quarterly mean 2.5, published 2.1): take annual PR
98
+ figures from the release's annual table (save it in published/) or the annual period. The latest quarters
99
+ are revised each release without a `P` flag: register them in `facts` with `preliminary: true`.
100
+ - **Annual medians**: CPS median usual weekly earnings (LEU/LES, quarterly) have annual medians that BLS
101
+ computes from the year's sample, not from the quarters (2024 high school graduates: published 930, mean of
102
+ quarters 935). Take them from v2 `annual_average` (period Q05), from FRED's annual copies (`<id>A`, e.g.
103
+ `LEU0252917300A`, identical to BLS's tables) or from the annual table (cpsaat37) in `published/`.
104
+ By education (25 and over, full time): `request_schema` search `"weekly earnings education"`.
105
+ - **Annual averages**: prefer BLS's M13 (v2 + `annual_average`); never average a year with a missing month. Without a key, a mean of the 12 published (rounded) months can miss BLS's annual
106
+ average by 0.1 (2019 prime-age women's participation rate, LNU01300062: 76.05 rounds to 76.1, BLS publishes 76.0
107
+ from unrounded months; a mean that lands exactly on .x5 is a tie whichever way it rounds):
108
+ use BLS's published annual table (e.g. cpsaat03) in `published/` for the headline and show the computed
109
+ mean as the cross-check.
110
+ - **Rounding like BLS**: index percent changes from the published three-decimal values, rounded to one
111
+ decimal; rates to one decimal; payroll changes to the nearest thousand.
112
+ - **Significance**: monthly changes are "statistically significant" only beyond the published 90-percent
113
+ thresholds (CES about 122,000; unemployment rate about 0.3 point); otherwise
114
+ "little changed". Thresholds and other conventions: docs/analysis_patterns.md.
115
+ - Choices that change headline numbers (measure, SA/NSA, baseline, deflator): docs/analysis_patterns.md §1.
116
+
117
+ ## Access
118
+ - Key: optional, free at https://data.bls.gov/registrationEngine/ (emailed in minutes; **expires after a
119
+ year**). The user stores it with `npx -y data-analyst-mcp setup bls` in their own terminal; the server reads it
120
+ from BLS_API_KEY, BLS_API_KEY_FILE, keys.json, Claude Code settings.json or ~/.bls/api_key.
121
+ - Limits: v2 with a key 500 queries a day, 50 series and 20 years per query; v1 without a key 25 queries a
122
+ day (per IP), 25 series and 10 years per query; 50 requests per 10 seconds. fetch splits the request into
123
+ queries that fit these limits; it does not count the queries used today. BLS sometimes answers POSTs with
124
+ HTTP 503 "The BLS website is busy" (an HTML page) for hours (seen 2026-10-22, cleared the same day); fetch
125
+ then fails with `agency_unavailable`. Fetch once more later (do not loop), or use the fred pack for series FRED
126
+ mirrors (same values, but no preliminary flags or footnotes; FRED carries the headline CPS series, not detail
127
+ such as the prime-age ratios by sex LNS12300061/62).
128
+ - How fetch proceeds: a folder that already holds the same request is reused (`force: true` downloads again;
129
+ after a week BLS has probably published newer data). With a working key it uses v2. With no key, or a
130
+ rejected one, it takes keyless v1 when the request fits (25 queries a day): mention once that a key raises
131
+ the limits. A request too big for v1 with no key fails with `key_missing`: the user stores a key with
132
+ `npx -y data-analyst-mcp setup bls` in their own terminal; never ask for the key in chat. A used-up daily
133
+ limit fails with `agency_unavailable` (it resets the next day). A spec problem fails with `invalid_request`.
134
+ - Manual download: `manual_bundle` writes `manual_download/` with INSTRUCTIONS.md, `download_data.sh`,
135
+ `download_data.ps1`, spec.json and `manifest.json` (the POST requests built into both scripts, kept as a
136
+ record). Send the user INSTRUCTIONS.md and the scripts. Each script is self-contained and runs with one command
137
+ (`bash ~/Downloads/download_data.sh`, or `powershell -NoProfile -ExecutionPolicy Bypass -File
138
+ "$HOME\Downloads\download_data.ps1"`); it asks for the key with hidden input only when the request needs
139
+ v2 (`BLS_API_KEY` wins), saves `response_NN.json` next to itself and lists them for upload. Then call
140
+ `ingest` with the uploaded files or their folder; it reports any series and years no response covers.
141
+ - Key handling: BLS echoes a rejected key in its error text; the pack registers a 32-hex redaction pattern
142
+ and scrubs every message, raw file and request.json. Never print, log or pass the key on a command line.
143
+
144
+ ## Citation and terms
145
+ - Citation: "U.S. Bureau of Labor Statistics, <series IDs>, retrieved <Month D, YYYY> through the BLS Public
146
+ Data API (https://www.bls.gov/developers/)." `data/bls/README.md` has it filled in.
147
+ - Required statement (terms of service, https://www.bls.gov/developers/termsOfService.htm), with the
148
+ retrieval date, wherever BLS data are published: "BLS.gov cannot vouch for the data or analyses derived
149
+ from these data after the data have been retrieved from BLS.gov." Never use the BLS logo.
150
+ - Redistribution: allowed. BLS data are U.S. government works in the public domain; the data and raw
151
+ responses may go in a replication package.
152
+ - Audit hooks in policy.json: the report must state the retrieval date, carry the statement, call cited
153
+ preliminary values preliminary, and keep `data/bls/request.json`.
154
+ - Long references: docs/series_ids.md (ID structure, verified IDs, builders, common ID mix-ups),
155
+ docs/analysis_patterns.md (critical questions, conventions, significance, report layout),
156
+ docs/bls_api.md (API behaviour and errors, checked live).
@@ -0,0 +1,347 @@
1
+ {
2
+ "base_url": "https://data.bts.gov/resource",
3
+ "endpoints": {
4
+ "query": {
5
+ "path": "/{dataset}.json",
6
+ "method": "GET",
7
+ "description": "SODA query against any data.bts.gov dataset (catalog alias or 4x4 id).",
8
+ "params": {
9
+ "dataset": {
10
+ "in": "path",
11
+ "required": true,
12
+ "catalog": true,
13
+ "desc": "catalog alias (monthly_stats, border_crossings) or dataset id (crem-w557)"
14
+ },
15
+ "$select": {
16
+ "desc": "SoQL columns, e.g. 'date, transportation_services_index_freight'"
17
+ },
18
+ "$where": {
19
+ "desc": "SoQL filter; quote text and dates: state = 'Texas' AND date >= '2024-01-01'"
20
+ },
21
+ "$group": {
22
+ "desc": "SoQL group by, e.g. 'border, measure' with $select 'border, measure, sum(value)'"
23
+ },
24
+ "$order": {
25
+ "desc": "SoQL order; default :id gives stable paging"
26
+ },
27
+ "$q": {
28
+ "desc": "full-text search"
29
+ }
30
+ },
31
+ "defaults": {
32
+ "$order": ":id"
33
+ },
34
+ "records": "",
35
+ "paging": {
36
+ "type": "offset",
37
+ "limit_param": "$limit",
38
+ "offset_param": "$offset",
39
+ "size": 5000
40
+ },
41
+ "max_rows": 200000,
42
+ "missing": [
43
+ ""
44
+ ],
45
+ "flatten": true
46
+ },
47
+ "csv": {
48
+ "path": "/{dataset}.csv",
49
+ "method": "GET",
50
+ "description": "Same query as CSV (for manual download in a browser).",
51
+ "params": {
52
+ "dataset": {
53
+ "in": "path",
54
+ "required": true,
55
+ "catalog": true,
56
+ "desc": "alias or id"
57
+ },
58
+ "$select": {},
59
+ "$where": {},
60
+ "$group": {},
61
+ "$order": {}
62
+ },
63
+ "defaults": {
64
+ "$order": ":id"
65
+ },
66
+ "records": "$csv",
67
+ "paging": {
68
+ "type": "offset",
69
+ "limit_param": "$limit",
70
+ "offset_param": "$offset",
71
+ "size": 50000
72
+ },
73
+ "max_rows": 200000
74
+ }
75
+ },
76
+ "catalog": {
77
+ "monthly_stats": {
78
+ "id": "crem-w557",
79
+ "name": "Monthly Transportation Statistics",
80
+ "description": "One row per month (1947-present, most series start 2000 or later): airline traffic, on-time performance, transit ridership, freight rail, VMT, fuel prices, vehicle sales, fatalities, Transportation Services Index, border crossings, employment, construction spending. 136 columns (date, index, 134 indicators); see monthly_stats_fields.",
81
+ "endpoint": "query",
82
+ "page": "https://data.bts.gov/d/crem-w557"
83
+ },
84
+ "border_crossings": {
85
+ "id": "keg4-3bc2",
86
+ "name": "Border Crossing Entry Data",
87
+ "description": "Inbound crossings at U.S.-Canada and U.S.-Mexico land ports by port, state, month (1996-present) and measure (Trucks, Personal Vehicles, Personal Vehicle Passengers, Pedestrians, Buses, Bus Passengers, Trains, Train Passengers).",
88
+ "endpoint": "query",
89
+ "page": "https://data.bts.gov/d/keg4-3bc2"
90
+ },
91
+ "tsi": {
92
+ "id": "bw6n-ddqk",
93
+ "name": "Transportation Services Index and Seasonally-Adjusted Transportation Data",
94
+ "description": "Monthly TSI (freight, passenger, combined) with the seasonally adjusted component series.",
95
+ "endpoint": "query",
96
+ "page": "https://data.bts.gov/d/bw6n-ddqk"
97
+ },
98
+ "supply_chain": {
99
+ "id": "y5ut-ibwt",
100
+ "name": "Supply Chain and Freight Indicators",
101
+ "description": "Interagency freight and supply-chain indicators (port, rail, truck, air cargo).",
102
+ "endpoint": "query",
103
+ "page": "https://data.bts.gov/d/y5ut-ibwt"
104
+ },
105
+ "tet": {
106
+ "id": "tcq5-4pgu",
107
+ "name": "Transportation Economic Trends (TET) data",
108
+ "description": "Data behind BTS Transportation Economic Trends: GDP contribution, spending, employment, productivity.",
109
+ "endpoint": "query",
110
+ "page": "https://data.bts.gov/d/tcq5-4pgu"
111
+ },
112
+ "daily_mobility": {
113
+ "id": "w96p-f2qv",
114
+ "name": "Daily Mobility Statistics",
115
+ "description": "Daily trips and population staying home by national, state and county level (2019-2024; ended April 2024).",
116
+ "endpoint": "query",
117
+ "page": "https://data.bts.gov/d/w96p-f2qv"
118
+ },
119
+ "airfare_quarterly": {
120
+ "id": "h77j-murt",
121
+ "name": "Average Air Fare by Quarter",
122
+ "description": "Average domestic itinerary air fare by quarter (nominal and inflation-adjusted).",
123
+ "endpoint": "query",
124
+ "page": "https://data.bts.gov/d/h77j-murt"
125
+ },
126
+ "airfare_carrier": {
127
+ "id": "gjp5-nh2u",
128
+ "name": "Average Air Fare by Carrier",
129
+ "description": "Average domestic market air fare by carrier.",
130
+ "endpoint": "query",
131
+ "page": "https://data.bts.gov/d/gjp5-nh2u"
132
+ },
133
+ "t100_segment_origin": {
134
+ "id": "r495-tyji",
135
+ "name": "T-100 Segment Summary by Origin Airport",
136
+ "description": "Commercial air passengers, seats, freight and mail by origin airport and year.",
137
+ "endpoint": "query",
138
+ "page": "https://data.bts.gov/d/r495-tyji"
139
+ },
140
+ "t100_segment": {
141
+ "id": "bu82-4pwz",
142
+ "name": "T-100 Segment Summary",
143
+ "description": "Commercial air passengers, seats, freight and mail by year.",
144
+ "endpoint": "query",
145
+ "page": "https://data.bts.gov/d/bu82-4pwz"
146
+ },
147
+ "motor_fuel_sales": {
148
+ "id": "kbvr-tyu5",
149
+ "name": "Monthly Motor Fuel Sales Reported by States",
150
+ "description": "Monthly gasoline and special-fuel sales by state from the FHWA Monthly Motor Fuel Report.",
151
+ "endpoint": "query",
152
+ "page": "https://data.bts.gov/d/kbvr-tyu5"
153
+ },
154
+ "motor_fuel_tax": {
155
+ "id": "e5cn-ri8q",
156
+ "name": "Tax Rates by Motor Fuel and State",
157
+ "description": "Motor fuel tax rates by fuel type and state.",
158
+ "endpoint": "query",
159
+ "page": "https://data.bts.gov/d/e5cn-ri8q"
160
+ },
161
+ "vehicles_entering": {
162
+ "id": "btpt-uxhx",
163
+ "name": "Vehicles Entering U.S. by Country",
164
+ "description": "Passenger vehicles and trucks entering the United States from Canada and Mexico.",
165
+ "endpoint": "query",
166
+ "page": "https://data.bts.gov/d/btpt-uxhx"
167
+ },
168
+ "container_ports": {
169
+ "id": "sn74-xpkp",
170
+ "name": "Top 25 Container Ports by TEU",
171
+ "description": "Annual TEU volumes and rankings of the top 25 U.S. container ports.",
172
+ "endpoint": "query",
173
+ "page": "https://data.bts.gov/d/sn74-xpkp"
174
+ },
175
+ "bikeshare_ridership": {
176
+ "id": "6cfa-ipzd",
177
+ "name": "Docked Bikeshare Ridership",
178
+ "description": "Docked bikeshare trips by system and period.",
179
+ "endpoint": "query",
180
+ "page": "https://data.bts.gov/d/6cfa-ipzd"
181
+ },
182
+ "bikeshare_systems": {
183
+ "id": "cqdc-cm7d",
184
+ "name": "Bikeshare and E-scooter Systems by Year and City",
185
+ "description": "Cities served by docked, dockless bikeshare and e-scooter systems by year (2015-).",
186
+ "endpoint": "query",
187
+ "page": "https://data.bts.gov/d/cqdc-cm7d"
188
+ },
189
+ "state_tpfs": {
190
+ "id": "6aiz-ybqx",
191
+ "name": "Aggregate State Transportation Public Finance Statistics",
192
+ "description": "State and local transportation revenues and expenditures by state.",
193
+ "endpoint": "query",
194
+ "page": "https://data.bts.gov/d/6aiz-ybqx"
195
+ },
196
+ "transport_satellite": {
197
+ "id": "5yqg-88j3",
198
+ "name": "Transportation Satellite Accounts Table",
199
+ "description": "Contribution of transportation (in-house and for-hire) to GDP by industry.",
200
+ "endpoint": "query",
201
+ "page": "https://data.bts.gov/d/5yqg-88j3"
202
+ },
203
+ "air_fuel_efficiency": {
204
+ "id": "w8ea-nba4",
205
+ "name": "Air Carrier Fuel Efficiency by Year",
206
+ "description": "Air carrier fuel consumption and efficiency by year.",
207
+ "endpoint": "query",
208
+ "page": "https://data.bts.gov/d/w8ea-nba4"
209
+ }
210
+ },
211
+ "monthly_stats_fields": {
212
+ "safety_general_aviation": "Air Safety - General Aviation Fatalities",
213
+ "safety_highway_fatalities_1": "Highway Fatalities Per 100 Million Vehicle Miles Traveled",
214
+ "safety_highway_fatalities": "Highway Fatalities",
215
+ "system_use_u_s_airline_2": "U.S. Airline Traffic - Total - Seasonally Adjusted",
216
+ "system_use_u_s_airline_1": "U.S. Airline Traffic - International - Seasonally Adjusted",
217
+ "system_use_u_s_airline": "U.S. Airline Traffic - Domestic - Seasonally Adjusted",
218
+ "system_use_transit_ridership_2": "Transit Ridership - Other Transit Modes - Adjusted",
219
+ "system_use_transit_ridership_1": "Transit Ridership - Fixed Route Bus - Adjusted",
220
+ "system_use_transit_ridership": "Transit Ridership - Urban Rail - Adjusted",
221
+ "system_use_freight_rail_1": "Freight Rail Intermodal Units",
222
+ "system_use_freight_rail": "Freight Rail Carloads",
223
+ "system_use_highway_vehicle_4": "Highway Vehicle Miles Traveled - All Systems",
224
+ "system_use_highway_vehicle_3": "Highway Vehicle Miles Traveled - Total Rural",
225
+ "system_use_highway_vehicle_2": "Highway Vehicle Miles Traveled - Other Rural",
226
+ "system_use_highway_vehicle_1": "Highway Vehicle Miles Traveled - Rural Other Arterial",
227
+ "system_use_highway_vehicle": "Highway Vehicle Miles Traveled - Rural Interstate",
228
+ "capital_expenditures_state_65": "State and Local Government Construction Spending - Breakwater/Jetty",
229
+ "capital_expenditures_state_64": "State and Local Government Construction Spending - Dam/Levee",
230
+ "capital_expenditures_state_63": "State and Local Government Construction Spending - Conservation and Development",
231
+ "capital_expenditures_state_62": "State and Local Government Construction Spending - Pump Station",
232
+ "capital_expenditures_state_61": "State and Local Government Construction Spending - Line",
233
+ "capital_expenditures_state_60": "State and Local Government Construction Spending - Water Treatment Plant",
234
+ "capital_expenditures_state_59": "State and Local Government Construction Spending - Water Supply",
235
+ "capital_expenditures_state_58": "State and Local Government Construction Spending - Line/Drain",
236
+ "capital_expenditures_state_57": "State and Local Government Construction Spending - Waste Water Treatment Plant",
237
+ "capital_expenditures_state_56": "State and Local Government Construction Spending - Waste Water",
238
+ "capital_expenditures_state_55": "State and Local Government Construction Spending - Line/Pump Station",
239
+ "capital_expenditures_state_54": "State and Local Government Construction Spending - Sewage Treatment Plant",
240
+ "capital_expenditures_state_53": "State and Local Government Construction Spending - Sewage / Dry Waste",
241
+ "capital_expenditures_state_52": "State and Local Government Construction Spending - Sewage and Waste Disposal",
242
+ "capital_expenditures_state_51": "State and Local Government Construction Spending - Rest Facility",
243
+ "capital_expenditures_state_50": "State and Local Government Construction Spending - Bridge",
244
+ "capital_expenditures_state_49": "State and Local Government Construction Spending - Lighting",
245
+ "capital_expenditures_state_48": "State and Local Government Construction Spending - Pavement",
246
+ "capital_expenditures_state_47": "State and Local Government Construction Spending - Highway and Street",
247
+ "capital_expenditures_state_46": "State and Local Government Construction Spending - Power",
248
+ "capital_expenditures_state_45": "State and Local Government Construction Spending - Dock / Marina",
249
+ "capital_expenditures_state_44": "State and Local Government Construction Spending - Water",
250
+ "capital_expenditures_state_43": "State and Local Government Construction Spending - Mass Transit",
251
+ "capital_expenditures_state_42": "State and Local Government Construction Spending - Land Passenger Terminal",
252
+ "capital_expenditures_state_41": "State and Local Government Construction Spending - Land",
253
+ "capital_expenditures_state_40": "State and Local Government Construction Spending - Runway",
254
+ "capital_expenditures_state_39": "State and Local Government Construction Spending - Air Passenger Terminal",
255
+ "capital_expenditures_state_38": "State and Local Government Construction Spending - Air",
256
+ "capital_expenditures_state_37": "State and Local Government Construction Spending - Transportation",
257
+ "capital_expenditures_state_36": "State and Local Government Construction Spending - Park / Camp",
258
+ "capital_expenditures_state_35": "State and Local Government Construction Spending - Neighborhood Center",
259
+ "capital_expenditures_state_34": "State and Local Government Construction Spending - Social Center",
260
+ "capital_expenditures_state_33": "State and Local Government Construction Spending - Convention Center",
261
+ "capital_expenditures_state_32": "State and Local Government Construction Spending - Performance / Meeting Center",
262
+ "capital_expenditures_state_31": "State and Local Government Construction Spending - Sports",
263
+ "capital_expenditures_state_30": "State and Local Government Construction Spending - Amusement and Recreation",
264
+ "capital_expenditures_state_29": "State and Local Government Construction Spending - Fire & Rescue",
265
+ "capital_expenditures_state_28": "State and Local Government Construction Spending - Other Public Safety",
266
+ "capital_expenditures_state_27": "State and Local Government Construction Spending - Police & Sheriff",
267
+ "capital_expenditures_state_26": "State and Local Government Construction Spending - Detention",
268
+ "capital_expenditures_state_25": "State and Local Government Construction Spending - Correctional",
269
+ "capital_expenditures_state_24": "State and Local Government Construction Spending - Public Safety",
270
+ "capital_expenditures_state_23": "State and Local Government Construction Spending - Library / Archive",
271
+ "capital_expenditures_state_22": "State and Local Government Construction Spending - Other Educational",
272
+ "capital_expenditures_state_21": "State and Local Government Construction Spending - Infrastructure",
273
+ "capital_expenditures_state_20": "State and Local Government Construction Spending - Sports & Recreation",
274
+ "capital_expenditures_state_19": "State and Local Government Construction Spending - Dormitory",
275
+ "capital_expenditures_state_18": "State and Local Government Construction Spending - Instructional",
276
+ "capital_expenditures_state_17": "State and Local Government Construction Spending - Higher Education",
277
+ "capital_expenditures_state_16": "State and Local Government Construction Spending - High School",
278
+ "capital_expenditures_state_15": "State and Local Government Construction Spending - Middle School / Junior High",
279
+ "capital_expenditures_state_14": "State and Local Government Construction Spending - Elementary Schools",
280
+ "capital_expenditures_state_13": "State and Local Government Construction Spending - Primary/Secondary Schools",
281
+ "capital_expenditures_state_12": "State and Local Government Construction Spending - Educational",
282
+ "capital_expenditures_state_11": "State and Local Government Construction Spending - Special Care",
283
+ "capital_expenditures_state_10": "State and Local Government Construction Spending - Medical Building",
284
+ "capital_expenditures_state_9": "State and Local Government Construction Spending - Hospital",
285
+ "capital_expenditures_state_8": "State and Local Government Construction Spending - Health Care",
286
+ "capital_expenditures_state_7": "State and Local Government Construction Spending - Parking",
287
+ "capital_expenditures_state_6": "State and Local Government Construction Spending - Automotive",
288
+ "capital_expenditures_state_5": "State and Local Government Construction Spending - Commercial",
289
+ "capital_expenditures_state_4": "State and Local Government Construction Spending - Office",
290
+ "capital_expenditures_state_3": "State and Local Government Construction Spending - Non Residential",
291
+ "capital_expenditures_state_2": "State and Local Government Construction Spending - Multi Family",
292
+ "capital_expenditures_state_1": "State and Local Government Construction Spending - Residential",
293
+ "capital_expenditures_state": "State and Local Government Construction Spending - Total",
294
+ "capital_expenditures_fhwa": "National Highway Construction Cost Index (NHCCI)",
295
+ "highway_fuel_prices_on_highway": "Highway Fuel Price - On-highway Diesel",
296
+ "highway_fuel_prices_regular": "Highway Fuel Price - Regular Gasoline",
297
+ "transportation_economic_8": "Transportation Employment - Pipeline Transportation",
298
+ "transportation_economic_7": "Transportation Employment - Water Transportation",
299
+ "transportation_economic_6": "Transportation Employment - Rail Transportation",
300
+ "transportation_economic_5": "Transportation Employment - Air Transportation",
301
+ "transportation_economic_4": "Transportation Employment - Transit and ground passenger transportation",
302
+ "transportation_economic_3": "Transportation Employment - Truck Transportation",
303
+ "transportation_economic_2": "Personal Spending on Transportation - Transportation Services - Seasonally Adjusted",
304
+ "transportation_economic_1": "Personal Spending on Transportation - Gasoline and Other Energy Goods - Seasonally Adjusted",
305
+ "transportation_economic": "Personal Spending on Transportation - Motor Vehicles and Parts - Seasonally Adjusted",
306
+ "general_economic_indicators_3": "Unemployment Rate - Seasonally Adjusted",
307
+ "general_economic_indicators_2": "Labor Force Participation Rate - Seasonally Adjusted",
308
+ "general_economic_indicators_1": "Unemployed - Seasonally Adjusted",
309
+ "general_economic_indicators": "Real Gross Domestic Product - Seasonally Adjusted",
310
+ "passenger_rail_passengers": "Passenger Rail Passengers",
311
+ "passenger_rail_passenger_miles": "Passenger Rail Passenger Miles",
312
+ "passenger_rail_total_train_miles": "Passenger Rail Total Train Miles",
313
+ "passenger_rail_employee_hours_worked": "Passenger Rail Employee Hours Worked",
314
+ "passenger_rail_yard_switching_miles": "Passenger Rail Yard Switching Miles",
315
+ "passenger_rail_total_reports": "Passenger Rail Total Reports",
316
+ "u_s_waterway_tonnage": "U.S. Waterway Tonnage",
317
+ "amtrak_on_time_performance": "Amtrak On-time Performance",
318
+ "rail_fatalities": "Rail Fatalities",
319
+ "rail_fatalities_at_highway_rail_crossings": "Rail Fatalities at Highway-Rail Crossings",
320
+ "trespasser_fatalities_not_at_highwaya_rail_crossings": "Trespasser Fatalities Not at Highwaya-Rail Crossings",
321
+ "transportation_services_index_freight": "Transportation Services Index - Freight",
322
+ "transportation_services_index_passenger": "Transportation Services Index - Passenger",
323
+ "transportation_services_index_combined": "Transportation Services Index - Combined",
324
+ "u_s_canada_incoming_person_crossings": "U.S.-Canada Incoming Person Crossings",
325
+ "u_s_canada_incoming_truck_crossings": "U.S.-Canada Incoming Truck Crossings",
326
+ "u_s_mexico_incoming_person_crossings": "U.S.-Mexico Incoming Person Crossings",
327
+ "air_safety_air_taxi_and_commuter_fatalities": "Air Safety - Air Taxi and Commuter Fatalities",
328
+ "heavy_truck_sales": "Heavy truck sales",
329
+ "u_s_mexico_incoming_truck_crossings": "U.S.-Mexico Incoming Truck Crossings",
330
+ "light_truck_sales": "Light truck sales",
331
+ "auto_sales": "Auto sales",
332
+ "air_safety_air_carrier_fatalities": "Air Safety - Air Carrier Fatalities",
333
+ "u_s_air_carrier_cargo_millions_of_revenue_ton_miles_international": "U.S. Air Carrier Cargo (millions of revenue ton-miles) - International",
334
+ "truck_tonnage_index": "Truck tonnage index",
335
+ "u_s_air_carrier_cargo_millions_of_revenue_ton_miles_domestic": "U.S. Air Carrier Cargo (millions of revenue ton-miles) - Domestic",
336
+ "heavy_truck_sales_saar_millions": "Heavy truck sales SAAR (millions)",
337
+ "u_s_airline_traffic_total_non_seasonally_adjusted": "U.S. Airline Traffic - Total - Non Seasonally Adjusted",
338
+ "light_truck_sales_saar_millions": "Light truck sales SAAR (millions)",
339
+ "u_s_airline_traffic_international_non_seasonally_adjusted": "U.S. Airline Traffic - International - Non Seasonally Adjusted",
340
+ "auto_sales_saar_millions": "Auto sales SAAR (millions)",
341
+ "u_s_airline_traffic_domestic_non_seasonally_adjusted": "U.S. Airline Traffic - Domestic - Non Seasonally Adjusted",
342
+ "transborder_total_north_american_freight": "Transborder - Total North American Freight",
343
+ "transborder_u_s_mexico_freight": "Transborder - U.S. - Mexico Freight",
344
+ "u_s_marketing_air_carriers_on_time_performance_percent": "U.S. marketing air carriers on-time performance (percent)",
345
+ "transborder_u_s_canada_freight": "Transborder - U.S. - Canada Freight"
346
+ }
347
+ }
@@ -0,0 +1,94 @@
1
+ {
2
+ "id": "bts",
3
+ "title": "Bureau of Transportation Statistics Open Data (data.bts.gov)",
4
+ "agency": "U.S. Department of Transportation, Bureau of Transportation Statistics",
5
+ "depth": "standard",
6
+ "domains": [
7
+ "transportation",
8
+ "freight",
9
+ "travel"
10
+ ],
11
+ "keywords": [
12
+ "transportation",
13
+ "airline",
14
+ "air traffic",
15
+ "passengers",
16
+ "on-time",
17
+ "transit ridership",
18
+ "freight rail",
19
+ "rail",
20
+ "truck tonnage",
21
+ "vehicle miles traveled",
22
+ "vmt",
23
+ "gasoline price",
24
+ "diesel",
25
+ "auto sales",
26
+ "fatalities",
27
+ "transportation services index",
28
+ "tsi",
29
+ "border crossing",
30
+ "port of entry",
31
+ "trucks",
32
+ "pedestrians",
33
+ "air fare",
34
+ "airfare",
35
+ "bikeshare",
36
+ "container port",
37
+ "teu",
38
+ "motor fuel"
39
+ ],
40
+ "questions": [
41
+ "monthly airline passenger traffic trend",
42
+ "Transportation Services Index freight since 2019",
43
+ "truck crossings at the Texas-Mexico border by port",
44
+ "average domestic air fare by quarter",
45
+ "transit ridership recovery after 2020"
46
+ ],
47
+ "homepage": "https://data.bts.gov/",
48
+ "terms_url": "https://www.bts.gov/policies-and-notices",
49
+ "auth": {
50
+ "env": null,
51
+ "required": "none",
52
+ "placement": "none",
53
+ "signup_url": null,
54
+ "echoes_key": false
55
+ },
56
+ "limits": {
57
+ "rps": 2,
58
+ "burst": 5,
59
+ "max_rows": 200000
60
+ },
61
+ "routes": {
62
+ "api": {
63
+ "base": "https://data.bts.gov/resource",
64
+ "probe": "https://data.bts.gov/resource/crem-w557.json?$limit=1",
65
+ "hosts": [
66
+ "data.bts.gov"
67
+ ]
68
+ },
69
+ "manual": {
70
+ "how": "Open the dataset page (https://data.bts.gov/d/<id>, e.g. https://data.bts.gov/d/crem-w557), choose Export > CSV, and upload the file; or open the CSV links in INSTRUCTIONS.md."
71
+ }
72
+ },
73
+ "cache": {
74
+ "mode": "run_only",
75
+ "ttl_hours": null,
76
+ "why": "Queries are small and the monthly series are revised each release; data/ is reused within a run."
77
+ },
78
+ "redistribution": {
79
+ "mode": "allowed",
80
+ "why": "BTS statistics are U.S. government works in the public domain (17 U.S.C. 105); BTS asks for source attribution."
81
+ },
82
+ "notices": [],
83
+ "retention": null,
84
+ "citation": "Bureau of Transportation Statistics, {dataset}, data.bts.gov (Socrata API), retrieved {retrieved_long}.",
85
+ "audit_hooks": [],
86
+ "clarify": [
87
+ "Seasonally adjusted or not? Monthly Transportation Statistics carries both versions of airline traffic and transit ridership in different columns.",
88
+ "Border crossings: which measure (Trucks, Personal Vehicles, Personal Vehicle Passengers, Pedestrians, ...) and which border? Counts are inbound only."
89
+ ],
90
+ "formats": [
91
+ "json",
92
+ "csv"
93
+ ]
94
+ }