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,432 @@
1
+ {
2
+ "base_url": "https://www.ncei.noaa.gov",
3
+ "endpoints": {
4
+ "data": {
5
+ "path": "/access/services/data/v1",
6
+ "method": "GET",
7
+ "description": "Keyless NCEI Access Data Service: station observations (one row per station and date, one column per data type).",
8
+ "params": {
9
+ "dataset": {
10
+ "required": true,
11
+ "catalog": true,
12
+ "desc": "catalog alias (daily, monthly, annual, normals_monthly ...) or ADS dataset id (daily-summaries)"
13
+ },
14
+ "stations": {
15
+ "desc": "station id(s), comma-separated, e.g. USW00094728 (a GHCND: prefix is removed)",
16
+ "required": true
17
+ },
18
+ "startDate": {
19
+ "required": true,
20
+ "desc": "YYYY-MM-DD (also for monthly and annual datasets: ADS refuses YYYY-MM; the pack pads YYYY-MM to the 1st and YYYY to Jan 1)"
21
+ },
22
+ "endDate": {
23
+ "required": true,
24
+ "desc": "YYYY-MM-DD (the pack pads YYYY-MM to the month's last day and YYYY to Dec 31)"
25
+ },
26
+ "dataTypes": {
27
+ "desc": "comma-separated, case-sensitive: TMAX,TMIN,TAVG,PRCP,SNOW,SNWD,AWND ... (a misspelled type is silently absent)"
28
+ },
29
+ "units": {
30
+ "desc": "standard (F, inches; default here) or metric (C, mm); never omitted: without units GHCN-Daily values come in tenths",
31
+ "enum": [
32
+ "standard",
33
+ "metric"
34
+ ]
35
+ },
36
+ "includeAttributes": {
37
+ "desc": "true adds <TYPE>_ATTRIBUTES flag columns"
38
+ },
39
+ "includeStationName": {
40
+ "desc": "true adds NAME"
41
+ },
42
+ "includeStationLocation": {
43
+ "desc": "1 adds LATITUDE, LONGITUDE, ELEVATION"
44
+ }
45
+ },
46
+ "defaults": {
47
+ "format": "json",
48
+ "units": "standard"
49
+ },
50
+ "records": "",
51
+ "paging": {
52
+ "type": "none"
53
+ },
54
+ "max_rows": 500000,
55
+ "missing": [
56
+ ""
57
+ ],
58
+ "flatten": true
59
+ },
60
+ "station_search": {
61
+ "path": "/access/services/search/v1/data",
62
+ "method": "GET",
63
+ "description": "Keyless NCEI search: stations with data for a dataset in a bounding box and period (one row per station).",
64
+ "params": {
65
+ "dataset": {
66
+ "required": true,
67
+ "catalog": true,
68
+ "desc": "alias or ADS dataset id"
69
+ },
70
+ "bbox": {
71
+ "desc": "north,west,south,east"
72
+ },
73
+ "startDate": {
74
+ "desc": "YYYY-MM-DDT00:00:00"
75
+ },
76
+ "endDate": {
77
+ "desc": "YYYY-MM-DDT23:59:59"
78
+ },
79
+ "dataTypes": {
80
+ "desc": "comma-separated data types the station must have"
81
+ },
82
+ "stations": {
83
+ "desc": "station id(s), comma-separated, e.g. USW00094728: that station's period and data types (the free-text search was removed: `text` answers HTTP 400 \"Invalid search options\", verified 2026-10)"
84
+ }
85
+ },
86
+ "records": "results",
87
+ "total": "count",
88
+ "paging": {
89
+ "type": "offset",
90
+ "limit_param": "limit",
91
+ "offset_param": "offset",
92
+ "size": 100
93
+ },
94
+ "max_rows": 5000,
95
+ "missing": [
96
+ ""
97
+ ],
98
+ "flatten": true
99
+ },
100
+ "cdo_data": {
101
+ "path": "/cdo-web/api/v2/data",
102
+ "method": "GET",
103
+ "description": "Observations in long form (one row per station, date, data type) (CDO v2, needs NOAA_API_KEY)",
104
+ "params": {
105
+ "datasetid": {
106
+ "desc": "GHCND, GSOM, GSOY, NORMAL_DLY, NORMAL_MLY ...",
107
+ "required": true
108
+ },
109
+ "locationid": {
110
+ "desc": "FIPS:36 (state), FIPS:36061 (county), CITY:US360019 ..."
111
+ },
112
+ "stationid": {
113
+ "desc": "GHCND:USW00094728"
114
+ },
115
+ "datatypeid": {
116
+ "desc": "TMAX, PRCP ..."
117
+ },
118
+ "startdate": {
119
+ "desc": "YYYY-MM-DD",
120
+ "required": true
121
+ },
122
+ "enddate": {
123
+ "desc": "YYYY-MM-DD",
124
+ "required": true
125
+ },
126
+ "sortfield": {
127
+ "desc": "id, name, mindate, maxdate, datacoverage"
128
+ },
129
+ "sortorder": {
130
+ "desc": "asc or desc"
131
+ },
132
+ "extent": {
133
+ "desc": "stations only: south,west,north,east bounding box"
134
+ },
135
+ "locationcategoryid": {
136
+ "desc": "locations only: ST, CNTY, CITY, CLIM_REG, CNTRY ..."
137
+ }
138
+ },
139
+ "defaults": {
140
+ "offset": 1,
141
+ "units": "standard"
142
+ },
143
+ "records": "results",
144
+ "total": "metadata.resultset.count",
145
+ "paging": {
146
+ "type": "offset",
147
+ "limit_param": "limit",
148
+ "offset_param": "offset",
149
+ "size": 1000
150
+ },
151
+ "max_rows": 200000,
152
+ "missing": [
153
+ ""
154
+ ],
155
+ "flatten": true
156
+ },
157
+ "cdo_stations": {
158
+ "path": "/cdo-web/api/v2/stations",
159
+ "method": "GET",
160
+ "description": "Stations by dataset, location (FIPS) or extent (CDO v2, needs NOAA_API_KEY)",
161
+ "params": {
162
+ "datasetid": {
163
+ "desc": "GHCND, GSOM, GSOY, NORMAL_DLY, NORMAL_MLY ..."
164
+ },
165
+ "locationid": {
166
+ "desc": "FIPS:36 (state), FIPS:36061 (county), CITY:US360019 ..."
167
+ },
168
+ "stationid": {
169
+ "desc": "GHCND:USW00094728"
170
+ },
171
+ "datatypeid": {
172
+ "desc": "TMAX, PRCP ..."
173
+ },
174
+ "startdate": {
175
+ "desc": "YYYY-MM-DD"
176
+ },
177
+ "enddate": {
178
+ "desc": "YYYY-MM-DD"
179
+ },
180
+ "sortfield": {
181
+ "desc": "id, name, mindate, maxdate, datacoverage"
182
+ },
183
+ "sortorder": {
184
+ "desc": "asc or desc"
185
+ },
186
+ "extent": {
187
+ "desc": "stations only: south,west,north,east bounding box"
188
+ },
189
+ "locationcategoryid": {
190
+ "desc": "locations only: ST, CNTY, CITY, CLIM_REG, CNTRY ..."
191
+ }
192
+ },
193
+ "defaults": {
194
+ "offset": 1
195
+ },
196
+ "records": "results",
197
+ "total": "metadata.resultset.count",
198
+ "paging": {
199
+ "type": "offset",
200
+ "limit_param": "limit",
201
+ "offset_param": "offset",
202
+ "size": 1000
203
+ },
204
+ "max_rows": 20000,
205
+ "missing": [
206
+ ""
207
+ ],
208
+ "flatten": true
209
+ },
210
+ "cdo_locations": {
211
+ "path": "/cdo-web/api/v2/locations",
212
+ "method": "GET",
213
+ "description": "Location ids (states FIPS:nn, counties, cities, climate regions) (CDO v2, needs NOAA_API_KEY)",
214
+ "params": {
215
+ "datasetid": {
216
+ "desc": "GHCND, GSOM, GSOY, NORMAL_DLY, NORMAL_MLY ..."
217
+ },
218
+ "locationid": {
219
+ "desc": "FIPS:36 (state), FIPS:36061 (county), CITY:US360019 ..."
220
+ },
221
+ "stationid": {
222
+ "desc": "GHCND:USW00094728"
223
+ },
224
+ "datatypeid": {
225
+ "desc": "TMAX, PRCP ..."
226
+ },
227
+ "startdate": {
228
+ "desc": "YYYY-MM-DD"
229
+ },
230
+ "enddate": {
231
+ "desc": "YYYY-MM-DD"
232
+ },
233
+ "sortfield": {
234
+ "desc": "id, name, mindate, maxdate, datacoverage"
235
+ },
236
+ "sortorder": {
237
+ "desc": "asc or desc"
238
+ },
239
+ "extent": {
240
+ "desc": "stations only: south,west,north,east bounding box"
241
+ },
242
+ "locationcategoryid": {
243
+ "desc": "locations only: ST, CNTY, CITY, CLIM_REG, CNTRY ..."
244
+ }
245
+ },
246
+ "defaults": {
247
+ "offset": 1
248
+ },
249
+ "records": "results",
250
+ "total": "metadata.resultset.count",
251
+ "paging": {
252
+ "type": "offset",
253
+ "limit_param": "limit",
254
+ "offset_param": "offset",
255
+ "size": 1000
256
+ },
257
+ "max_rows": 50000,
258
+ "missing": [
259
+ ""
260
+ ],
261
+ "flatten": true
262
+ },
263
+ "cdo_datasets": {
264
+ "path": "/cdo-web/api/v2/datasets",
265
+ "method": "GET",
266
+ "description": "Dataset list with date coverage (CDO v2, needs NOAA_API_KEY)",
267
+ "params": {
268
+ "datasetid": {
269
+ "desc": "GHCND, GSOM, GSOY, NORMAL_DLY, NORMAL_MLY ..."
270
+ },
271
+ "locationid": {
272
+ "desc": "FIPS:36 (state), FIPS:36061 (county), CITY:US360019 ..."
273
+ },
274
+ "stationid": {
275
+ "desc": "GHCND:USW00094728"
276
+ },
277
+ "datatypeid": {
278
+ "desc": "TMAX, PRCP ..."
279
+ },
280
+ "startdate": {
281
+ "desc": "YYYY-MM-DD"
282
+ },
283
+ "enddate": {
284
+ "desc": "YYYY-MM-DD"
285
+ },
286
+ "sortfield": {
287
+ "desc": "id, name, mindate, maxdate, datacoverage"
288
+ },
289
+ "sortorder": {
290
+ "desc": "asc or desc"
291
+ },
292
+ "extent": {
293
+ "desc": "stations only: south,west,north,east bounding box"
294
+ },
295
+ "locationcategoryid": {
296
+ "desc": "locations only: ST, CNTY, CITY, CLIM_REG, CNTRY ..."
297
+ }
298
+ },
299
+ "defaults": {
300
+ "offset": 1
301
+ },
302
+ "records": "results",
303
+ "total": "metadata.resultset.count",
304
+ "paging": {
305
+ "type": "offset",
306
+ "limit_param": "limit",
307
+ "offset_param": "offset",
308
+ "size": 1000
309
+ },
310
+ "max_rows": 1000,
311
+ "missing": [
312
+ ""
313
+ ],
314
+ "flatten": true
315
+ },
316
+ "cdo_datatypes": {
317
+ "path": "/cdo-web/api/v2/datatypes",
318
+ "method": "GET",
319
+ "description": "Data types available for a dataset, station or location (CDO v2, needs NOAA_API_KEY)",
320
+ "params": {
321
+ "datasetid": {
322
+ "desc": "GHCND, GSOM, GSOY, NORMAL_DLY, NORMAL_MLY ..."
323
+ },
324
+ "locationid": {
325
+ "desc": "FIPS:36 (state), FIPS:36061 (county), CITY:US360019 ..."
326
+ },
327
+ "stationid": {
328
+ "desc": "GHCND:USW00094728"
329
+ },
330
+ "datatypeid": {
331
+ "desc": "TMAX, PRCP ..."
332
+ },
333
+ "startdate": {
334
+ "desc": "YYYY-MM-DD"
335
+ },
336
+ "enddate": {
337
+ "desc": "YYYY-MM-DD"
338
+ },
339
+ "sortfield": {
340
+ "desc": "id, name, mindate, maxdate, datacoverage"
341
+ },
342
+ "sortorder": {
343
+ "desc": "asc or desc"
344
+ },
345
+ "extent": {
346
+ "desc": "stations only: south,west,north,east bounding box"
347
+ },
348
+ "locationcategoryid": {
349
+ "desc": "locations only: ST, CNTY, CITY, CLIM_REG, CNTRY ..."
350
+ }
351
+ },
352
+ "defaults": {
353
+ "offset": 1
354
+ },
355
+ "records": "results",
356
+ "total": "metadata.resultset.count",
357
+ "paging": {
358
+ "type": "offset",
359
+ "limit_param": "limit",
360
+ "offset_param": "offset",
361
+ "size": 1000
362
+ },
363
+ "max_rows": 5000,
364
+ "missing": [
365
+ ""
366
+ ],
367
+ "flatten": true
368
+ }
369
+ },
370
+ "catalog": {
371
+ "daily": {
372
+ "id": "daily-summaries",
373
+ "name": "GHCN-Daily (CDO GHCND)",
374
+ "description": "daily max/min temperature, precipitation, snowfall, snow depth, wind by station",
375
+ "endpoint": "data"
376
+ },
377
+ "monthly": {
378
+ "id": "global-summary-of-the-month",
379
+ "name": "Global Summary of the Month (CDO GSOM)",
380
+ "description": "monthly mean/max/min temperature, total precipitation and snow, degree days",
381
+ "endpoint": "data"
382
+ },
383
+ "annual": {
384
+ "id": "global-summary-of-the-year",
385
+ "name": "Global Summary of the Year (CDO GSOY)",
386
+ "description": "annual temperature and precipitation summaries",
387
+ "endpoint": "data"
388
+ },
389
+ "normals_monthly": {
390
+ "id": "normals-monthly-1991-2020",
391
+ "name": "U.S. Climate Normals 1991-2020, monthly",
392
+ "description": "30-year monthly normals (MLY-TAVG-NORMAL, MLY-PRCP-NORMAL ...)",
393
+ "endpoint": "data"
394
+ },
395
+ "normals_daily": {
396
+ "id": "normals-daily-1991-2020",
397
+ "name": "U.S. Climate Normals 1991-2020, daily",
398
+ "description": "30-year daily normals (DLY-TMAX-NORMAL ...)",
399
+ "endpoint": "data"
400
+ },
401
+ "normals_annual": {
402
+ "id": "normals-annualseasonal-1991-2020",
403
+ "name": "U.S. Climate Normals 1991-2020, annual/seasonal",
404
+ "description": "annual and seasonal normals (ANN-TAVG-NORMAL ...)",
405
+ "endpoint": "data"
406
+ },
407
+ "hourly": {
408
+ "id": "global-hourly",
409
+ "name": "Global Hourly (ISD)",
410
+ "description": "hourly surface observations (large; short periods only)",
411
+ "endpoint": "data"
412
+ },
413
+ "GHCND": {
414
+ "id": "daily-summaries",
415
+ "name": "GHCND (CDO name)",
416
+ "description": "same as daily-summaries",
417
+ "endpoint": "data"
418
+ },
419
+ "GSOM": {
420
+ "id": "global-summary-of-the-month",
421
+ "name": "GSOM (CDO name)",
422
+ "description": "same as global-summary-of-the-month",
423
+ "endpoint": "data"
424
+ },
425
+ "GSOY": {
426
+ "id": "global-summary-of-the-year",
427
+ "name": "GSOY (CDO name)",
428
+ "description": "same as global-summary-of-the-year",
429
+ "endpoint": "data"
430
+ }
431
+ }
432
+ }
@@ -0,0 +1,95 @@
1
+ {
2
+ "id": "noaa",
3
+ "title": "NOAA NCEI climate data (Access Data Service, Climate Data Online)",
4
+ "agency": "National Centers for Environmental Information, National Oceanic and Atmospheric Administration",
5
+ "depth": "standard",
6
+ "domains": [
7
+ "weather",
8
+ "climate",
9
+ "environment"
10
+ ],
11
+ "keywords": [
12
+ "weather",
13
+ "climate",
14
+ "temperature",
15
+ "precipitation",
16
+ "rainfall",
17
+ "snowfall",
18
+ "snow",
19
+ "heat",
20
+ "cold",
21
+ "ghcn",
22
+ "ghcnd",
23
+ "daily weather",
24
+ "monthly temperature",
25
+ "climate normals",
26
+ "normals",
27
+ "weather station",
28
+ "ncei",
29
+ "noaa",
30
+ "historical weather",
31
+ "degree days"
32
+ ],
33
+ "questions": [
34
+ "daily high and low temperatures in a city last year",
35
+ "monthly precipitation at a station since 2000",
36
+ "how this year's temperature compares with the 1991-2020 normal",
37
+ "weather stations near a place",
38
+ "annual snowfall trend at a station"
39
+ ],
40
+ "homepage": "https://www.ncei.noaa.gov/",
41
+ "terms_url": "https://www.noaa.gov/disclaimer",
42
+ "auth": {
43
+ "env": "NOAA_API_KEY",
44
+ "required": "optional",
45
+ "placement": "header",
46
+ "param": "token",
47
+ "prefix": "",
48
+ "home": "noaa",
49
+ "signup_url": "https://www.ncei.noaa.gov/cdo-web/token",
50
+ "echoes_key": false,
51
+ "key_only": [
52
+ "Climate Data Online v2 endpoints (cdo_*): station and location search by FIPS code, data for a whole state or county, dataset and data-type lists"
53
+ ]
54
+ },
55
+ "limits": {
56
+ "rps": 4,
57
+ "burst": 5,
58
+ "daily_quota": 10000,
59
+ "max_rows": 500000
60
+ },
61
+ "routes": {
62
+ "api": {
63
+ "base": "https://www.ncei.noaa.gov",
64
+ "probe": "https://www.ncei.noaa.gov/access/services/data/v1?dataset=global-summary-of-the-year&stations=USW00094728&startDate=2020-01-01&endDate=2020-12-31&dataTypes=TAVG&format=json",
65
+ "hosts": [
66
+ "www.ncei.noaa.gov"
67
+ ]
68
+ },
69
+ "manual": {
70
+ "how": "Open each link in manual_download/INSTRUCTIONS.md in a browser (keyless Access Data Service; change format=json to format=csv for a spreadsheet) and upload the files. A station's whole record is one CSV: https://www.ncei.noaa.gov/data/daily-summaries/access/<STATION>.csv (also global-summary-of-the-month/access/ and global-summary-of-the-year/access/). Station finder: https://www.ncei.noaa.gov/cdo-web/ (Search Tool) or https://www.ncei.noaa.gov/access/search/data-search/daily-summaries."
71
+ }
72
+ },
73
+ "cache": {
74
+ "mode": "run_only",
75
+ "ttl_hours": null,
76
+ "why": "Recent days are revised as quality control runs; data/ is reused only within a run."
77
+ },
78
+ "redistribution": {
79
+ "mode": "allowed",
80
+ "why": "NOAA NCEI data are U.S. government works in the public domain (17 U.S.C. 105); NCEI asks that the data source be cited (GHCN-Daily: Menne et al., NOAA NCEI)."
81
+ },
82
+ "notices": [],
83
+ "retention": null,
84
+ "citation": "NOAA National Centers for Environmental Information, {dataset}, www.ncei.noaa.gov, retrieved {retrieved_long}.",
85
+ "audit_hooks": [],
86
+ "clarify": [
87
+ "Which station? A city has several (airport vs downtown); name the station id used, e.g. USW00094728 Central Park.",
88
+ "Daily, monthly or annual values, and which measure (TMAX, TMIN, TAVG, PRCP, SNOW)?",
89
+ "Compare with which normal? Default: U.S. Climate Normals 1991-2020."
90
+ ],
91
+ "formats": [
92
+ "json",
93
+ "csv"
94
+ ]
95
+ }
@@ -0,0 +1,88 @@
1
+ # NOAA NCEI climate data (Access Data Service, Climate Data Online)
2
+ Depth: standard. Key: optional (NOAA_API_KEY, only for the cdo_* endpoints). Historical station weather:
3
+ GHCN-Daily, monthly and annual summaries, 1991-2020 climate normals, hourly observations, station search.
4
+
5
+ ## When to use
6
+ - Observed daily, monthly or annual temperature, precipitation, snowfall, snow depth and wind at a
7
+ weather station, from the 1800s to a few days ago; 30-year climate normals; finding stations in an area.
8
+ - Not here: forecasts and active alerts (nws: those are not historical data), earthquakes and
9
+ streamflow (usgs), air pollution (epa-aqs), disaster declarations (fema).
10
+ - Prefer the keyless `data` and `station_search` endpoints (NCEI Access Data Service). Use the keyed
11
+ `cdo_*` endpoints only for what ADS cannot do: listing stations or data for a FIPS state/county
12
+ (`locationid`), and dataset/data-type lists.
13
+
14
+ ## Endpoints and datasets
15
+ | Endpoint | Returns | Key parameters |
16
+ |---|---|---|
17
+ | `data` (keyless) | one row per station and date, one column per data type (wide) | `dataset`, `stations`, `startDate`, `endDate`, `dataTypes`, `units` (standard default), `includeAttributes`, `includeStationName`, `includeStationLocation` |
18
+ | `station_search` (keyless) | one row per station: id, name, longitude, latitude, start/end date, data types | `dataset`, `bbox` (north,west,south,east), `startDate`, `endDate`, `dataTypes`, `stations` (no free-text search: `text` answers HTTP 400) |
19
+ | `cdo_data` (key) | long form: one row per station, date, data type (`value`, `attributes`) | `datasetid`, `startdate`, `enddate`, `stationid` or `locationid`, `datatypeid` |
20
+ | `cdo_stations`, `cdo_locations`, `cdo_datasets`, `cdo_datatypes` (key) | CDO metadata | `datasetid`, `locationid` (FIPS:36), `extent`, `locationcategoryid` |
21
+
22
+ `dataset` aliases (ADS id): `daily` / `GHCND` (daily-summaries), `monthly` / `GSOM`
23
+ (global-summary-of-the-month), `annual` / `GSOY` (global-summary-of-the-year), `normals_monthly`,
24
+ `normals_daily`, `normals_annual` (1991-2020 normals), `hourly` (global-hourly, very large).
25
+ Common data types: TMAX, TMIN, TAVG, PRCP, SNOW, SNWD, AWND; normals: MLY-TAVG-NORMAL,
26
+ MLY-PRCP-NORMAL, DLY-TMAX-NORMAL, ANN-TAVG-NORMAL.
27
+
28
+ ## Spec examples
29
+ ```json
30
+ {"description": "Central Park, NYC: daily weather in January 2024 and the monthly 1991-2020 normals",
31
+ "requests": [{"name": "cp_daily", "endpoint": "data",
32
+ "params": {"dataset": "daily", "stations": "USW00094728", "startDate": "2024-01-01",
33
+ "endDate": "2024-01-31", "dataTypes": "TMAX,TMIN,PRCP,SNOW"}},
34
+ {"name": "cp_normals", "endpoint": "data",
35
+ "params": {"dataset": "normals_monthly", "stations": "USW00094728", "startDate": "0001-01-01",
36
+ "endDate": "9996-12-31", "dataTypes": "MLY-TAVG-NORMAL,MLY-PRCP-NORMAL"}}]}
37
+ ```
38
+ ```json
39
+ {"description": "Daily-summary stations around Manhattan with data in January 2024",
40
+ "requests": [{"name": "near_manhattan", "endpoint": "station_search",
41
+ "params": {"dataset": "daily", "bbox": "40.9,-74.1,40.6,-73.8",
42
+ "startDate": "2024-01-01T00:00:00", "endDate": "2024-01-31T23:59:59"}}]}
43
+ ```
44
+ ```json
45
+ {"description": "GSOM stations in New York State (needs NOAA_API_KEY)",
46
+ "requests": [{"name": "ny_stations", "endpoint": "cdo_stations", "params": {"datasetid": "GSOM", "locationid": "FIPS:36"}}]}
47
+ ```
48
+
49
+ ## Data format and traps
50
+ - **Units**: the pack sends `units=standard` (degrees F, inches) unless the spec says `metric` (degrees C,
51
+ mm). Without `units`, GHCN-Daily values come as raw integers in tenths (TMAX 83 = 8.3 C, PRCP 8 =
52
+ 0.8 mm): never omit it. Values are not scaled when `units` is set.
53
+ - **Wide vs long**: `data` gives one column per data type; a type with no value that day is blank, and
54
+ a type never observed at the station is absent. Data type ids are case-sensitive: a misspelled or
55
+ lower-case type (`tmax`) is silently absent too (HTTP 200). The pack fails a request when none of its
56
+ types came back; when only some are missing, check the columns before reading a gap as no data. `cdo_data` gives one row per value.
57
+ - **Station ids**: ADS takes bare ids (USW00094728); CDO takes `GHCND:USW00094728` (the pack strips the
58
+ prefix for `data`). USW = first-order weather station, USC = cooperative, US1 = CoCoRaHS volunteer.
59
+ Name the station in the report; a city's airport and downtown stations differ.
60
+ - **Attributes** (`includeAttributes=true`): `<TYPE>_ATTRIBUTES` holds measurement, quality and source
61
+ flags (e.g. `,,W,2400`); a non-empty second field is a quality flag: consider dropping those values.
62
+ Trace precipitation is reported as 0.00 with a T measurement flag.
63
+ - **Monthly/annual summaries** (GSOM/GSOY) are computed only when enough days are present; missing
64
+ months are absent rows. DATE is YYYY-MM or YYYY, but `startDate`/`endDate` must be full dates even for
65
+ them (ADS answers HTTP 400 "Invalid ISO Date Time" to YYYY-MM; the pack pads YYYY-MM and YYYY). Normals DATE is the month (01-12) and use the
66
+ sentinel period 0001-01-01 to 9996-12-31.
67
+ - Recent days are preliminary and revised by quality control; data reach the API a few days after the observation (4 days on 2026-10-20).
68
+ - ADS returns everything in one response (no paging): keep long daily requests to a few stations.
69
+ - `station_search` returns the stations matching the area, dataset and period; `end_date` near today
70
+ means the station still reports. `data_types` lists every type ever recorded, not coverage.
71
+ - CDO v2 limits: 1,000 rows a page (the pack pages), 5 requests a second and 10,000 a day per token, and
72
+ a date range of at most 1 year (10 years for GSOM/GSOY) per request; the pack refuses longer ranges.
73
+
74
+ ## Access
75
+ `data` and `station_search` need no key. The `cdo_*` endpoints need a free token
76
+ (`NOAA_API_KEY`, sent as the `token` header; request it at https://www.ncei.noaa.gov/cdo-web/token);
77
+ without it only a spec with those requests stops, with `key_missing`, before calling CDO (which answers a
78
+ bare HTTP 400 "Token parameter is required"). Manual: the links `manual_bundle` writes to
79
+ `manual_download/INSTRUCTIONS.md` are keyless ADS URLs (change `format=json` to `format=csv` for a
80
+ spreadsheet); a station's whole daily record is one CSV at
81
+ https://www.ncei.noaa.gov/data/daily-summaries/access/<STATION>.csv (also
82
+ `global-summary-of-the-month/access/` and `global-summary-of-the-year/access/`); the CDO web search at
83
+ https://www.ncei.noaa.gov/cdo-web/ finds stations. Upload the files, then `ingest`.
84
+
85
+ ## Citation and terms
86
+ "NOAA National Centers for Environmental Information, <dataset> (e.g. Global Historical Climatology
87
+ Network - Daily), station <id>, www.ncei.noaa.gov, retrieved <date>." NOAA data are public domain (U.S.
88
+ government works); cite NCEI and the dataset. Redistribution allowed.