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,99 @@
1
+ # EPA Envirofacts and ECHO (TRI, GHGRP, SDWIS, Superfund, compliance and enforcement)
2
+ Depth: standard. Key: none. EPA facility data from Envirofacts (Toxics Release Inventory, Greenhouse
3
+ Gas Reporting Program, Safe Drinking Water, Superfund sites, any other Envirofacts table) and ECHO
4
+ (facility compliance, violations, inspections, enforcement cases and penalties), plus UV index forecasts.
5
+
6
+ ## When to use
7
+ - Facilities that report toxic releases or greenhouse gases; large emitters by state and sector; public
8
+ water systems and drinking-water violations; Superfund sites and NPL status; facilities in violation
9
+ of the Clean Air or Clean Water Act; EPA enforcement cases and penalties.
10
+ - Not here: ambient air pollution measurements (epa-aqs, needs a key), weather (noaa), streamflow
11
+ (usgs), national GHG inventory totals (EPA's Inventory of U.S. Greenhouse Gas Emissions, not covered:
12
+ GHGRP covers large facilities only).
13
+
14
+ ## Endpoints and datasets
15
+ | Endpoint | Returns | Key parameters |
16
+ |---|---|---|
17
+ | `envirofacts` | rows of one Envirofacts table, paged by 5,000 | `table` (alias or schema.table), `filters` |
18
+ | `echo_facilities` | ECHO facility rows (compliance status, violation quarters, inspections, IDs) | `program` (air, cwa, rcra, sdw, echo), `p_st`, `p_co`, `p_fips`, `p_ct`, `p_zip`, `p_fn`, `p_act`, `p_maj`, `p_ncs` (NAICS), `p_sic`, `p_qiv`, `qcolumns` |
19
+ | `echo_cases` | civil and criminal enforcement cases with penalties | `p_state`, `p_law`, `p_case_category`, `p_case_status`, `p_milestone_fy`, `p_civil_criminal_indicator`, `p_fed_penalty` |
20
+ | `echo_facility_detail` | Detailed Facility Report for one FRS id (one row; sections as JSON text) | `p_id` |
21
+ | `uv_daily`, `uv_daily_city`, `uv_hourly` | today's UV index forecast | `zip`, or `city` + `state` |
22
+
23
+ `table` aliases (`request_schema` with `search: "drinking water"`): `tri_facility` (tri.tri_facility), `tri_reporting_form`
24
+ (tri.tri_reporting_form: chemical and year per form), `tri_release_qty` (tri.tri_release_qty: release
25
+ amount per medium, joined by `doc_ctrl_num`), `ghg_emitters` (ghg.ghg_emitter_sector), `sdwis_systems`
26
+ (sdwis.water_system), `sdwis_violations` (sdwis.violation), `superfund_sites` (sems.envirofacts_site).
27
+ Any other table works by its schema.table name (Envirofacts model: https://www.epa.gov/enviro/envirofacts-data-service-api).
28
+
29
+ `filters`: `{"column": "value"}` (equals, AND-ed) or `[["column", "operator", "value"], ...]` with
30
+ operators equals, notEquals, lessThan, lessThanEqual, greaterThan, greaterThanEqual, beginsWith,
31
+ endsWith, contains. Value matching is case-insensitive (verified).
32
+
33
+ ## Spec examples
34
+ ```json
35
+ {"description": "Vermont: GHGRP emitters in 2022 and Superfund sites on the final NPL",
36
+ "requests": [{"name": "vt_ghg_2022", "endpoint": "envirofacts",
37
+ "params": {"table": "ghg_emitters", "filters": [["state", "equals", "VT"], ["year", "equals", 2022]]}},
38
+ {"name": "vt_npl", "endpoint": "envirofacts",
39
+ "params": {"table": "superfund_sites", "filters": {"fk_ref_state_code": "VT", "npl_status_code": "F"}}}]}
40
+ ```
41
+ ```json
42
+ {"description": "Vermont: major Clean Air Act facilities and CAA enforcement cases",
43
+ "requests": [{"name": "vt_major_air", "endpoint": "echo_facilities", "params": {"program": "air", "p_st": "VT", "p_maj": "Y"}},
44
+ {"name": "vt_caa_cases", "endpoint": "echo_cases", "params": {"p_state": "VT", "p_law": "CAA"}}]}
45
+ ```
46
+
47
+ ## Data format and traps
48
+ - **ECHO parameter names differ by service** (verified 2026-10-20): facility searches take `p_st`;
49
+ case searches take `p_state` and silently ignore `p_st`, returning every state (313,071 cases instead
50
+ of 467 for VT). The pack refuses `p_st` on `echo_cases` and stops when ECHO reports a parameter it did
51
+ not understand. Major facilities: `p_maj=Y` (`p_pc=MAJOR` has no effect). Other parameters ECHO takes
52
+ without filtering (verified 2026-10-22), which the pack refuses: `p_naics` on facility searches (NAICS
53
+ is `p_ncs`, 2-6 digits as a prefix; few cwa permits carry a NAICS code), and on case searches `p_fy`
54
+ (use `p_milestone_fy`, one fiscal year), `p_crim` (use `p_civil_criminal_indicator`: CI, CR or ALL) and
55
+ `p_name` (accepted, never filters: filter `CaseName` after fetching). `p_co` (county name, with `p_st`)
56
+ returns 0 rows on `air` searches: use `p_fips` (5-digit county FIPS). Codes, not words:
57
+ `p_case_status=CLS` (closed), `CNC` (concluded), `FOI` (final order issued); `p_fed_penalty` takes only
58
+ ANY, LE5000, GT5000, GT50000, GT100000, GT500000, GT1000000, GT2500000.
59
+ - ECHO has a query-size limit: a search matching too many rows (e.g. all air facilities nationwide,
60
+ 280,376) returns "Queryset Limit would be exceeded"; filter by state or more. The fetch notes carry
61
+ ECHO's summary counts (QueryRows, violation and inspection counts, TotalPenalties).
62
+ - ECHO money is text like `$40,000.00` and dates `MM/DD/YYYY`; the pack adds `<column>_usd` and
63
+ `<column>_iso` columns and keeps the published ones. Penalties are nominal dollars assessed in the
64
+ settlement, not necessarily collected. Compliance status columns describe the last 3 years (12
65
+ quarters), as of ECHO's weekly refresh.
66
+ - **Columns**: facility searches return each program's default columns (about 60 for `air`). For others,
67
+ pass `qcolumns` (comma-separated column ids); the ids and names are listed keylessly by
68
+ `https://echodata.epa.gov/echo/<program>_rest_services.metadata?output=JSON` (`ResultColumns`). The pack
69
+ sends `qcolumns` to both steps (search and `get_qid`); check that the column you need is in the CSV.
70
+ - **GHGRP** rows are facility x gas x year: `co2e_emission` is metric tons CO2-equivalent for that gas
71
+ (the global-warming potentials follow EPA's current GHGRP rule; check before comparing across rule
72
+ changes); sum over gases for a facility total. Only
73
+ facilities above 25,000 t CO2e a year report, and some sectors report as suppliers, not emitters.
74
+ - **TRI** `tri_facility` lists facilities, not quantities: releases are in `tri_release_qty` (pounds;
75
+ grams for dioxins; per form, joined to `tri_reporting_form` by `doc_ctrl_num`, to facilities by `tri_facility_id`).
76
+ Reporting year Y first appears as preliminary data in the summer of Y+1.
77
+ - **SDWIS**: `state_code` is the system's address state, `primacy_agency_code` the regulating state
78
+ (verified: a VT-address system regulated as CT); filter by `primacy_agency_code` for "systems in a
79
+ state". `pws_type_code`: CWS community, NTNCWS non-transient non-community, TNCWS transient.
80
+ `pws_activity_code` A active, I inactive. Violations: `is_health_based_ind` Y for health-based.
81
+ - **Superfund**: `npl_status_code` F final NPL, P proposed, D deleted, N not on the NPL; many SEMS sites
82
+ are not NPL sites.
83
+ - Envirofacts values are mostly text; dates as `YYYY-MM-DD HH:MM:SS`. Column names are lower case and
84
+ table-specific. A wrong column gives HTTP 500 "The column, <schema.table.column> does not exist"; a wrong table HTTP 404.
85
+ - UV index is a forecast for today only (0-2 low, 3-5 moderate, 6-7 high, 8-10 very high, 11+ extreme).
86
+
87
+ ## Access
88
+ No key. `fetch` downloads when data.epa.gov and echodata.epa.gov answer (the fetcher sends 2 requests a
89
+ second). Manual route (`manual_bundle`): `manual_download/INSTRUCTIONS.md` lists Envirofacts CSV links (5,000 rows each)
90
+ and, for ECHO, the first-step link plus the `get_qid` link to open with the QueryID it returns. Or use
91
+ https://enviro.epa.gov, https://echo.epa.gov/facilities/facility-search and
92
+ https://echo.epa.gov/facilities/enforcement-case-search (Download Data); full-year TRI and GHGRP files
93
+ are on epa.gov (TRI Basic Data Files; GHGRP data sets). Upload the files, then `ingest`.
94
+
95
+ ## Citation and terms
96
+ "U.S. Environmental Protection Agency, <dataset, e.g. Greenhouse Gas Reporting Program (GHGRP) via
97
+ Envirofacts / ECHO enforcement case search>, retrieved <date>." Public domain (U.S. government work);
98
+ cite EPA and do not imply endorsement (https://www.epa.gov/web-policies-and-procedures/epa-disclaimers).
99
+ Redistribution allowed.
@@ -0,0 +1,174 @@
1
+ {
2
+ "base_url": "https://aqs.epa.gov/data/api",
3
+ "endpoints": {
4
+ "data": {
5
+ "path": "/{service}/{geo}",
6
+ "method": "GET",
7
+ "description": "AQS data: annual, quarterly or daily summaries, raw sample data, or monitors, for a state, county, site, CBSA or box.",
8
+ "params": {
9
+ "service": {
10
+ "in": "path",
11
+ "required": true,
12
+ "enum": [
13
+ "annualData",
14
+ "quarterlyData",
15
+ "dailyData",
16
+ "sampleData",
17
+ "monitors"
18
+ ],
19
+ "desc": "annualData, quarterlyData, dailyData, sampleData, monitors"
20
+ },
21
+ "geo": {
22
+ "in": "path",
23
+ "required": true,
24
+ "enum": [
25
+ "byState",
26
+ "byCounty",
27
+ "bySite",
28
+ "byCBSA",
29
+ "byBox"
30
+ ],
31
+ "desc": "byState, byCounty, bySite, byCBSA, byBox"
32
+ },
33
+ "param": {
34
+ "required": true,
35
+ "desc": "catalog alias (ozone, pm25, no2 ...) or AQS parameter code(s), up to 5 comma-separated: 44201 ozone, 88101 PM2.5 FRM/FEM, 88502 PM2.5 non-FRM, 81102 PM10, 42401 SO2, 42101 CO, 42602 NO2, 14129 lead",
36
+ "catalog": true
37
+ },
38
+ "bdate": {
39
+ "required": true,
40
+ "desc": "begin date YYYYMMDD"
41
+ },
42
+ "edate": {
43
+ "required": true,
44
+ "desc": "end date YYYYMMDD (several years are split into one call per year)"
45
+ },
46
+ "state": {
47
+ "desc": "state FIPS (06), USPS code (CA) or name; converted to FIPS"
48
+ },
49
+ "county": {
50
+ "desc": "3-digit county FIPS within the state (037)"
51
+ },
52
+ "site": {
53
+ "desc": "4-digit site number (0014)"
54
+ },
55
+ "cbsa": {
56
+ "desc": "CBSA code (16740)"
57
+ },
58
+ "minlat": {
59
+ "desc": "byBox"
60
+ },
61
+ "maxlat": {},
62
+ "minlon": {},
63
+ "maxlon": {},
64
+ "duration": {
65
+ "desc": "sampleData only: sample duration code"
66
+ },
67
+ "cbdate": {
68
+ "desc": "change begin date YYYYMMDD"
69
+ },
70
+ "cedate": {
71
+ "desc": "change end date YYYYMMDD"
72
+ }
73
+ },
74
+ "records": "Data",
75
+ "paging": {
76
+ "type": "none"
77
+ },
78
+ "max_rows": 1000000,
79
+ "missing": [
80
+ ""
81
+ ],
82
+ "flatten": true
83
+ },
84
+ "list": {
85
+ "path": "/list/{list}",
86
+ "method": "GET",
87
+ "description": "AQS code lists: states, counties, sites, CBSAs, parameter classes and their parameters.",
88
+ "params": {
89
+ "list": {
90
+ "in": "path",
91
+ "required": true,
92
+ "enum": [
93
+ "states",
94
+ "countiesByState",
95
+ "sitesByCounty",
96
+ "cbsas",
97
+ "classes",
98
+ "parametersByClass",
99
+ "pqaos",
100
+ "mas"
101
+ ],
102
+ "desc": "which list"
103
+ },
104
+ "state": {
105
+ "desc": "countiesByState, sitesByCounty"
106
+ },
107
+ "county": {
108
+ "desc": "sitesByCounty"
109
+ },
110
+ "pc": {
111
+ "desc": "parametersByClass: CRITERIA, ALL, ..."
112
+ }
113
+ },
114
+ "records": "Data",
115
+ "paging": {
116
+ "type": "none"
117
+ },
118
+ "missing": [
119
+ ""
120
+ ],
121
+ "flatten": true
122
+ }
123
+ },
124
+ "catalog": {
125
+ "ozone": {
126
+ "id": "44201",
127
+ "name": "Ozone",
128
+ "description": "parameter 44201, ppm; design values use the 8-hour average",
129
+ "endpoint": "data"
130
+ },
131
+ "pm25": {
132
+ "id": "88101",
133
+ "name": "PM2.5 FRM/FEM",
134
+ "description": "parameter 88101, micrograms/cubic meter (local conditions)",
135
+ "endpoint": "data"
136
+ },
137
+ "pm25_nonfrm": {
138
+ "id": "88502",
139
+ "name": "PM2.5 non-FRM (continuous)",
140
+ "description": "parameter 88502, acceptable PM2.5 AQI and speciation mass",
141
+ "endpoint": "data"
142
+ },
143
+ "pm10": {
144
+ "id": "81102",
145
+ "name": "PM10",
146
+ "description": "parameter 81102, micrograms/cubic meter (STP)",
147
+ "endpoint": "data"
148
+ },
149
+ "so2": {
150
+ "id": "42401",
151
+ "name": "Sulfur dioxide",
152
+ "description": "parameter 42401, ppb",
153
+ "endpoint": "data"
154
+ },
155
+ "co": {
156
+ "id": "42101",
157
+ "name": "Carbon monoxide",
158
+ "description": "parameter 42101, ppm",
159
+ "endpoint": "data"
160
+ },
161
+ "no2": {
162
+ "id": "42602",
163
+ "name": "Nitrogen dioxide",
164
+ "description": "parameter 42602, ppb",
165
+ "endpoint": "data"
166
+ },
167
+ "lead": {
168
+ "id": "14129",
169
+ "name": "Lead (TSP, local conditions)",
170
+ "description": "parameter 14129, micrograms/cubic meter",
171
+ "endpoint": "data"
172
+ }
173
+ }
174
+ }
@@ -0,0 +1,96 @@
1
+ {
2
+ "id": "epa-aqs",
3
+ "title": "EPA Air Quality System (AQS) Data Mart API",
4
+ "agency": "U.S. Environmental Protection Agency, Office of Air Quality Planning and Standards",
5
+ "depth": "standard",
6
+ "domains": [
7
+ "environment",
8
+ "air quality",
9
+ "health"
10
+ ],
11
+ "keywords": [
12
+ "air quality",
13
+ "air pollution",
14
+ "ozone",
15
+ "pm2.5",
16
+ "pm25",
17
+ "fine particulate",
18
+ "particulate matter",
19
+ "pm10",
20
+ "sulfur dioxide",
21
+ "so2",
22
+ "nitrogen dioxide",
23
+ "no2",
24
+ "carbon monoxide",
25
+ "lead",
26
+ "criteria pollutant",
27
+ "aqs",
28
+ "air monitor",
29
+ "monitoring site",
30
+ "naaqs",
31
+ "smog"
32
+ ],
33
+ "questions": [
34
+ "annual mean PM2.5 by county in a state",
35
+ "ozone levels at monitors in a state over the last decade",
36
+ "daily PM2.5 during a wildfire smoke episode",
37
+ "air quality monitors in a county"
38
+ ],
39
+ "homepage": "https://aqs.epa.gov/aqsweb/documents/data_api.html",
40
+ "terms_url": "https://aqs.epa.gov/aqsweb/documents/data_api.html#terms",
41
+ "auth": {
42
+ "env": "AQS_API_KEY",
43
+ "required": "required",
44
+ "placement": "query",
45
+ "param": "key",
46
+ "prefix": "",
47
+ "home": "aqs",
48
+ "signup_url": "https://aqs.epa.gov/data/api/signup?email=YOUR_EMAIL",
49
+ "echoes_key": false,
50
+ "key_only": [],
51
+ "extra": {
52
+ "email": "AQS_EMAIL"
53
+ }
54
+ },
55
+ "limits": {
56
+ "rps": 0.2,
57
+ "burst": 1,
58
+ "daily_quota": null,
59
+ "max_rows": 1000000
60
+ },
61
+ "routes": {
62
+ "api": {
63
+ "base": "https://aqs.epa.gov/data/api",
64
+ "probe": "https://aqs.epa.gov/data/api/metaData/isAvailable",
65
+ "hosts": [
66
+ "aqs.epa.gov"
67
+ ]
68
+ },
69
+ "manual": {
70
+ "keyless_citation": "U.S. Environmental Protection Agency, Air Quality System (AQS) pre-generated AirData files, {dataset}, aqs.epa.gov/aqsweb/airdata, retrieved {retrieved_long}.",
71
+ "keyless_file": "annualData and dailyData without a key: EPA's AirData yearly file, https://aqs.epa.gov/aqsweb/airdata/annual_conc_by_monitor_<year>.zip (every parameter, about 4 MB) or https://aqs.epa.gov/aqsweb/airdata/daily_<parameter code>_<year>.zip (one parameter, 2-10 MB), one file per year of the request; pass the .zip as downloaded to ingest with the same spec, which keeps the request's rows (state, county, site or box, parameter, dates). One parameter code per daily request; not for quarterlyData, sampleData, monitors or byCBSA.",
72
+ "how": "Without a key: download EPA's pre-generated files at https://aqs.epa.gov/aqsweb/airdata/download_files.html (annual_conc_by_monitor_<year>.zip, daily_<param>_<year>.zip) and upload the .zip as downloaded (or its CSV): ingest keeps the rows the request asks for. Or use https://www.epa.gov/outdoor-air-quality-data (Download Daily Data). With a key: the links in manual_download/INSTRUCTIONS.md, after replacing {API_KEY} with the key and {AQS_EMAIL} with the email it is registered to (or run the download script with both variables set)."
73
+ }
74
+ },
75
+ "cache": {
76
+ "mode": "run_only",
77
+ "ttl_hours": null,
78
+ "why": "Data are revised as agencies certify them; data/ is reused only within a run."
79
+ },
80
+ "redistribution": {
81
+ "mode": "allowed",
82
+ "why": "AQS data are U.S. government works in the public domain (17 U.S.C. 105); the AQS API terms limit request volume, not reuse of the data."
83
+ },
84
+ "notices": [],
85
+ "retention": null,
86
+ "citation": "U.S. Environmental Protection Agency, Air Quality System (AQS) Data Mart, {dataset}, aqs.epa.gov/data/api, retrieved {retrieved_long}.",
87
+ "audit_hooks": [],
88
+ "clarify": [
89
+ "Which pollutant and statistic (annual mean, 98th percentile, 4th-highest 8-hour ozone)? Each standard uses its own statistic.",
90
+ "All monitors or one value per county? Counties often have several monitors and POCs; say how they are combined.",
91
+ "Certified data only? The latest months are not yet certified and arrive about 6 months late."
92
+ ],
93
+ "formats": [
94
+ "json"
95
+ ]
96
+ }
@@ -0,0 +1,97 @@
1
+ # EPA Air Quality System (AQS) Data Mart API
2
+ Depth: standard. Key: required (AQS_API_KEY plus AQS_EMAIL). Ambient air pollution measured at
3
+ thousands of U.S. monitors: criteria pollutants (ozone, PM2.5, PM10, SO2, CO, NO2, lead) and more, as
4
+ annual, quarterly or daily summaries, raw samples, and monitor metadata. Historical data only.
5
+
6
+ ## When to use
7
+ - Measured pollutant concentrations by state, county, site, CBSA or box; annual means and percentiles;
8
+ daily values during episodes (wildfire smoke); which monitors operate where.
9
+ - Not here: facility emissions, toxic releases, compliance (epa: GHGRP, TRI, ECHO); today's AQI and
10
+ forecasts (AirNow, not covered); the UV index (epa). Without a key, annual and daily summaries come
11
+ from EPA's AirData yearly files through `ingest` (see Access).
12
+
13
+ ## Endpoints and datasets
14
+ | Endpoint | Returns | Parameters |
15
+ |---|---|---|
16
+ | `data` | rows of one AQS service | `service` (annualData, quarterlyData, dailyData, sampleData, monitors), `geo` (byState, byCounty, bySite, byCBSA, byBox), `param`, `bdate`, `edate`, `state`, `county`, `site`, `cbsa`, `minlat`/`maxlat`/`minlon`/`maxlon`, `duration`, `cbdate`/`cedate` |
17
+ | `list` | code lists | `list` (states, countiesByState, sitesByCounty, cbsas, classes, parametersByClass, pqaos, mas; there is no durations list: duration codes are on AQS's code-table pages), `state`, `county`, `pc` |
18
+
19
+ `param` aliases: `ozone` 44201 (ppm), `pm25` 88101 (FRM/FEM, ug/m3), `pm25_nonfrm` 88502, `pm10` 81102,
20
+ `so2` 42401 (ppb), `co` 42101 (ppm), `no2` 42602 (ppb), `lead` 14129 (ug/m3); or up to 5 codes
21
+ comma-separated. Geography needs: byState `state`; byCounty `state`+`county`; bySite +`site`; byCBSA
22
+ `cbsa`; byBox the four bounds. States may be FIPS (06), USPS (CA) or names; the pack converts them.
23
+
24
+ ## Spec examples
25
+ ```json
26
+ {"description": "Annual ozone summaries for every Vermont monitor, 2022-2023",
27
+ "requests": [{"name": "vt_ozone", "endpoint": "data",
28
+ "params": {"service": "annualData", "geo": "byState", "param": "ozone", "bdate": "20220101",
29
+ "edate": "20231231", "state": "VT"}}]}
30
+ ```
31
+ ```json
32
+ {"description": "Daily PM2.5 in Los Angeles County, June 2024",
33
+ "requests": [{"name": "la_pm25_daily", "endpoint": "data",
34
+ "params": {"service": "dailyData", "geo": "byCounty", "param": "88101", "bdate": "20240601",
35
+ "edate": "20240630", "state": "06", "county": "037"}}]}
36
+ ```
37
+ ```json
38
+ {"description": "Ozone monitors in North Carolina operating in 2024",
39
+ "requests": [{"name": "nc_monitors", "endpoint": "data",
40
+ "params": {"service": "monitors", "geo": "byState", "param": "44201", "bdate": "20240101",
41
+ "edate": "20241231", "state": "37"}}]}
42
+ ```
43
+
44
+ ## Data format and traps
45
+ Unverified: the pack was built without a key, so the summary column names below (pollutant_standard,
46
+ sample_duration, observation_percent, event_type ...) follow the AQS documentation and AirData file
47
+ layouts, not a live response; check `data_dictionary.csv` after the first fetch.
48
+ - **Same-year rule**: `bdate` and `edate` must be in one calendar year (except `monitors`). The pack
49
+ splits a longer range into one call per year (notes say how many). Annual and quarterly services use
50
+ only the year part of the dates and return whole years.
51
+ - **Several rows per monitor**: summaries have one row per site x parameter x POC (parameter occurrence
52
+ code: several instruments at one site) x `sample_duration` x `pollutant_standard` (and for daily
53
+ data per day). Filter `pollutant_standard` (e.g. "Ozone 8-hour 2015", "PM25 Annual 2012") and
54
+ `sample_duration` before averaging, or values are double counted.
55
+ - Statistics differ by standard: ozone compliance uses the 4th-highest daily maximum 8-hour average;
56
+ PM2.5 annual uses `arithmetic_mean`, 24-hour uses the 98th percentile (`ninety_eighth_percentile`).
57
+ These are monitor statistics, not official design values (EPA publishes those separately).
58
+ - Units are per parameter (`units_of_measure`): ozone and CO in ppm, SO2 and NO2 in ppb, PM in
59
+ micrograms per cubic meter (local conditions for PM2.5, STP for PM10).
60
+ - Completeness: `observation_percent` and `validity_indicator` say whether a year meets data
61
+ requirements; exclude incomplete years from trends. `event_type` separates values with and without
62
+ exceptional events (wildfire smoke): "No Events", "Events Included", "Events Excluded".
63
+ - Data lag about 6 months and are revised until certified (`certification_indicator`,
64
+ `date_of_last_change`).
65
+ - `sampleData` (hourly or finer) is very large: one site, one parameter, short periods. AQS asks for at
66
+ most 1,000,000 rows per request.
67
+ - AQS returns HTTP 200 with Header status "No data matched your selection" for an empty result, and
68
+ "Failed" (or HTTP 400) with an error list for a bad request. The documentation's example responses
69
+ call the row list "Body"; the live API calls it "Data" (both are read).
70
+ - Codes are text with leading zeros: state "06", county "037", site "0014"; keep them as text.
71
+
72
+ ## Access
73
+ Key required: a free AQS key is emailed after a sign-up request (open
74
+ https://aqs.epa.gov/data/api/signup?email=YOUR_EMAIL with your address). The user stores the key in `AQS_API_KEY`
75
+ and the registered email in `AQS_EMAIL` with `npx -y data-analyst-mcp setup epa-aqs` in their own terminal (it
76
+ asks for both and puts them in the "env" block of keys.json; environment variables work too; never ask for the
77
+ key in chat); both are sent as query parameters and never recorded. Limits (AQS terms):
78
+ no more than 10 requests a minute, a 5-second pause between requests, one request at a time; the pack
79
+ waits 5 seconds between calls, so multi-year requests take a while. Accounts that break the terms may be
80
+ disabled. Without a key (`fetch` stops with `key_missing`, and the error carries `keyless_file`): EPA's AirData yearly files hold the same annual and
81
+ daily summaries for every U.S. monitor, at https://aqs.epa.gov/aqsweb/airdata/ (list:
82
+ download_files.html): `annual_conc_by_monitor_<year>.zip` (all parameters, about 4 MB) for `annualData`,
83
+ `daily_<code>_<year>.zip` (one parameter, 2-10 MB; e.g. daily_88101_2023.zip) for `dailyData`; one file per
84
+ year; sizes checked 2026-10-28 (hourly files are 70+ MB: not a keyless route here). Give the .zip as
85
+ downloaded (or its CSV) to `ingest` with the same spec: it keeps the rows the spec asks for (state,
86
+ county, site or box, parameter, dates; never filter by hand) and renames the columns to the API's names
87
+ where they differ (`site_num` -> `site_number`, `parameter_name` -> `parameter`, `1st_max_value` ->
88
+ `first_max_value`, `98th_percentile` -> `ninety_eighth_percentile`, ...). Daily requests take one parameter
89
+ code each; `quarterlyData`, `sampleData`, `monitors` and `byCBSA` (the files carry CBSA names, not codes)
90
+ need the key. AirData files are rebuilt about twice a year, so they can lag the API. Or
91
+ https://www.epa.gov/outdoor-air-quality-data (a browser page). With a key elsewhere: the links in
92
+ `manual_download/INSTRUCTIONS.md` from `manual_bundle` (replace `{API_KEY}` and `{AQS_EMAIL}`). Then `ingest`.
93
+
94
+ ## Citation and terms
95
+ "U.S. Environmental Protection Agency, Air Quality System (AQS) Data Mart, <service, parameter,
96
+ geography>, aqs.epa.gov/data/api, retrieved <date>." Public domain (U.S. government work);
97
+ redistribution allowed. Terms of service (request limits): https://aqs.epa.gov/aqsweb/documents/data_api.html.