data-analyst-mcp 0.0.0-stage → 0.3.1
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.
- package/README.md +261 -2
- package/dist/adapters/_acf_tidy.d.ts +18 -0
- package/dist/adapters/_acf_tidy.js +432 -0
- package/dist/adapters/_acf_tidy.js.map +1 -0
- package/dist/adapters/_actuaries_read.d.ts +38 -0
- package/dist/adapters/_actuaries_read.js +728 -0
- package/dist/adapters/_actuaries_read.js.map +1 -0
- package/dist/adapters/_census_micro.d.ts +70 -0
- package/dist/adapters/_census_micro.js +622 -0
- package/dist/adapters/_census_micro.js.map +1 -0
- package/dist/adapters/_census_util.d.ts +40 -0
- package/dist/adapters/_census_util.js +275 -0
- package/dist/adapters/_census_util.js.map +1 -0
- package/dist/adapters/_dol_states.d.ts +6 -0
- package/dist/adapters/_dol_states.js +58 -0
- package/dist/adapters/_dol_states.js.map +1 -0
- package/dist/adapters/_govinfo_entities.d.ts +4 -0
- package/dist/adapters/_govinfo_entities.js +6 -0
- package/dist/adapters/_govinfo_entities.js.map +1 -0
- package/dist/adapters/_govinfo_json.d.ts +13 -0
- package/dist/adapters/_govinfo_json.js +107 -0
- package/dist/adapters/_govinfo_json.js.map +1 -0
- package/dist/adapters/_govinfo_py.d.ts +22 -0
- package/dist/adapters/_govinfo_py.js +272 -0
- package/dist/adapters/_govinfo_py.js.map +1 -0
- package/dist/adapters/_govinfo_xml.d.ts +22 -0
- package/dist/adapters/_govinfo_xml.js +233 -0
- package/dist/adapters/_govinfo_xml.js.map +1 -0
- package/dist/adapters/_hud_excel.d.ts +2 -0
- package/dist/adapters/_hud_excel.js +166 -0
- package/dist/adapters/_hud_excel.js.map +1 -0
- package/dist/adapters/_omb_grid.d.ts +17 -0
- package/dist/adapters/_omb_grid.js +132 -0
- package/dist/adapters/_omb_grid.js.map +1 -0
- package/dist/adapters/_omb_util.d.ts +40 -0
- package/dist/adapters/_omb_util.js +192 -0
- package/dist/adapters/_omb_util.js.map +1 -0
- package/dist/adapters/_usaspending_state.d.ts +6 -0
- package/dist/adapters/_usaspending_state.js +54 -0
- package/dist/adapters/_usaspending_state.js.map +1 -0
- package/dist/adapters/_usda-fna_book.d.ts +59 -0
- package/dist/adapters/_usda-fna_book.js +869 -0
- package/dist/adapters/_usda-fna_book.js.map +1 -0
- package/dist/adapters/_usda-fna_pdf.d.ts +20 -0
- package/dist/adapters/_usda-fna_pdf.js +361 -0
- package/dist/adapters/_usda-fna_pdf.js.map +1 -0
- package/dist/adapters/_usda-outlook_read.d.ts +70 -0
- package/dist/adapters/_usda-outlook_read.js +362 -0
- package/dist/adapters/_usda-outlook_read.js.map +1 -0
- package/dist/adapters/acf.d.ts +3 -0
- package/dist/adapters/acf.js +187 -0
- package/dist/adapters/acf.js.map +1 -0
- package/dist/adapters/actuaries.d.ts +3 -0
- package/dist/adapters/actuaries.js +293 -0
- package/dist/adapters/actuaries.js.map +1 -0
- package/dist/adapters/bts.d.ts +3 -0
- package/dist/adapters/bts.js +26 -0
- package/dist/adapters/bts.js.map +1 -0
- package/dist/adapters/census-geocoder.d.ts +10 -0
- package/dist/adapters/census-geocoder.js +47 -0
- package/dist/adapters/census-geocoder.js.map +1 -0
- package/dist/adapters/census.d.ts +17 -0
- package/dist/adapters/census.js +983 -0
- package/dist/adapters/census.js.map +1 -0
- package/dist/adapters/cfpb.d.ts +7 -0
- package/dist/adapters/cfpb.js +348 -0
- package/dist/adapters/cfpb.js.map +1 -0
- package/dist/adapters/clinical-trials.d.ts +3 -0
- package/dist/adapters/clinical-trials.js +135 -0
- package/dist/adapters/clinical-trials.js.map +1 -0
- package/dist/adapters/cms.d.ts +3 -0
- package/dist/adapters/cms.js +292 -0
- package/dist/adapters/cms.js.map +1 -0
- package/dist/adapters/college-scorecard.d.ts +3 -0
- package/dist/adapters/college-scorecard.js +122 -0
- package/dist/adapters/college-scorecard.js.map +1 -0
- package/dist/adapters/congress.d.ts +33 -0
- package/dist/adapters/congress.js +589 -0
- package/dist/adapters/congress.js.map +1 -0
- package/dist/adapters/dhs-ohss.d.ts +13 -0
- package/dist/adapters/dhs-ohss.js +598 -0
- package/dist/adapters/dhs-ohss.js.map +1 -0
- package/dist/adapters/doj-news.d.ts +7 -0
- package/dist/adapters/doj-news.js +286 -0
- package/dist/adapters/doj-news.js.map +1 -0
- package/dist/adapters/dol.d.ts +4 -0
- package/dist/adapters/dol.js +634 -0
- package/dist/adapters/dol.js.map +1 -0
- package/dist/adapters/eia.d.ts +15 -0
- package/dist/adapters/eia.js +456 -0
- package/dist/adapters/eia.js.map +1 -0
- package/dist/adapters/epa-aqs.d.ts +3 -0
- package/dist/adapters/epa-aqs.js +357 -0
- package/dist/adapters/epa-aqs.js.map +1 -0
- package/dist/adapters/epa.d.ts +3 -0
- package/dist/adapters/epa.js +298 -0
- package/dist/adapters/epa.js.map +1 -0
- package/dist/adapters/fbi.d.ts +3 -0
- package/dist/adapters/fbi.js +192 -0
- package/dist/adapters/fbi.js.map +1 -0
- package/dist/adapters/fda.d.ts +5 -0
- package/dist/adapters/fda.js +184 -0
- package/dist/adapters/fda.js.map +1 -0
- package/dist/adapters/fdic.d.ts +4 -0
- package/dist/adapters/fdic.js +95 -0
- package/dist/adapters/fdic.js.map +1 -0
- package/dist/adapters/fec.d.ts +3 -0
- package/dist/adapters/fec.js +142 -0
- package/dist/adapters/fec.js.map +1 -0
- package/dist/adapters/fed-board.d.ts +12 -0
- package/dist/adapters/fed-board.js +581 -0
- package/dist/adapters/fed-board.js.map +1 -0
- package/dist/adapters/federal-register.d.ts +11 -0
- package/dist/adapters/federal-register.js +43 -0
- package/dist/adapters/federal-register.js.map +1 -0
- package/dist/adapters/fhfa.d.ts +3 -0
- package/dist/adapters/fhfa.js +253 -0
- package/dist/adapters/fhfa.js.map +1 -0
- package/dist/adapters/fsa.d.ts +9 -0
- package/dist/adapters/fsa.js +335 -0
- package/dist/adapters/fsa.js.map +1 -0
- package/dist/adapters/govinfo.d.ts +30 -0
- package/dist/adapters/govinfo.js +636 -0
- package/dist/adapters/govinfo.js.map +1 -0
- package/dist/adapters/gsa-calc.d.ts +10 -0
- package/dist/adapters/gsa-calc.js +318 -0
- package/dist/adapters/gsa-calc.js.map +1 -0
- package/dist/adapters/hud.d.ts +3 -0
- package/dist/adapters/hud.js +200 -0
- package/dist/adapters/hud.js.map +1 -0
- package/dist/adapters/index.d.ts +3 -0
- package/dist/adapters/index.js +25 -0
- package/dist/adapters/index.js.map +1 -0
- package/dist/adapters/irs-soi.d.ts +6 -0
- package/dist/adapters/irs-soi.js +576 -0
- package/dist/adapters/irs-soi.js.map +1 -0
- package/dist/adapters/naep.d.ts +15 -0
- package/dist/adapters/naep.js +341 -0
- package/dist/adapters/naep.js.map +1 -0
- package/dist/adapters/nhtsa.d.ts +10 -0
- package/dist/adapters/nhtsa.js +239 -0
- package/dist/adapters/nhtsa.js.map +1 -0
- package/dist/adapters/nih.d.ts +5 -0
- package/dist/adapters/nih.js +196 -0
- package/dist/adapters/nih.js.map +1 -0
- package/dist/adapters/noaa.d.ts +3 -0
- package/dist/adapters/noaa.js +148 -0
- package/dist/adapters/noaa.js.map +1 -0
- package/dist/adapters/nrel.d.ts +3 -0
- package/dist/adapters/nrel.js +186 -0
- package/dist/adapters/nrel.js.map +1 -0
- package/dist/adapters/nws.d.ts +3 -0
- package/dist/adapters/nws.js +119 -0
- package/dist/adapters/nws.js.map +1 -0
- package/dist/adapters/omb.d.ts +15 -0
- package/dist/adapters/omb.js +517 -0
- package/dist/adapters/omb.js.map +1 -0
- package/dist/adapters/open-payments.d.ts +5 -0
- package/dist/adapters/open-payments.js +149 -0
- package/dist/adapters/open-payments.js.map +1 -0
- package/dist/adapters/pbgc.d.ts +13 -0
- package/dist/adapters/pbgc.js +283 -0
- package/dist/adapters/pbgc.js.map +1 -0
- package/dist/adapters/philfed.d.ts +12 -0
- package/dist/adapters/philfed.js +59 -0
- package/dist/adapters/philfed.js.map +1 -0
- package/dist/adapters/regulations.d.ts +6 -0
- package/dist/adapters/regulations.js +58 -0
- package/dist/adapters/regulations.js.map +1 -0
- package/dist/adapters/sec.d.ts +13 -0
- package/dist/adapters/sec.js +504 -0
- package/dist/adapters/sec.js.map +1 -0
- package/dist/adapters/senate-lobbying.d.ts +3 -0
- package/dist/adapters/senate-lobbying.js +181 -0
- package/dist/adapters/senate-lobbying.js.map +1 -0
- package/dist/adapters/snapqc.d.ts +32 -0
- package/dist/adapters/snapqc.js +701 -0
- package/dist/adapters/snapqc.js.map +1 -0
- package/dist/adapters/treasury-yields.d.ts +3 -0
- package/dist/adapters/treasury-yields.js +170 -0
- package/dist/adapters/treasury-yields.js.map +1 -0
- package/dist/adapters/usaspending.d.ts +3 -0
- package/dist/adapters/usaspending.js +340 -0
- package/dist/adapters/usaspending.js.map +1 -0
- package/dist/adapters/usda-fna.d.ts +7 -0
- package/dist/adapters/usda-fna.js +707 -0
- package/dist/adapters/usda-fna.js.map +1 -0
- package/dist/adapters/usda-fooddata.d.ts +3 -0
- package/dist/adapters/usda-fooddata.js +101 -0
- package/dist/adapters/usda-fooddata.js.map +1 -0
- package/dist/adapters/usda-nass.d.ts +3 -0
- package/dist/adapters/usda-nass.js +108 -0
- package/dist/adapters/usda-nass.js.map +1 -0
- package/dist/adapters/usda-outlook.d.ts +12 -0
- package/dist/adapters/usda-outlook.js +696 -0
- package/dist/adapters/usda-outlook.js.map +1 -0
- package/dist/adapters/usgs.d.ts +9 -0
- package/dist/adapters/usgs.js +265 -0
- package/dist/adapters/usgs.js.map +1 -0
- package/dist/adapters/usitc.d.ts +18 -0
- package/dist/adapters/usitc.js +170 -0
- package/dist/adapters/usitc.js.map +1 -0
- package/dist/adapters/uspto.d.ts +3 -0
- package/dist/adapters/uspto.js +47 -0
- package/dist/adapters/uspto.js.map +1 -0
- package/dist/adapters/world-bank.d.ts +3 -0
- package/dist/adapters/world-bank.js +163 -0
- package/dist/adapters/world-bank.js.map +1 -0
- package/dist/analysis/cite.d.ts +31 -0
- package/dist/analysis/cite.js +229 -0
- package/dist/analysis/cite.js.map +1 -0
- package/dist/analysis/combine.d.ts +27 -0
- package/dist/analysis/combine.js +198 -0
- package/dist/analysis/combine.js.map +1 -0
- package/dist/analysis/compute.d.ts +62 -0
- package/dist/analysis/compute.js +583 -0
- package/dist/analysis/compute.js.map +1 -0
- package/dist/analysis/expr.d.ts +69 -0
- package/dist/analysis/expr.js +780 -0
- package/dist/analysis/expr.js.map +1 -0
- package/dist/analysis/factfmt.d.ts +16 -0
- package/dist/analysis/factfmt.js +187 -0
- package/dist/analysis/factfmt.js.map +1 -0
- package/dist/analysis/facts.d.ts +63 -0
- package/dist/analysis/facts.js +355 -0
- package/dist/analysis/facts.js.map +1 -0
- package/dist/analysis/handoff.d.ts +58 -0
- package/dist/analysis/handoff.js +208 -0
- package/dist/analysis/handoff.js.map +1 -0
- package/dist/analysis/pyfmt.d.ts +16 -0
- package/dist/analysis/pyfmt.js +156 -0
- package/dist/analysis/pyfmt.js.map +1 -0
- package/dist/analysis/rerun.d.ts +13 -0
- package/dist/analysis/rerun.js +125 -0
- package/dist/analysis/rerun.js.map +1 -0
- package/dist/analysis/table.d.ts +18 -0
- package/dist/analysis/table.js +109 -0
- package/dist/analysis/table.js.map +1 -0
- package/dist/analysis/tools.d.ts +67 -0
- package/dist/analysis/tools.js +217 -0
- package/dist/analysis/tools.js.map +1 -0
- package/dist/analysis/write_table.d.ts +13 -0
- package/dist/analysis/write_table.js +59 -0
- package/dist/analysis/write_table.js.map +1 -0
- package/dist/bin/cli.d.ts +10 -0
- package/dist/bin/cli.js +177 -0
- package/dist/bin/cli.js.map +1 -0
- package/dist/core/cache.d.ts +14 -0
- package/dist/core/cache.js +90 -0
- package/dist/core/cache.js.map +1 -0
- package/dist/core/context.d.ts +12 -0
- package/dist/core/context.js +15 -0
- package/dist/core/context.js.map +1 -0
- package/dist/core/env.d.ts +14 -0
- package/dist/core/env.js +52 -0
- package/dist/core/env.js.map +1 -0
- package/dist/core/generic-rest.d.ts +61 -0
- package/dist/core/generic-rest.js +639 -0
- package/dist/core/generic-rest.js.map +1 -0
- package/dist/core/http.d.ts +120 -0
- package/dist/core/http.js +514 -0
- package/dist/core/http.js.map +1 -0
- package/dist/core/keys.d.ts +43 -0
- package/dist/core/keys.js +174 -0
- package/dist/core/keys.js.map +1 -0
- package/dist/core/manual.d.ts +41 -0
- package/dist/core/manual.js +218 -0
- package/dist/core/manual.js.map +1 -0
- package/dist/core/package.d.ts +58 -0
- package/dist/core/package.js +228 -0
- package/dist/core/package.js.map +1 -0
- package/dist/core/packs.d.ts +139 -0
- package/dist/core/packs.js +173 -0
- package/dist/core/packs.js.map +1 -0
- package/dist/core/policy.d.ts +69 -0
- package/dist/core/policy.js +189 -0
- package/dist/core/policy.js.map +1 -0
- package/dist/core/py.d.ts +40 -0
- package/dist/core/py.js +171 -0
- package/dist/core/py.js.map +1 -0
- package/dist/core/routing.d.ts +10 -0
- package/dist/core/routing.js +39 -0
- package/dist/core/routing.js.map +1 -0
- package/dist/core/tabular.d.ts +21 -0
- package/dist/core/tabular.js +229 -0
- package/dist/core/tabular.js.map +1 -0
- package/dist/deep/_bea_api.d.ts +102 -0
- package/dist/deep/_bea_api.js +457 -0
- package/dist/deep/_bea_api.js.map +1 -0
- package/dist/deep/_bea_fetch.d.ts +151 -0
- package/dist/deep/_bea_fetch.js +1274 -0
- package/dist/deep/_bea_fetch.js.map +1 -0
- package/dist/deep/_bea_util.d.ts +14 -0
- package/dist/deep/_bea_util.js +156 -0
- package/dist/deep/_bea_util.js.map +1 -0
- package/dist/deep/_bls_api.d.ts +84 -0
- package/dist/deep/_bls_api.js +231 -0
- package/dist/deep/_bls_api.js.map +1 -0
- package/dist/deep/_bls_ids.d.ts +43 -0
- package/dist/deep/_bls_ids.js +188 -0
- package/dist/deep/_bls_ids.js.map +1 -0
- package/dist/deep/_bls_lib.d.ts +61 -0
- package/dist/deep/_bls_lib.js +442 -0
- package/dist/deep/_bls_lib.js.map +1 -0
- package/dist/deep/_fred_api.d.ts +148 -0
- package/dist/deep/_fred_api.js +545 -0
- package/dist/deep/_fred_api.js.map +1 -0
- package/dist/deep/_fred_pack.d.ts +162 -0
- package/dist/deep/_fred_pack.js +1027 -0
- package/dist/deep/_fred_pack.js.map +1 -0
- package/dist/deep/_fred_py.d.ts +40 -0
- package/dist/deep/_fred_py.js +199 -0
- package/dist/deep/_fred_py.js.map +1 -0
- package/dist/deep/_ipums_bundle.d.ts +29 -0
- package/dist/deep/_ipums_bundle.js +194 -0
- package/dist/deep/_ipums_bundle.js.map +1 -0
- package/dist/deep/_ipums_ddi.d.ts +23 -0
- package/dist/deep/_ipums_ddi.js +162 -0
- package/dist/deep/_ipums_ddi.js.map +1 -0
- package/dist/deep/_opm_io.d.ts +26 -0
- package/dist/deep/_opm_io.js +383 -0
- package/dist/deep/_opm_io.js.map +1 -0
- package/dist/deep/_opm_parquet.d.ts +31 -0
- package/dist/deep/_opm_parquet.js +744 -0
- package/dist/deep/_opm_parquet.js.map +1 -0
- package/dist/deep/_opm_py.d.ts +6 -0
- package/dist/deep/_opm_py.js +74 -0
- package/dist/deep/_opm_py.js.map +1 -0
- package/dist/deep/_treasury_api.d.ts +48 -0
- package/dist/deep/_treasury_api.js +221 -0
- package/dist/deep/_treasury_api.js.map +1 -0
- package/dist/deep/_treasury_context.d.ts +34 -0
- package/dist/deep/_treasury_context.js +142 -0
- package/dist/deep/_treasury_context.js.map +1 -0
- package/dist/deep/_treasury_lib.d.ts +109 -0
- package/dist/deep/_treasury_lib.js +686 -0
- package/dist/deep/_treasury_lib.js.map +1 -0
- package/dist/deep/bea.d.ts +3 -0
- package/dist/deep/bea.js +248 -0
- package/dist/deep/bea.js.map +1 -0
- package/dist/deep/bls.d.ts +3 -0
- package/dist/deep/bls.js +220 -0
- package/dist/deep/bls.js.map +1 -0
- package/dist/deep/fred.d.ts +3 -0
- package/dist/deep/fred.js +325 -0
- package/dist/deep/fred.js.map +1 -0
- package/dist/deep/ipums.d.ts +59 -0
- package/dist/deep/ipums.js +744 -0
- package/dist/deep/ipums.js.map +1 -0
- package/dist/deep/opm.d.ts +56 -0
- package/dist/deep/opm.js +1033 -0
- package/dist/deep/opm.js.map +1 -0
- package/dist/deep/treasury.d.ts +3 -0
- package/dist/deep/treasury.js +218 -0
- package/dist/deep/treasury.js.map +1 -0
- package/dist/envelope.d.ts +47 -0
- package/dist/envelope.js +88 -0
- package/dist/envelope.js.map +1 -0
- package/dist/index.d.ts +277 -0
- package/dist/index.js +106 -0
- package/dist/index.js.map +1 -0
- package/dist/remote/app.d.ts +21 -0
- package/dist/remote/app.js +218 -0
- package/dist/remote/app.js.map +1 -0
- package/dist/remote/oauth.d.ts +14 -0
- package/dist/remote/oauth.js +90 -0
- package/dist/remote/oauth.js.map +1 -0
- package/dist/remote/pages.d.ts +8 -0
- package/dist/remote/pages.js +56 -0
- package/dist/remote/pages.js.map +1 -0
- package/dist/remote/sign.d.ts +4 -0
- package/dist/remote/sign.js +40 -0
- package/dist/remote/sign.js.map +1 -0
- package/dist/remote/store.d.ts +31 -0
- package/dist/remote/store.js +129 -0
- package/dist/remote/store.js.map +1 -0
- package/dist/report/audit_answer.d.ts +94 -0
- package/dist/report/audit_answer.js +1349 -0
- package/dist/report/audit_answer.js.map +1 -0
- package/dist/report/audit_report.d.ts +23 -0
- package/dist/report/audit_report.js +637 -0
- package/dist/report/audit_report.js.map +1 -0
- package/dist/report/build_report.d.ts +27 -0
- package/dist/report/build_report.js +1168 -0
- package/dist/report/build_report.js.map +1 -0
- package/dist/report/method_audit.d.ts +47 -0
- package/dist/report/method_audit.js +716 -0
- package/dist/report/method_audit.js.map +1 -0
- package/dist/report/policyset.d.ts +50 -0
- package/dist/report/policyset.js +421 -0
- package/dist/report/policyset.js.map +1 -0
- package/dist/report/py.d.ts +58 -0
- package/dist/report/py.js +311 -0
- package/dist/report/py.js.map +1 -0
- package/dist/report/scan_secrets.d.ts +24 -0
- package/dist/report/scan_secrets.js +265 -0
- package/dist/report/scan_secrets.js.map +1 -0
- package/dist/report/style_check.d.ts +29 -0
- package/dist/report/style_check.js +173 -0
- package/dist/report/style_check.js.map +1 -0
- package/dist/report/tools.d.ts +87 -0
- package/dist/report/tools.js +167 -0
- package/dist/report/tools.js.map +1 -0
- package/dist/server.d.ts +5 -0
- package/dist/server.js +247 -0
- package/dist/server.js.map +1 -0
- package/dist/session.d.ts +47 -0
- package/dist/session.js +107 -0
- package/dist/session.js.map +1 -0
- package/dist/toolkit.d.ts +21 -0
- package/dist/toolkit.js +2 -0
- package/dist/toolkit.js.map +1 -0
- package/dist/tools.d.ts +299 -0
- package/dist/tools.js +491 -0
- package/dist/tools.js.map +1 -0
- package/guide/WORKFLOW.md +134 -0
- package/guide/assets/disclaimer.txt +1 -0
- package/guide/assets/download_data.ps1 +162 -0
- package/guide/assets/download_data.sh +143 -0
- package/guide/assets/report_template.html +597 -0
- package/guide/references/report_patterns.md +199 -0
- package/guide/references/routing.md +171 -0
- package/guide/references/style_guide.md +398 -0
- package/package.json +54 -4
- package/packs/acf/endpoints.json +114 -0
- package/packs/acf/policy.json +104 -0
- package/packs/acf/source.md +138 -0
- package/packs/actuaries/endpoints.json +82 -0
- package/packs/actuaries/policy.json +109 -0
- package/packs/actuaries/source.md +137 -0
- package/packs/bea/assets/download_bea.ps1 +182 -0
- package/packs/bea/assets/download_bea.sh +144 -0
- package/packs/bea/docs/bea_api.md +461 -0
- package/packs/bea/docs/datasets.md +157 -0
- package/packs/bea/docs/report_patterns.md +112 -0
- package/packs/bea/policy.json +170 -0
- package/packs/bea/source.md +152 -0
- package/packs/bls/assets/download_bls.ps1 +152 -0
- package/packs/bls/assets/download_bls.sh +167 -0
- package/packs/bls/docs/analysis_patterns.md +108 -0
- package/packs/bls/docs/bls_api.md +73 -0
- package/packs/bls/docs/series_ids.md +149 -0
- package/packs/bls/policy.json +238 -0
- package/packs/bls/series_ids.json +1375 -0
- package/packs/bls/source.md +156 -0
- package/packs/bts/endpoints.json +347 -0
- package/packs/bts/policy.json +94 -0
- package/packs/bts/source.md +97 -0
- package/packs/cdc/endpoints.json +197 -0
- package/packs/cdc/policy.json +83 -0
- package/packs/cdc/source.md +74 -0
- package/packs/census/endpoints.json +99 -0
- package/packs/census/policy.json +238 -0
- package/packs/census/source.md +304 -0
- package/packs/census-geocoder/endpoints.json +70 -0
- package/packs/census-geocoder/policy.json +80 -0
- package/packs/census-geocoder/source.md +53 -0
- package/packs/cfpb/endpoints.json +327 -0
- package/packs/cfpb/policy.json +119 -0
- package/packs/cfpb/source.md +96 -0
- package/packs/clinical-trials/endpoints.json +167 -0
- package/packs/clinical-trials/policy.json +84 -0
- package/packs/clinical-trials/source.md +82 -0
- package/packs/cms/endpoints.json +69 -0
- package/packs/cms/policy.json +96 -0
- package/packs/cms/source.md +112 -0
- package/packs/college-scorecard/endpoints.json +253 -0
- package/packs/college-scorecard/policy.json +106 -0
- package/packs/college-scorecard/source.md +92 -0
- package/packs/congress/endpoints.json +1701 -0
- package/packs/congress/policy.json +117 -0
- package/packs/congress/source.md +190 -0
- package/packs/dhs-ohss/endpoints.json +66 -0
- package/packs/dhs-ohss/policy.json +107 -0
- package/packs/dhs-ohss/source.md +120 -0
- package/packs/doj-news/endpoints.json +59 -0
- package/packs/doj-news/policy.json +96 -0
- package/packs/doj-news/source.md +99 -0
- package/packs/dol/endpoints.json +818 -0
- package/packs/dol/policy.json +135 -0
- package/packs/dol/source.md +181 -0
- package/packs/eia/endpoints.json +718 -0
- package/packs/eia/policy.json +112 -0
- package/packs/eia/source.md +112 -0
- package/packs/epa/endpoints.json +292 -0
- package/packs/epa/policy.json +99 -0
- package/packs/epa/source.md +99 -0
- package/packs/epa-aqs/endpoints.json +174 -0
- package/packs/epa-aqs/policy.json +96 -0
- package/packs/epa-aqs/source.md +97 -0
- package/packs/fbi/endpoints.json +1842 -0
- package/packs/fbi/policy.json +118 -0
- package/packs/fbi/source.md +108 -0
- package/packs/fda/endpoints.json +238 -0
- package/packs/fda/policy.json +121 -0
- package/packs/fda/source.md +117 -0
- package/packs/fdic/endpoints.json +417 -0
- package/packs/fdic/policy.json +83 -0
- package/packs/fdic/source.md +92 -0
- package/packs/fec/endpoints.json +708 -0
- package/packs/fec/policy.json +93 -0
- package/packs/fec/source.md +90 -0
- package/packs/fed-board/endpoints.json +89 -0
- package/packs/fed-board/policy.json +136 -0
- package/packs/fed-board/source.md +118 -0
- package/packs/federal-register/endpoints.json +143 -0
- package/packs/federal-register/policy.json +86 -0
- package/packs/federal-register/source.md +98 -0
- package/packs/fema/endpoints.json +646 -0
- package/packs/fema/policy.json +103 -0
- package/packs/fema/source.md +103 -0
- package/packs/fhfa/endpoints.json +105 -0
- package/packs/fhfa/policy.json +109 -0
- package/packs/fhfa/source.md +108 -0
- package/packs/fred/assets/download_fred.ps1 +122 -0
- package/packs/fred/assets/download_fred.sh +123 -0
- package/packs/fred/docs/analysis_patterns.md +124 -0
- package/packs/fred/docs/fred_api.md +94 -0
- package/packs/fred/docs/series.md +188 -0
- package/packs/fred/policy.json +253 -0
- package/packs/fred/source.md +142 -0
- package/packs/fsa/endpoints.json +150 -0
- package/packs/fsa/policy.json +99 -0
- package/packs/fsa/source.md +102 -0
- package/packs/govinfo/endpoints.json +520 -0
- package/packs/govinfo/policy.json +116 -0
- package/packs/govinfo/source.md +241 -0
- package/packs/gsa-calc/endpoints.json +93 -0
- package/packs/gsa-calc/policy.json +97 -0
- package/packs/gsa-calc/source.md +108 -0
- package/packs/hud/endpoints.json +147 -0
- package/packs/hud/policy.json +84 -0
- package/packs/hud/source.md +97 -0
- package/packs/ipums/assets/download_ipums.ps1 +215 -0
- package/packs/ipums/assets/download_ipums.sh +192 -0
- package/packs/ipums/docs/ipums_api.md +67 -0
- package/packs/ipums/docs/report_patterns.md +117 -0
- package/packs/ipums/docs/variables.md +284 -0
- package/packs/ipums/lib/fetch_text.json +112 -0
- package/packs/ipums/policy.json +215 -0
- package/packs/ipums/source.md +169 -0
- package/packs/irs-soi/endpoints.json +114 -0
- package/packs/irs-soi/policy.json +107 -0
- package/packs/irs-soi/source.md +124 -0
- package/packs/medicaid/endpoints.json +412 -0
- package/packs/medicaid/policy.json +108 -0
- package/packs/medicaid/source.md +136 -0
- package/packs/naep/endpoints.json +217 -0
- package/packs/naep/policy.json +100 -0
- package/packs/naep/source.md +120 -0
- package/packs/nhtsa/endpoints.json +132 -0
- package/packs/nhtsa/policy.json +93 -0
- package/packs/nhtsa/source.md +109 -0
- package/packs/nih/endpoints.json +453 -0
- package/packs/nih/policy.json +86 -0
- package/packs/nih/source.md +108 -0
- package/packs/noaa/endpoints.json +432 -0
- package/packs/noaa/policy.json +95 -0
- package/packs/noaa/source.md +88 -0
- package/packs/nrel/endpoints.json +328 -0
- package/packs/nrel/policy.json +96 -0
- package/packs/nrel/source.md +91 -0
- package/packs/nws/endpoints.json +272 -0
- package/packs/nws/policy.json +82 -0
- package/packs/nws/source.md +81 -0
- package/packs/nyfed/endpoints.json +80 -0
- package/packs/nyfed/policy.json +92 -0
- package/packs/nyfed/source.md +89 -0
- package/packs/omb/endpoints.json +460 -0
- package/packs/omb/policy.json +106 -0
- package/packs/omb/source.md +130 -0
- package/packs/open-payments/endpoints.json +298 -0
- package/packs/open-payments/policy.json +101 -0
- package/packs/open-payments/source.md +99 -0
- package/packs/opm/assets/download_opm.ps1 +125 -0
- package/packs/opm/assets/download_opm.sh +85 -0
- package/packs/opm/docs/fields.md +184 -0
- package/packs/opm/docs/opm_api.md +71 -0
- package/packs/opm/docs/report_patterns.md +83 -0
- package/packs/opm/lib/data_dictionary.csv +73 -0
- package/packs/opm/policy.json +142 -0
- package/packs/opm/source.md +137 -0
- package/packs/pbgc/endpoints.json +483 -0
- package/packs/pbgc/policy.json +94 -0
- package/packs/pbgc/source.md +95 -0
- package/packs/philfed/endpoints.json +85 -0
- package/packs/philfed/policy.json +94 -0
- package/packs/philfed/source.md +125 -0
- package/packs/port.json +287 -0
- package/packs/regulations/endpoints.json +288 -0
- package/packs/regulations/policy.json +86 -0
- package/packs/regulations/source.md +84 -0
- package/packs/sec/endpoints.json +237 -0
- package/packs/sec/policy.json +86 -0
- package/packs/sec/source.md +101 -0
- package/packs/senate-lobbying/endpoints.json +554 -0
- package/packs/senate-lobbying/policy.json +99 -0
- package/packs/senate-lobbying/source.md +100 -0
- package/packs/snapqc/endpoints.json +1426 -0
- package/packs/snapqc/policy.json +92 -0
- package/packs/snapqc/source.md +96 -0
- package/packs/treasury/catalog.json +2267 -0
- package/packs/treasury/docs/api_guide.md +245 -0
- package/packs/treasury/docs/datasets.md +56 -0
- package/packs/treasury/docs/report_patterns.md +126 -0
- package/packs/treasury/policy.json +159 -0
- package/packs/treasury/source.md +170 -0
- package/packs/treasury-yields/endpoints.json +226 -0
- package/packs/treasury-yields/policy.json +86 -0
- package/packs/treasury-yields/source.md +80 -0
- package/packs/usaspending/endpoints.json +1316 -0
- package/packs/usaspending/policy.json +109 -0
- package/packs/usaspending/source.md +103 -0
- package/packs/usda-fna/endpoints.json +427 -0
- package/packs/usda-fna/policy.json +133 -0
- package/packs/usda-fna/source.md +217 -0
- package/packs/usda-fooddata/endpoints.json +181 -0
- package/packs/usda-fooddata/policy.json +94 -0
- package/packs/usda-fooddata/source.md +105 -0
- package/packs/usda-nass/endpoints.json +324 -0
- package/packs/usda-nass/policy.json +95 -0
- package/packs/usda-nass/source.md +85 -0
- package/packs/usda-outlook/endpoints.json +86 -0
- package/packs/usda-outlook/policy.json +109 -0
- package/packs/usda-outlook/source.md +144 -0
- package/packs/usgs/endpoints.json +313 -0
- package/packs/usgs/policy.json +95 -0
- package/packs/usgs/source.md +96 -0
- package/packs/usitc/endpoints.json +74 -0
- package/packs/usitc/policy.json +111 -0
- package/packs/usitc/source.md +90 -0
- package/packs/uspto/endpoints.json +141 -0
- package/packs/uspto/policy.json +95 -0
- package/packs/uspto/source.md +101 -0
- package/packs/va/endpoints.json +414 -0
- package/packs/va/policy.json +101 -0
- package/packs/va/source.md +129 -0
- package/packs/world-bank/endpoints.json +122 -0
- package/packs/world-bank/policy.json +101 -0
- 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.
|