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,272 @@
1
+ {
2
+ "base_url": "https://api.weather.gov",
3
+ "headers": {
4
+ "Accept": "application/geo+json"
5
+ },
6
+ "endpoints": {
7
+ "forecast": {
8
+ "path": "/points/{lat},{lon}",
9
+ "resolve": "forecast",
10
+ "description": "7-day forecast in 12-hour periods for a point (resolves the forecast grid first). Not historical data.",
11
+ "params": {
12
+ "lat": {
13
+ "required": true,
14
+ "desc": "latitude, decimal degrees (4 decimals at most)"
15
+ },
16
+ "lon": {
17
+ "required": true,
18
+ "desc": "longitude, decimal degrees (negative west)"
19
+ }
20
+ },
21
+ "records": "properties.periods",
22
+ "paging": {
23
+ "type": "none"
24
+ },
25
+ "method": "GET",
26
+ "missing": [
27
+ ""
28
+ ],
29
+ "flatten": true
30
+ },
31
+ "forecast_hourly": {
32
+ "path": "/points/{lat},{lon}",
33
+ "resolve": "forecastHourly",
34
+ "description": "Hourly forecast for about 7 days for a point. Not historical data.",
35
+ "params": {
36
+ "lat": {
37
+ "required": true,
38
+ "desc": "latitude, decimal degrees (4 decimals at most)"
39
+ },
40
+ "lon": {
41
+ "required": true,
42
+ "desc": "longitude, decimal degrees (negative west)"
43
+ }
44
+ },
45
+ "records": "properties.periods",
46
+ "paging": {
47
+ "type": "none"
48
+ },
49
+ "method": "GET",
50
+ "missing": [
51
+ ""
52
+ ],
53
+ "flatten": true
54
+ },
55
+ "point": {
56
+ "path": "/points/{lat},{lon}",
57
+ "description": "Metadata for a point: forecast office, grid x/y, county and forecast zones, time zone.",
58
+ "params": {
59
+ "lat": {
60
+ "required": true,
61
+ "desc": "latitude, decimal degrees (4 decimals at most)"
62
+ },
63
+ "lon": {
64
+ "required": true,
65
+ "desc": "longitude, decimal degrees (negative west)"
66
+ }
67
+ },
68
+ "records": "properties",
69
+ "paging": {
70
+ "type": "none"
71
+ },
72
+ "method": "GET",
73
+ "missing": [
74
+ ""
75
+ ],
76
+ "flatten": true
77
+ },
78
+ "alerts_active": {
79
+ "path": "/alerts/active",
80
+ "description": "Active watches, warnings and advisories (one row per alert).",
81
+ "params": {
82
+ "area": {
83
+ "desc": "state/territory code(s): VT or VT,NH"
84
+ },
85
+ "zone": {
86
+ "desc": "zone id, e.g. VTZ006 or VTC023"
87
+ },
88
+ "point": {
89
+ "desc": "lat,lon"
90
+ },
91
+ "region": {
92
+ "desc": "marine region: AL, AT, GL, GM, PA, PI"
93
+ },
94
+ "event": {
95
+ "desc": "event name, e.g. Flood Warning (see alert_types)"
96
+ },
97
+ "severity": {
98
+ "desc": "Extreme, Severe, Moderate, Minor, Unknown"
99
+ },
100
+ "urgency": {
101
+ "desc": "Immediate, Expected, Future, Past, Unknown"
102
+ },
103
+ "certainty": {
104
+ "desc": "Observed, Likely, Possible, Unlikely, Unknown"
105
+ },
106
+ "status": {
107
+ "desc": "actual (default actual + others), exercise, system, test, draft"
108
+ },
109
+ "message_type": {
110
+ "desc": "alert, update, cancel"
111
+ }
112
+ },
113
+ "records": "features",
114
+ "paging": {
115
+ "type": "none"
116
+ },
117
+ "method": "GET",
118
+ "missing": [
119
+ ""
120
+ ],
121
+ "flatten": true
122
+ },
123
+ "alerts_recent": {
124
+ "path": "/alerts",
125
+ "description": "Recently issued alerts, newest first (the API keeps only recent ones; not an archive).",
126
+ "params": {
127
+ "area": {
128
+ "desc": "state/territory code(s): VT or VT,NH"
129
+ },
130
+ "zone": {
131
+ "desc": "zone id, e.g. VTZ006 or VTC023"
132
+ },
133
+ "point": {
134
+ "desc": "lat,lon"
135
+ },
136
+ "region": {
137
+ "desc": "marine region: AL, AT, GL, GM, PA, PI"
138
+ },
139
+ "event": {
140
+ "desc": "event name, e.g. Flood Warning (see alert_types)"
141
+ },
142
+ "severity": {
143
+ "desc": "Extreme, Severe, Moderate, Minor, Unknown"
144
+ },
145
+ "urgency": {
146
+ "desc": "Immediate, Expected, Future, Past, Unknown"
147
+ },
148
+ "certainty": {
149
+ "desc": "Observed, Likely, Possible, Unlikely, Unknown"
150
+ },
151
+ "status": {
152
+ "desc": "actual (default actual + others), exercise, system, test, draft"
153
+ },
154
+ "message_type": {
155
+ "desc": "alert, update, cancel"
156
+ },
157
+ "start": {
158
+ "desc": "ISO 8601 time with offset, e.g. 2026-01-05T00:00:00Z; /alerts holds only the past seven days"
159
+ },
160
+ "end": {
161
+ "desc": "ISO 8601 time"
162
+ },
163
+ "limit": {
164
+ "desc": "alerts per page (the fetcher follows pagination.next)"
165
+ }
166
+ },
167
+ "records": "features",
168
+ "paging": {
169
+ "type": "link",
170
+ "next": "pagination.next",
171
+ "max_pages": 20
172
+ },
173
+ "max_rows": 5000,
174
+ "method": "GET",
175
+ "missing": [
176
+ ""
177
+ ],
178
+ "flatten": true
179
+ },
180
+ "alert_types": {
181
+ "path": "/alerts/types",
182
+ "description": "Every alert event name.",
183
+ "params": {},
184
+ "records": "eventTypes",
185
+ "paging": {
186
+ "type": "none"
187
+ },
188
+ "method": "GET",
189
+ "missing": [
190
+ ""
191
+ ],
192
+ "flatten": true
193
+ },
194
+ "stations_near": {
195
+ "path": "/points/{lat},{lon}/stations",
196
+ "description": "Observation stations near a point, nearest first.",
197
+ "params": {
198
+ "lat": {
199
+ "required": true,
200
+ "desc": "latitude, decimal degrees (4 decimals at most)"
201
+ },
202
+ "lon": {
203
+ "required": true,
204
+ "desc": "longitude, decimal degrees (negative west)"
205
+ }
206
+ },
207
+ "records": "features",
208
+ "paging": {
209
+ "type": "none"
210
+ },
211
+ "max_rows": 500,
212
+ "method": "GET",
213
+ "missing": [
214
+ ""
215
+ ],
216
+ "flatten": true
217
+ },
218
+ "observations": {
219
+ "path": "/stations/{station}/observations",
220
+ "description": "Recent observations at a station (about the last week), newest first; SI units.",
221
+ "params": {
222
+ "station": {
223
+ "in": "path",
224
+ "required": true,
225
+ "desc": "station id, e.g. KDCA"
226
+ },
227
+ "start": {
228
+ "desc": "ISO 8601 time"
229
+ },
230
+ "end": {
231
+ "desc": "ISO 8601 time"
232
+ },
233
+ "limit": {
234
+ "desc": "observations per page"
235
+ }
236
+ },
237
+ "records": "features",
238
+ "paging": {
239
+ "type": "link",
240
+ "next": "pagination.next",
241
+ "max_pages": 20
242
+ },
243
+ "max_rows": 5000,
244
+ "method": "GET",
245
+ "missing": [
246
+ ""
247
+ ],
248
+ "flatten": true
249
+ },
250
+ "observation_latest": {
251
+ "path": "/stations/{station}/observations/latest",
252
+ "description": "The latest observation at a station.",
253
+ "params": {
254
+ "station": {
255
+ "in": "path",
256
+ "required": true,
257
+ "desc": "station id, e.g. KDCA"
258
+ }
259
+ },
260
+ "records": "properties",
261
+ "paging": {
262
+ "type": "none"
263
+ },
264
+ "method": "GET",
265
+ "missing": [
266
+ ""
267
+ ],
268
+ "flatten": true
269
+ }
270
+ },
271
+ "catalog": {}
272
+ }
@@ -0,0 +1,82 @@
1
+ {
2
+ "id": "nws",
3
+ "title": "National Weather Service API (forecasts, alerts, observations)",
4
+ "agency": "National Weather Service, National Oceanic and Atmospheric Administration",
5
+ "depth": "standard",
6
+ "domains": [
7
+ "weather",
8
+ "emergency management"
9
+ ],
10
+ "keywords": [
11
+ "forecast",
12
+ "weather forecast",
13
+ "hourly forecast",
14
+ "weather alert",
15
+ "warning",
16
+ "watch",
17
+ "advisory",
18
+ "tornado warning",
19
+ "flood warning",
20
+ "heat advisory",
21
+ "winter storm",
22
+ "current weather",
23
+ "observation",
24
+ "nws",
25
+ "weather.gov"
26
+ ],
27
+ "questions": [
28
+ "the 7-day forecast for a place",
29
+ "active weather warnings in a state",
30
+ "current conditions at an airport station",
31
+ "alerts issued for a county in the last few days"
32
+ ],
33
+ "homepage": "https://www.weather.gov/documentation/services-web-api",
34
+ "terms_url": "https://www.weather.gov/disclaimer",
35
+ "auth": {
36
+ "env": null,
37
+ "required": "none",
38
+ "placement": "none",
39
+ "signup_url": null,
40
+ "echoes_key": false
41
+ },
42
+ "limits": {
43
+ "rps": 3,
44
+ "burst": 6,
45
+ "max_rows": 10000
46
+ },
47
+ "routes": {
48
+ "api": {
49
+ "base": "https://api.weather.gov",
50
+ "probe": "https://api.weather.gov/alerts/types",
51
+ "hosts": [
52
+ "api.weather.gov"
53
+ ]
54
+ },
55
+ "manual": {
56
+ "how": "Open each link in manual_download/INSTRUCTIONS.md in a browser and save the JSON under the name shown; for forecasts open the point link first, then the URL in its properties.forecast (or forecastHourly) field, and save that page. Upload the files. Without the links: https://forecast.weather.gov (type the place) shows the same forecast, and https://alerts.weather.gov lists active alerts."
57
+ }
58
+ },
59
+ "cache": {
60
+ "mode": "none",
61
+ "ttl_hours": null,
62
+ "why": "Forecasts update hourly and alerts by the minute; every run asks again."
63
+ },
64
+ "redistribution": {
65
+ "mode": "allowed",
66
+ "why": "NWS information is a U.S. government work in the public domain (17 U.S.C. 105; https://www.weather.gov/disclaimer); credit the National Weather Service."
67
+ },
68
+ "notices": [],
69
+ "retention": {
70
+ "upstream_days": 7,
71
+ "note": "The API serves current forecasts, active alerts, recent alerts and about the last week of observations only; it is not an archive. Record the retrieval time."
72
+ },
73
+ "citation": "National Weather Service, {dataset}, api.weather.gov, retrieved {retrieved_long}.",
74
+ "audit_hooks": [],
75
+ "clarify": [
76
+ "Forecast, current conditions, or past weather? Forecasts are not historical data; past weather comes from noaa (station observations) instead."
77
+ ],
78
+ "formats": [
79
+ "json",
80
+ "geojson"
81
+ ]
82
+ }
@@ -0,0 +1,81 @@
1
+ # National Weather Service API (forecasts, alerts, observations)
2
+ Depth: standard. Key: none (an identifying User-Agent is sent). Current U.S. forecasts (7-day and
3
+ hourly), active and recent watches/warnings/advisories, and the latest week of station observations.
4
+
5
+ ## When to use
6
+ - "What is the forecast", "which warnings are in effect", "current conditions at a station", "alerts
7
+ issued for a state in the last few days".
8
+ - **Forecasts are not historical data.** They change every hour and the API keeps no forecast archive;
9
+ report the retrieval time (`generated_at`) with any forecast. Past weather (observed temperature,
10
+ precipitation, normals) comes from noaa; past disasters from fema. The API keeps only the alerts
11
+ issued in the past seven days (`/alerts`; NCEI holds the official archive) and seven days of observations.
12
+ - Coverage: the United States and its territories and adjacent waters; other points have no forecast.
13
+
14
+ ## Endpoints and datasets
15
+ | Endpoint | Returns | Parameters |
16
+ |---|---|---|
17
+ | `forecast` | 14 twelve-hour periods (about 7 days): temperature (F), wind, precipitation chance, short and detailed text, plus `office`, `grid_x`, `grid_y`, `generated_at` | `lat`, `lon` |
18
+ | `forecast_hourly` | about 156 hourly periods | `lat`, `lon` |
19
+ | `point` | one row: forecast office (`gridId`), grid, zones, county, time zone | `lat`, `lon` |
20
+ | `alerts_active` | one row per alert in effect now | `area` (state code), `zone`, `point` (lat,lon), `event`, `severity`, `urgency`, `certainty`, `status`, `message_type` |
21
+ | `alerts_recent` | alerts issued in the past seven days, newest first (paged); an earlier `start` returns nothing older | the same, plus `start`, `end`, `limit` |
22
+ | `alert_types` | every alert event name | none |
23
+ | `stations_near` | observation stations near a point, nearest first, with `distance.value` (m) | `lat`, `lon` |
24
+ | `observations` | observations at a station (about the last 7 days), newest first | `station` (e.g. KDCA), `start`, `end`, `limit` |
25
+ | `observation_latest` | the latest observation | `station` |
26
+
27
+ ## Spec examples
28
+ ```json
29
+ {"description": "Washington, DC: 7-day forecast and the nearest stations",
30
+ "requests": [{"name": "dc_forecast", "endpoint": "forecast", "params": {"lat": 38.8894, "lon": -77.0352}},
31
+ {"name": "dc_stations", "endpoint": "stations_near", "params": {"lat": 38.8894, "lon": -77.0352}, "max_rows": 10}]}
32
+ ```
33
+ ```json
34
+ {"description": "Weather alerts in effect in New Mexico, and severe ones issued in the past seven days",
35
+ "requests": [{"name": "nm_alerts", "endpoint": "alerts_active", "params": {"area": "NM"}, "allow_empty": true},
36
+ {"name": "nm_recent_severe", "endpoint": "alerts_recent",
37
+ "params": {"area": "NM", "severity": "Severe"}, "allow_empty": true}]}
38
+ ```
39
+ ```json
40
+ {"description": "Last 24 observations at Reagan National Airport",
41
+ "requests": [{"name": "dca_obs", "endpoint": "observations", "params": {"station": "KDCA", "limit": 24}, "max_rows": 24}]}
42
+ ```
43
+
44
+ ## Data format and traps
45
+ - **Units differ by product.** Forecasts are in U.S. units (`temperatureUnit` F; `windSpeed` text such
46
+ as "5 to 10 mph"). Observations are SI with a unit per field: `temperature.value` in degrees C
47
+ (`wmoUnit:degC`), `windSpeed.value` in km/h, pressure in Pa, visibility and elevation in m. Convert
48
+ explicitly. Blank values are missing sensors; `*.qualityControl` flags (MADIS codes) say how far to trust a value: Z preliminary, no QC;
49
+ C coarse pass (level 1); S screened (levels 1-2); V verified (levels 1-3); Q questioned (passed 1, failed
50
+ 2 or 3); X rejected; G / B subjectively good / bad; T air temperature returned where virtual temperature
51
+ could not be computed (https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml).
52
+ - **Time zones**: forecast `startTime`/`endTime` carry the local offset (-04:00); observation
53
+ `timestamp` and alert times are ISO 8601 with offsets; compare as aware datetimes.
54
+ - **Empty is an answer for alerts**: no active alerts in an area is a normal result. Set
55
+ `"allow_empty": true` on alert requests (the pack also reports an empty active-alert result in the
56
+ notes instead of failing).
57
+ - Alerts: `id` is the alert URN; `event` names the hazard (Flood Warning, Heat Advisory ...);
58
+ `messageType` alert/update/cancel, so one hazard can appear as several messages; count unique
59
+ `event` + `areaDesc` + `onset` or use `references` to de-duplicate. Alert polygons are not kept.
60
+ `areaDesc` lists zones or counties, separated by "; ".
61
+ - `area` takes state and territory codes (VT, PR, GU); marine areas use `region`.
62
+ - Points take at most 4 decimal places (the pack rounds). A forecast grid is 2.5 km; offices
63
+ (`gridId`) are 3-letter codes such as LWX.
64
+ - Booleans are written `True`/`False` (`isDaytime`). `probabilityOfPrecipitation.value` is a percent
65
+ and may be blank.
66
+ - The API sometimes answers 500/503 for a minute when a forecast office's grid is updating; the
67
+ fetcher retries twice, then run again.
68
+
69
+ ## Access
70
+ No key. NWS asks clients to send an identifying User-Agent; the pack sends its own, and
71
+ `NWS_USER_AGENT` (e.g. "my-analysis (me@example.com)") replaces it. NWS says the User-Agent will be
72
+ replaced by an API key in the future (not yet as of 2026-10); if requests start failing with HTTP
73
+ 401/403, check https://www.weather.gov/documentation/services-web-api for a key. `fetch` works when api.weather.gov
74
+ answers. Manual: open the links `manual_bundle` writes to `manual_download/INSTRUCTIONS.md` in a browser and save the JSON
75
+ (for forecasts, open the point link, then the URL in its `properties.forecast` field, and save that page);
76
+ or read https://forecast.weather.gov and https://alerts.weather.gov. Upload the files, then `ingest`.
77
+
78
+ ## Citation and terms
79
+ "National Weather Service, <product, e.g. 7-day forecast for 38.8894,-77.0352 issued <generated_at>>,
80
+ api.weather.gov, retrieved <date and time>." NWS information is public domain (U.S. government work;
81
+ https://www.weather.gov/disclaimer). Redistribution allowed; credit NWS and do not imply endorsement.
@@ -0,0 +1,80 @@
1
+ {
2
+ "base_url": "https://markets.newyorkfed.org/api",
3
+ "timeout": 60,
4
+ "endpoints": {
5
+ "rates": {
6
+ "path": "/rates/{family}/{ratetype}/search.json",
7
+ "description": "Daily reference rate with percentiles and volume, one row per business day: secured (sofr, tgcr, bgcr) or unsecured (effr, obfr). Rows come newest first.",
8
+ "params": {
9
+ "family": {"in": "path", "required": true, "enum": ["secured", "unsecured"], "desc": "secured (SOFR, TGCR, BGCR) or unsecured (EFFR, OBFR)"},
10
+ "ratetype": {"in": "path", "required": true, "enum": ["sofr", "tgcr", "bgcr", "effr", "obfr"], "desc": "rate name, lower case; it must belong to the family"},
11
+ "startDate": {"desc": "first effective date, YYYY-MM-DD"},
12
+ "endDate": {"desc": "last effective date, YYYY-MM-DD"}
13
+ },
14
+ "records": "refRates",
15
+ "paging": {"type": "none"}
16
+ },
17
+ "soma_summary": {
18
+ "path": "/soma/summary.json",
19
+ "description": "Weekly (Wednesday) SOMA holdings totals in dollars by asset class (bills, notes and bonds, TIPS, FRN, MBS, agencies) since 2003-07-09: the whole history, about 1,200 rows.",
20
+ "params": {},
21
+ "records": "soma.summary",
22
+ "paging": {"type": "none"}
23
+ },
24
+ "soma_tsy_holdings": {
25
+ "path": "/soma/tsy/get/asof/{date}.json",
26
+ "description": "SOMA Treasury holdings on one as-of date, one row per CUSIP: maturity date, coupon, par value, inflation compensation, share of the issue outstanding, security type (Bills, NotesBonds, TIPS, FRN).",
27
+ "params": {
28
+ "date": {"in": "path", "required": true, "desc": "an as-of date from soma_asofdates, YYYY-MM-DD"}
29
+ },
30
+ "records": "soma.holdings",
31
+ "paging": {"type": "none"}
32
+ },
33
+ "soma_tsy_wam": {
34
+ "path": "/soma/tsy/wam/{holdingtype}/asof/{date}.json",
35
+ "description": "Weighted average maturity, in years, of the SOMA Treasury holdings on one as-of date. One row.",
36
+ "params": {
37
+ "holdingtype": {"in": "path", "required": true, "enum": ["all", "bills", "notesbonds", "tips", "frn"], "desc": "all, or one security type"},
38
+ "date": {"in": "path", "required": true, "desc": "an as-of date from soma_asofdates, YYYY-MM-DD"}
39
+ },
40
+ "records": "soma",
41
+ "paging": {"type": "none"}
42
+ },
43
+ "soma_asofdates": {
44
+ "path": "/soma/asofdates/list.json",
45
+ "description": "Every SOMA as-of date published, as one column (asOfDate).",
46
+ "params": {},
47
+ "records": "soma.asOfDates",
48
+ "paging": {"type": "none"}
49
+ },
50
+ "tsy_operations": {
51
+ "path": "/tsy/{operation}/results/{include}/search.json",
52
+ "description": "Fed Treasury purchase or sale operations in a date range, one row per operation (include=summary) or with the securities bought as JSON text in a details column (include=details).",
53
+ "params": {
54
+ "operation": {"in": "path", "required": true, "enum": ["purchases", "sales", "all"], "desc": "purchases, sales or all"},
55
+ "include": {"in": "path", "required": true, "enum": ["summary", "details"], "desc": "summary (one row per operation) or details (adds the securities)"},
56
+ "startDate": {"desc": "first operation date, YYYY-MM-DD"},
57
+ "endDate": {"desc": "last operation date, YYYY-MM-DD"}
58
+ },
59
+ "records": "treasury.auctions",
60
+ "paging": {"type": "none"}
61
+ },
62
+ "pd_series": {
63
+ "path": "/pd/get/{timeseries}.json",
64
+ "description": "One primary dealer statistics series (positions, financing, transactions), weekly since 2013, in millions of dollars: one row per as-of date (asofdate, keyid, value).",
65
+ "params": {
66
+ "timeseries": {"in": "path", "required": true, "desc": "series key from pd_catalog, e.g. PDPOSGST-TOT (net Treasury positions)", "catalog": true}
67
+ },
68
+ "records": "pd.timeseries",
69
+ "paging": {"type": "none"}
70
+ },
71
+ "pd_catalog": {
72
+ "path": "/pd/list/timeseries.json",
73
+ "description": "Every primary dealer series key with its series break and description (about 1,500 rows; search it for the key you need).",
74
+ "params": {},
75
+ "records": "pd.timeseries",
76
+ "paging": {"type": "none"}
77
+ }
78
+ },
79
+ "catalog": {}
80
+ }
@@ -0,0 +1,92 @@
1
+ {
2
+ "id": "nyfed",
3
+ "title": "New York Fed Markets Data API (reference rates, SOMA, Treasury operations, primary dealers)",
4
+ "agency": "Federal Reserve Bank of New York",
5
+ "depth": "standard",
6
+ "domains": [
7
+ "monetary policy",
8
+ "interest rates",
9
+ "federal debt financing",
10
+ "financial conditions"
11
+ ],
12
+ "keywords": [
13
+ "sofr",
14
+ "effr",
15
+ "federal funds rate",
16
+ "effective federal funds rate",
17
+ "obfr",
18
+ "tgcr",
19
+ "bgcr",
20
+ "reference rate",
21
+ "overnight rate",
22
+ "soma",
23
+ "system open market account",
24
+ "fed holdings",
25
+ "fed balance sheet",
26
+ "treasury holdings",
27
+ "quantitative tightening",
28
+ "runoff",
29
+ "reserve management purchases",
30
+ "primary dealer",
31
+ "dealer positions",
32
+ "open market operations",
33
+ "reverse repo",
34
+ "debt service",
35
+ "interest cost",
36
+ "term premium",
37
+ "monetary policy"
38
+ ],
39
+ "questions": [
40
+ "how much of the Treasury debt does the Federal Reserve hold, by maturity",
41
+ "SOFR and the effective federal funds rate over the last year, as an input to a debt-service projection",
42
+ "weighted average maturity of the Fed's Treasury holdings",
43
+ "Fed purchases of Treasury bills in recent weeks",
44
+ "primary dealer net positions in Treasury securities"
45
+ ],
46
+ "homepage": "https://markets.newyorkfed.org/static/docs/markets-api.html",
47
+ "terms_url": "https://www.newyorkfed.org/terms-of-use",
48
+ "auth": {
49
+ "env": null,
50
+ "required": "none",
51
+ "placement": "none",
52
+ "signup_url": null,
53
+ "echoes_key": false
54
+ },
55
+ "limits": {
56
+ "rps": 1,
57
+ "burst": 3,
58
+ "max_rows": 100000
59
+ },
60
+ "routes": {
61
+ "api": {
62
+ "base": "https://markets.newyorkfed.org/api",
63
+ "probe": "https://markets.newyorkfed.org/api/soma/asofdates/latest.json",
64
+ "hosts": [
65
+ "markets.newyorkfed.org"
66
+ ]
67
+ },
68
+ "manual": {
69
+ "how": "Open each link in manual_download/INSTRUCTIONS.md in a browser and save the JSON page (File > Save as) under the name shown, then upload it. Without the links: reference rates at https://www.newyorkfed.org/markets/reference-rates, SOMA holdings at https://www.newyorkfed.org/markets/soma-holdings (Download), Treasury operations at https://www.newyorkfed.org/markets/desk-operations/treasury, primary dealer statistics at https://www.newyorkfed.org/markets/counterparties/primary-dealers-statistics."
70
+ }
71
+ },
72
+ "cache": {
73
+ "mode": "run_only",
74
+ "ttl_hours": null,
75
+ "why": "Rates and operations update daily, SOMA weekly; data/ is reused only within a run."
76
+ },
77
+ "redistribution": {
78
+ "mode": "allowed",
79
+ "why": "The Markets Data APIs are published openly by the Federal Reserve Bank of New York for public use; the Bank's terms of use allow use of its published data with attribution."
80
+ },
81
+ "notices": [],
82
+ "retention": null,
83
+ "citation": "Federal Reserve Bank of New York, Markets Data APIs ({dataset}), markets.newyorkfed.org, retrieved {retrieved_long}.",
84
+ "audit_hooks": [],
85
+ "clarify": [
86
+ "Which rate: SOFR (secured, Treasury repo), EFFR (unsecured, the policy-rate benchmark) or another? Default: both, stated as separate series.",
87
+ "Which date for SOMA holdings: the latest weekly as-of date, or a past date for a comparison? Default: the latest (see source.md for how to find it)."
88
+ ],
89
+ "formats": [
90
+ "json"
91
+ ]
92
+ }