data-analyst-mcp 0.3.0 → 0.4.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 (292) hide show
  1. package/README.md +286 -262
  2. package/dist/adapters/bjs.d.ts +13 -0
  3. package/dist/adapters/bjs.js +28 -0
  4. package/dist/adapters/bjs.js.map +1 -0
  5. package/dist/adapters/cbp.d.ts +5 -0
  6. package/dist/adapters/cbp.js +64 -0
  7. package/dist/adapters/cbp.js.map +1 -0
  8. package/dist/adapters/cdc-wonder.d.ts +5 -0
  9. package/dist/adapters/cdc-wonder.js +68 -0
  10. package/dist/adapters/cdc-wonder.js.map +1 -0
  11. package/dist/adapters/cpsc.d.ts +4 -0
  12. package/dist/adapters/cpsc.js +125 -0
  13. package/dist/adapters/cpsc.js.map +1 -0
  14. package/dist/adapters/fhwa.d.ts +9 -0
  15. package/dist/adapters/fhwa.js +16 -0
  16. package/dist/adapters/fhwa.js.map +1 -0
  17. package/dist/adapters/foreign-assistance.d.ts +9 -0
  18. package/dist/adapters/foreign-assistance.js +42 -0
  19. package/dist/adapters/foreign-assistance.js.map +1 -0
  20. package/dist/adapters/hud-ahar.d.ts +3 -0
  21. package/dist/adapters/hud-ahar.js +80 -0
  22. package/dist/adapters/hud-ahar.js.map +1 -0
  23. package/dist/adapters/nces.d.ts +10 -0
  24. package/dist/adapters/nces.js +32 -0
  25. package/dist/adapters/nces.js.map +1 -0
  26. package/dist/adapters/nsf.d.ts +11 -0
  27. package/dist/adapters/nsf.js +25 -0
  28. package/dist/adapters/nsf.js.map +1 -0
  29. package/dist/adapters/onrr.d.ts +9 -0
  30. package/dist/adapters/onrr.js +35 -0
  31. package/dist/adapters/onrr.js.map +1 -0
  32. package/dist/adapters/sba.d.ts +10 -0
  33. package/dist/adapters/sba.js +134 -0
  34. package/dist/adapters/sba.js.map +1 -0
  35. package/dist/adapters/treasury-tic.d.ts +30 -0
  36. package/dist/adapters/treasury-tic.js +149 -0
  37. package/dist/adapters/treasury-tic.js.map +1 -0
  38. package/dist/adapters/uscourts.d.ts +8 -0
  39. package/dist/adapters/uscourts.js +8 -0
  40. package/dist/adapters/uscourts.js.map +1 -0
  41. package/dist/analysis/cite.d.ts +9 -1
  42. package/dist/analysis/cite.js +9 -2
  43. package/dist/analysis/cite.js.map +1 -1
  44. package/dist/bin/cli.d.ts +2 -0
  45. package/dist/bin/cli.js +17 -0
  46. package/dist/bin/cli.js.map +1 -1
  47. package/dist/core/generic-rest.js +42 -17
  48. package/dist/core/generic-rest.js.map +1 -1
  49. package/dist/core/guard.d.ts +32 -0
  50. package/dist/core/guard.js +176 -0
  51. package/dist/core/guard.js.map +1 -0
  52. package/dist/core/http.d.ts +10 -0
  53. package/dist/core/http.js +36 -7
  54. package/dist/core/http.js.map +1 -1
  55. package/dist/core/keys.d.ts +13 -3
  56. package/dist/core/keys.js +67 -7
  57. package/dist/core/keys.js.map +1 -1
  58. package/dist/core/package.d.ts +12 -3
  59. package/dist/core/package.js +56 -12
  60. package/dist/core/package.js.map +1 -1
  61. package/dist/core/secret_patterns.d.ts +6 -0
  62. package/dist/core/secret_patterns.js +20 -0
  63. package/dist/core/secret_patterns.js.map +1 -0
  64. package/dist/core/tabular.d.ts +43 -1
  65. package/dist/core/tabular.js +149 -6
  66. package/dist/core/tabular.js.map +1 -1
  67. package/dist/envelope.js +3 -1
  68. package/dist/envelope.js.map +1 -1
  69. package/dist/index.d.ts +29 -22
  70. package/dist/index.js +45 -46
  71. package/dist/index.js.map +1 -1
  72. package/dist/remote/app.js +87 -31
  73. package/dist/remote/app.js.map +1 -1
  74. package/dist/remote/oauth.js +8 -1
  75. package/dist/remote/oauth.js.map +1 -1
  76. package/dist/remote/pages.d.ts +3 -7
  77. package/dist/remote/pages.js +49 -19
  78. package/dist/remote/pages.js.map +1 -1
  79. package/dist/remote/sign.d.ts +7 -1
  80. package/dist/remote/sign.js +33 -7
  81. package/dist/remote/sign.js.map +1 -1
  82. package/dist/remote/store.js +14 -5
  83. package/dist/remote/store.js.map +1 -1
  84. package/dist/report/audit_report.js +29 -7
  85. package/dist/report/audit_report.js.map +1 -1
  86. package/dist/report/build_report.js +34 -4
  87. package/dist/report/build_report.js.map +1 -1
  88. package/dist/report/method_audit.js +10 -1
  89. package/dist/report/method_audit.js.map +1 -1
  90. package/dist/report/scan_secrets.d.ts +4 -1
  91. package/dist/report/scan_secrets.js +38 -18
  92. package/dist/report/scan_secrets.js.map +1 -1
  93. package/dist/server.d.ts +3 -1
  94. package/dist/server.js +46 -13
  95. package/dist/server.js.map +1 -1
  96. package/dist/tools.js +27 -6
  97. package/dist/tools.js.map +1 -1
  98. package/guide/WORKFLOW.md +134 -134
  99. package/guide/assets/disclaimer.txt +1 -1
  100. package/guide/assets/download_data.ps1 +164 -162
  101. package/guide/assets/download_data.sh +8 -2
  102. package/guide/assets/report_template.html +597 -597
  103. package/guide/references/routing.md +198 -171
  104. package/guide/references/style_guide.md +398 -398
  105. package/package.json +56 -56
  106. package/packs/acf/endpoints.json +114 -114
  107. package/packs/acf/policy.json +104 -104
  108. package/packs/actuaries/endpoints.json +82 -82
  109. package/packs/actuaries/policy.json +109 -109
  110. package/packs/bea/assets/download_bea.ps1 +182 -182
  111. package/packs/bea/docs/bea_api.md +461 -461
  112. package/packs/bea/docs/datasets.md +157 -157
  113. package/packs/bea/docs/report_patterns.md +112 -112
  114. package/packs/bea/policy.json +170 -170
  115. package/packs/bea/source.md +152 -152
  116. package/packs/bjs/endpoints.json +150 -0
  117. package/packs/bjs/policy.json +114 -0
  118. package/packs/bjs/source.md +98 -0
  119. package/packs/bls/assets/download_bls.ps1 +152 -152
  120. package/packs/bls/docs/analysis_patterns.md +108 -108
  121. package/packs/bls/docs/bls_api.md +73 -73
  122. package/packs/bls/docs/series_ids.md +149 -149
  123. package/packs/bls/policy.json +238 -238
  124. package/packs/bts/endpoints.json +346 -346
  125. package/packs/bts/policy.json +94 -94
  126. package/packs/cbp/endpoints.json +31 -0
  127. package/packs/cbp/policy.json +85 -0
  128. package/packs/cbp/source.md +57 -0
  129. package/packs/cdc/endpoints.json +197 -197
  130. package/packs/cdc/policy.json +83 -83
  131. package/packs/cdc/source.md +1 -1
  132. package/packs/cdc-wonder/endpoints.json +26 -0
  133. package/packs/cdc-wonder/policy.json +84 -0
  134. package/packs/cdc-wonder/source.md +53 -0
  135. package/packs/census/endpoints.json +99 -99
  136. package/packs/cfpb/endpoints.json +326 -326
  137. package/packs/cfpb/policy.json +119 -119
  138. package/packs/clinical-trials/endpoints.json +166 -166
  139. package/packs/clinical-trials/policy.json +84 -84
  140. package/packs/cms/endpoints.json +69 -69
  141. package/packs/cms/policy.json +96 -96
  142. package/packs/college-scorecard/endpoints.json +252 -252
  143. package/packs/college-scorecard/policy.json +106 -106
  144. package/packs/college-scorecard/source.md +1 -1
  145. package/packs/congress/endpoints.json +1701 -1701
  146. package/packs/congress/policy.json +117 -117
  147. package/packs/cpsc/endpoints.json +91 -0
  148. package/packs/cpsc/policy.json +91 -0
  149. package/packs/cpsc/source.md +76 -0
  150. package/packs/dhs-ohss/endpoints.json +66 -66
  151. package/packs/dhs-ohss/policy.json +107 -107
  152. package/packs/dhs-ohss/source.md +1 -1
  153. package/packs/doj-news/endpoints.json +59 -59
  154. package/packs/doj-news/policy.json +96 -96
  155. package/packs/doj-news/source.md +1 -1
  156. package/packs/dol/endpoints.json +817 -817
  157. package/packs/dol/policy.json +135 -135
  158. package/packs/eia/endpoints.json +717 -717
  159. package/packs/eia/policy.json +112 -112
  160. package/packs/epa/endpoints.json +291 -291
  161. package/packs/epa/policy.json +99 -99
  162. package/packs/epa-aqs/endpoints.json +173 -173
  163. package/packs/epa-aqs/policy.json +96 -96
  164. package/packs/fbi/endpoints.json +1841 -1841
  165. package/packs/fbi/policy.json +118 -118
  166. package/packs/fbi/source.md +3 -3
  167. package/packs/fda/endpoints.json +237 -237
  168. package/packs/fda/policy.json +121 -121
  169. package/packs/fdic/endpoints.json +416 -416
  170. package/packs/fdic/policy.json +83 -83
  171. package/packs/fec/endpoints.json +707 -707
  172. package/packs/fec/policy.json +93 -93
  173. package/packs/fed-board/endpoints.json +89 -89
  174. package/packs/fed-board/policy.json +136 -136
  175. package/packs/federal-register/endpoints.json +143 -143
  176. package/packs/federal-register/policy.json +86 -86
  177. package/packs/fema/endpoints.json +645 -645
  178. package/packs/fema/policy.json +103 -103
  179. package/packs/fhfa/endpoints.json +105 -105
  180. package/packs/fhfa/policy.json +109 -109
  181. package/packs/fhwa/endpoints.json +48 -0
  182. package/packs/fhwa/policy.json +91 -0
  183. package/packs/fhwa/source.md +59 -0
  184. package/packs/foreign-assistance/endpoints.json +166 -0
  185. package/packs/foreign-assistance/policy.json +80 -0
  186. package/packs/foreign-assistance/source.md +76 -0
  187. package/packs/fred/assets/download_fred.ps1 +122 -122
  188. package/packs/fred/docs/analysis_patterns.md +124 -124
  189. package/packs/fred/docs/fred_api.md +94 -94
  190. package/packs/fred/docs/series.md +188 -188
  191. package/packs/fred/policy.json +253 -253
  192. package/packs/fsa/endpoints.json +150 -150
  193. package/packs/fsa/policy.json +99 -99
  194. package/packs/fsa/source.md +1 -1
  195. package/packs/govinfo/endpoints.json +519 -519
  196. package/packs/gsa-calc/endpoints.json +93 -93
  197. package/packs/gsa-calc/policy.json +97 -97
  198. package/packs/hud/endpoints.json +146 -146
  199. package/packs/hud/policy.json +84 -84
  200. package/packs/hud/source.md +1 -1
  201. package/packs/hud-ahar/endpoints.json +92 -0
  202. package/packs/hud-ahar/policy.json +88 -0
  203. package/packs/hud-ahar/source.md +72 -0
  204. package/packs/ipums/docs/report_patterns.md +117 -117
  205. package/packs/irs-soi/endpoints.json +114 -114
  206. package/packs/irs-soi/policy.json +107 -107
  207. package/packs/medicaid/endpoints.json +412 -412
  208. package/packs/medicaid/policy.json +108 -108
  209. package/packs/naep/endpoints.json +217 -217
  210. package/packs/naep/policy.json +100 -100
  211. package/packs/naep/source.md +1 -1
  212. package/packs/nces/endpoints.json +101 -0
  213. package/packs/nces/policy.json +99 -0
  214. package/packs/nces/source.md +75 -0
  215. package/packs/nhtsa/endpoints.json +132 -132
  216. package/packs/nhtsa/policy.json +93 -93
  217. package/packs/nhtsa/source.md +1 -1
  218. package/packs/nih/endpoints.json +452 -452
  219. package/packs/nih/policy.json +86 -86
  220. package/packs/noaa/endpoints.json +431 -431
  221. package/packs/noaa/policy.json +95 -95
  222. package/packs/nrel/endpoints.json +327 -327
  223. package/packs/nrel/policy.json +96 -96
  224. package/packs/nsf/endpoints.json +33 -0
  225. package/packs/nsf/policy.json +83 -0
  226. package/packs/nsf/source.md +59 -0
  227. package/packs/nws/endpoints.json +271 -271
  228. package/packs/nws/policy.json +82 -82
  229. package/packs/nyfed/endpoints.json +80 -80
  230. package/packs/nyfed/policy.json +92 -92
  231. package/packs/omb/endpoints.json +460 -460
  232. package/packs/omb/policy.json +106 -106
  233. package/packs/onrr/endpoints.json +198 -0
  234. package/packs/onrr/policy.json +91 -0
  235. package/packs/onrr/source.md +55 -0
  236. package/packs/open-payments/endpoints.json +297 -297
  237. package/packs/open-payments/policy.json +101 -101
  238. package/packs/opm/assets/download_opm.ps1 +125 -125
  239. package/packs/opm/docs/fields.md +184 -184
  240. package/packs/opm/docs/opm_api.md +71 -71
  241. package/packs/opm/docs/report_patterns.md +83 -83
  242. package/packs/opm/lib/data_dictionary.csv +73 -73
  243. package/packs/pbgc/endpoints.json +483 -483
  244. package/packs/pbgc/policy.json +94 -94
  245. package/packs/philfed/endpoints.json +85 -85
  246. package/packs/philfed/policy.json +94 -94
  247. package/packs/port.json +65 -0
  248. package/packs/regulations/endpoints.json +287 -287
  249. package/packs/regulations/policy.json +86 -86
  250. package/packs/sba/endpoints.json +34 -0
  251. package/packs/sba/policy.json +86 -0
  252. package/packs/sba/source.md +60 -0
  253. package/packs/sec/endpoints.json +236 -236
  254. package/packs/sec/policy.json +86 -86
  255. package/packs/senate-lobbying/endpoints.json +553 -553
  256. package/packs/senate-lobbying/policy.json +99 -99
  257. package/packs/snapqc/endpoints.json +1426 -1426
  258. package/packs/snapqc/policy.json +92 -92
  259. package/packs/treasury/catalog.json +2267 -2267
  260. package/packs/treasury/docs/api_guide.md +245 -245
  261. package/packs/treasury/docs/datasets.md +56 -56
  262. package/packs/treasury/docs/report_patterns.md +126 -126
  263. package/packs/treasury/policy.json +159 -159
  264. package/packs/treasury/source.md +170 -165
  265. package/packs/treasury-tic/endpoints.json +77 -0
  266. package/packs/treasury-tic/policy.json +89 -0
  267. package/packs/treasury-tic/source.md +80 -0
  268. package/packs/treasury-yields/endpoints.json +226 -226
  269. package/packs/treasury-yields/policy.json +86 -86
  270. package/packs/usaspending/endpoints.json +1315 -1315
  271. package/packs/usaspending/policy.json +109 -109
  272. package/packs/uscourts/endpoints.json +22 -0
  273. package/packs/uscourts/policy.json +87 -0
  274. package/packs/uscourts/source.md +56 -0
  275. package/packs/usda-fna/policy.json +133 -133
  276. package/packs/usda-fooddata/endpoints.json +180 -180
  277. package/packs/usda-fooddata/policy.json +94 -94
  278. package/packs/usda-nass/endpoints.json +323 -323
  279. package/packs/usda-nass/policy.json +95 -95
  280. package/packs/usda-outlook/endpoints.json +86 -86
  281. package/packs/usda-outlook/policy.json +109 -109
  282. package/packs/usgs/endpoints.json +313 -313
  283. package/packs/usgs/policy.json +95 -95
  284. package/packs/usitc/endpoints.json +74 -74
  285. package/packs/usitc/policy.json +111 -111
  286. package/packs/uspto/endpoints.json +141 -141
  287. package/packs/uspto/policy.json +95 -95
  288. package/packs/uspto/source.md +1 -1
  289. package/packs/va/endpoints.json +414 -414
  290. package/packs/va/policy.json +101 -101
  291. package/packs/world-bank/endpoints.json +122 -122
  292. package/packs/world-bank/policy.json +101 -101
@@ -1,106 +1,106 @@
1
- {
2
- "id": "omb",
3
- "title": "OMB President's Budget data (Historical Tables, Public Budget Database, Federal Credit Supplement) via GovInfo",
4
- "agency": "Office of Management and Budget (published by the U.S. Government Publishing Office, GovInfo)",
5
- "depth": "standard",
6
- "domains": [
7
- "federal budget",
8
- "public finance",
9
- "federal debt",
10
- "federal credit"
11
- ],
12
- "keywords": [
13
- "omb",
14
- "office of management and budget",
15
- "president's budget",
16
- "budget of the united states government",
17
- "historical tables",
18
- "public budget database",
19
- "budget authority",
20
- "outlays",
21
- "receipts",
22
- "deficit",
23
- "surplus",
24
- "federal spending",
25
- "federal revenue",
26
- "outlays by function",
27
- "outlays by agency",
28
- "budget function",
29
- "subfunction",
30
- "mandatory spending",
31
- "discretionary spending",
32
- "net interest",
33
- "on-budget",
34
- "off-budget",
35
- "percent of gdp",
36
- "federal debt held by the public",
37
- "debt limit",
38
- "grants to state and local governments",
39
- "payments for individuals",
40
- "federal employment",
41
- "fte",
42
- "federal credit supplement",
43
- "credit subsidy rate",
44
- "loan guarantees",
45
- "direct loans",
46
- "subsidy reestimates",
47
- "budget account"
48
- ],
49
- "questions": [
50
- "total federal outlays, receipts and the deficit since 1940 in dollars and as a percent of GDP",
51
- "federal outlays by budget function or by agency over time",
52
- "mandatory versus discretionary outlays history",
53
- "budget authority or outlays for one budget account from the Public Budget Database",
54
- "credit subsidy rates of federal direct loan and loan guarantee programs",
55
- "federal debt held by the public as a percent of GDP history"
56
- ],
57
- "homepage": "https://www.govinfo.gov/app/collection/budget",
58
- "terms_url": "https://www.govinfo.gov/about/policies",
59
- "auth": {
60
- "env": null,
61
- "required": "none",
62
- "placement": "none",
63
- "signup_url": null,
64
- "echoes_key": false
65
- },
66
- "limits": {
67
- "rps": 2,
68
- "burst": 4,
69
- "max_rows": 50000
70
- },
71
- "routes": {
72
- "api": {
73
- "base": "https://www.govinfo.gov/content/pkg",
74
- "probe": "https://www.govinfo.gov/content/pkg/BUDGET-2027-TAB/xls/BUDGET-2027-TAB-2-1.xlsx",
75
- "hosts": [
76
- "www.govinfo.gov"
77
- ]
78
- },
79
- "manual": {
80
- "how": "Open each link in manual_download/INSTRUCTIONS.md in a browser (GovInfo files, no sign-in) and save the file under the name shown, then upload it. If a Historical Tables link opens GovInfo's error page, download the edition's package zip (https://www.govinfo.gov/content/pkg/BUDGET-<FY>-TAB.zip) and upload that instead. The same files are on whitehouse.gov: Historical Tables at https://www.whitehouse.gov/omb/information-resources/budget/historical-tables/ (hist01z1_fy2027.xlsx ...), the Public Budget Database and Federal Credit Supplement at https://www.whitehouse.gov/omb/information-resources/budget/supplemental-materials/ (outlays_fy2027.xlsx, budauth_fy2027.xlsx, receipts_fy2027.xlsx, cr_supp_fy2027.xlsx); whitehouse.gov keeps only recent editions."
81
- }
82
- },
83
- "cache": {
84
- "mode": "run_only",
85
- "ttl_hours": null,
86
- "why": "Each edition is fixed once published, but files are a few MB at most; data/ is reused within a run."
87
- },
88
- "redistribution": {
89
- "mode": "allowed",
90
- "why": "The Budget of the U.S. Government is a U.S. government work (17 U.S.C. 105), in the public domain; GovInfo content is free to reuse."
91
- },
92
- "notices": [],
93
- "retention": null,
94
- "citation": "Office of Management and Budget, Budget of the U.S. Government, {dataset}, GovInfo (www.govinfo.gov), retrieved {retrieved_long}.",
95
- "audit_hooks": [],
96
- "clarify": [
97
- "Which budget edition (fy)? Each edition revises history and adds the President's estimates; the default is the newest edition on GovInfo (FY2027 as of October 2026), and a comparison across years should come from one edition.",
98
- "Actual years only, or also the budget's estimates (the current year and the President's proposals for the budget year and beyond)? Default: actuals only, with estimates labelled if used.",
99
- "Nominal dollars, constant (FY 2017) dollars, or percent of GDP? Default: nominal, with percent of GDP from Tables 1.2, 2.3, 3.1 or 7.1 when shares are asked."
100
- ],
101
- "formats": [
102
- "xlsx",
103
- "csv",
104
- "zip"
105
- ]
106
- }
1
+ {
2
+ "id": "omb",
3
+ "title": "OMB President's Budget data (Historical Tables, Public Budget Database, Federal Credit Supplement) via GovInfo",
4
+ "agency": "Office of Management and Budget (published by the U.S. Government Publishing Office, GovInfo)",
5
+ "depth": "standard",
6
+ "domains": [
7
+ "federal budget",
8
+ "public finance",
9
+ "federal debt",
10
+ "federal credit"
11
+ ],
12
+ "keywords": [
13
+ "omb",
14
+ "office of management and budget",
15
+ "president's budget",
16
+ "budget of the united states government",
17
+ "historical tables",
18
+ "public budget database",
19
+ "budget authority",
20
+ "outlays",
21
+ "receipts",
22
+ "deficit",
23
+ "surplus",
24
+ "federal spending",
25
+ "federal revenue",
26
+ "outlays by function",
27
+ "outlays by agency",
28
+ "budget function",
29
+ "subfunction",
30
+ "mandatory spending",
31
+ "discretionary spending",
32
+ "net interest",
33
+ "on-budget",
34
+ "off-budget",
35
+ "percent of gdp",
36
+ "federal debt held by the public",
37
+ "debt limit",
38
+ "grants to state and local governments",
39
+ "payments for individuals",
40
+ "federal employment",
41
+ "fte",
42
+ "federal credit supplement",
43
+ "credit subsidy rate",
44
+ "loan guarantees",
45
+ "direct loans",
46
+ "subsidy reestimates",
47
+ "budget account"
48
+ ],
49
+ "questions": [
50
+ "total federal outlays, receipts and the deficit since 1940 in dollars and as a percent of GDP",
51
+ "federal outlays by budget function or by agency over time",
52
+ "mandatory versus discretionary outlays history",
53
+ "budget authority or outlays for one budget account from the Public Budget Database",
54
+ "credit subsidy rates of federal direct loan and loan guarantee programs",
55
+ "federal debt held by the public as a percent of GDP history"
56
+ ],
57
+ "homepage": "https://www.govinfo.gov/app/collection/budget",
58
+ "terms_url": "https://www.govinfo.gov/about/policies",
59
+ "auth": {
60
+ "env": null,
61
+ "required": "none",
62
+ "placement": "none",
63
+ "signup_url": null,
64
+ "echoes_key": false
65
+ },
66
+ "limits": {
67
+ "rps": 2,
68
+ "burst": 4,
69
+ "max_rows": 50000
70
+ },
71
+ "routes": {
72
+ "api": {
73
+ "base": "https://www.govinfo.gov/content/pkg",
74
+ "probe": "https://www.govinfo.gov/content/pkg/BUDGET-2027-TAB/xls/BUDGET-2027-TAB-2-1.xlsx",
75
+ "hosts": [
76
+ "www.govinfo.gov"
77
+ ]
78
+ },
79
+ "manual": {
80
+ "how": "Open each link in manual_download/INSTRUCTIONS.md in a browser (GovInfo files, no sign-in) and save the file under the name shown, then upload it. If a Historical Tables link opens GovInfo's error page, download the edition's package zip (https://www.govinfo.gov/content/pkg/BUDGET-<FY>-TAB.zip) and upload that instead. The same files are on whitehouse.gov: Historical Tables at https://www.whitehouse.gov/omb/information-resources/budget/historical-tables/ (hist01z1_fy2027.xlsx ...), the Public Budget Database and Federal Credit Supplement at https://www.whitehouse.gov/omb/information-resources/budget/supplemental-materials/ (outlays_fy2027.xlsx, budauth_fy2027.xlsx, receipts_fy2027.xlsx, cr_supp_fy2027.xlsx); whitehouse.gov keeps only recent editions."
81
+ }
82
+ },
83
+ "cache": {
84
+ "mode": "run_only",
85
+ "ttl_hours": null,
86
+ "why": "Each edition is fixed once published, but files are a few MB at most; data/ is reused within a run."
87
+ },
88
+ "redistribution": {
89
+ "mode": "allowed",
90
+ "why": "The Budget of the U.S. Government is a U.S. government work (17 U.S.C. 105), in the public domain; GovInfo content is free to reuse."
91
+ },
92
+ "notices": [],
93
+ "retention": null,
94
+ "citation": "Office of Management and Budget, Budget of the U.S. Government, {dataset}, GovInfo (www.govinfo.gov), retrieved {retrieved_long}.",
95
+ "audit_hooks": [],
96
+ "clarify": [
97
+ "Which budget edition (fy)? Each edition revises history and adds the President's estimates; the default is the newest edition on GovInfo (FY2027 as of October 2026), and a comparison across years should come from one edition.",
98
+ "Actual years only, or also the budget's estimates (the current year and the President's proposals for the budget year and beyond)? Default: actuals only, with estimates labelled if used.",
99
+ "Nominal dollars, constant (FY 2017) dollars, or percent of GDP? Default: nominal, with percent of GDP from Tables 1.2, 2.3, 3.1 or 7.1 when shares are asked."
100
+ ],
101
+ "formats": [
102
+ "xlsx",
103
+ "csv",
104
+ "zip"
105
+ ]
106
+ }
@@ -0,0 +1,198 @@
1
+ {
2
+ "base_url": "https://revenuedata.onrr.gov",
3
+ "timeout": 240,
4
+ "endpoints": {
5
+ "fiscal_year_revenue": {
6
+ "path": "/downloads/fiscal_year_revenue.csv",
7
+ "method": "GET",
8
+ "description": "Federal and Native American natural resource revenue (royalties, rents, bonuses, other) by fiscal year, land class and category, state, county, offshore region, revenue type, lease type, commodity and product, dollars (ONRR, FY2004 on).",
9
+ "params": {
10
+ "state": {
11
+ "in": "spec",
12
+ "desc": "keep these states (full name as published, e.g. New Mexico; a list works)"
13
+ },
14
+ "from": {
15
+ "in": "spec",
16
+ "desc": "first year to keep (fiscal or calendar, as the file)"
17
+ },
18
+ "to": {
19
+ "in": "spec",
20
+ "desc": "last year to keep"
21
+ },
22
+ "commodity": {
23
+ "in": "spec",
24
+ "desc": "keep these commodities (Oil, Gas, Coal ...; as published, case-insensitive)"
25
+ },
26
+ "revenue_type": {
27
+ "in": "spec",
28
+ "desc": "keep these revenue types: Royalties, Rents, Bonus, Other revenues, Civil penalties, Inspection fees"
29
+ },
30
+ "land_class": {
31
+ "in": "spec",
32
+ "desc": "Federal or Native American"
33
+ }
34
+ },
35
+ "records": "$csv",
36
+ "paging": {
37
+ "type": "none"
38
+ },
39
+ "max_rows": 600000
40
+ },
41
+ "calendar_year_revenue": {
42
+ "path": "/downloads/calendar_year_revenue.csv",
43
+ "method": "GET",
44
+ "description": "The same revenue by calendar year (CY2003 on).",
45
+ "params": {
46
+ "state": {
47
+ "in": "spec",
48
+ "desc": "keep these states (full name as published, e.g. New Mexico; a list works)"
49
+ },
50
+ "from": {
51
+ "in": "spec",
52
+ "desc": "first year to keep (fiscal or calendar, as the file)"
53
+ },
54
+ "to": {
55
+ "in": "spec",
56
+ "desc": "last year to keep"
57
+ },
58
+ "commodity": {
59
+ "in": "spec",
60
+ "desc": "keep these commodities (Oil, Gas, Coal ...; as published, case-insensitive)"
61
+ },
62
+ "revenue_type": {
63
+ "in": "spec",
64
+ "desc": "keep these revenue types: Royalties, Rents, Bonus, Other revenues, Civil penalties, Inspection fees"
65
+ },
66
+ "land_class": {
67
+ "in": "spec",
68
+ "desc": "Federal or Native American"
69
+ }
70
+ },
71
+ "records": "$csv",
72
+ "paging": {
73
+ "type": "none"
74
+ },
75
+ "max_rows": 600000
76
+ },
77
+ "monthly_revenue": {
78
+ "path": "/downloads/monthly_revenue.csv",
79
+ "method": "GET",
80
+ "description": "The same revenue by month (January 2003 on); a 42 MB file: filter by state and years.",
81
+ "params": {
82
+ "state": {
83
+ "in": "spec",
84
+ "desc": "keep these states (full name as published, e.g. New Mexico; a list works)"
85
+ },
86
+ "from": {
87
+ "in": "spec",
88
+ "desc": "first year to keep (fiscal or calendar, as the file)"
89
+ },
90
+ "to": {
91
+ "in": "spec",
92
+ "desc": "last year to keep"
93
+ },
94
+ "commodity": {
95
+ "in": "spec",
96
+ "desc": "keep these commodities (Oil, Gas, Coal ...; as published, case-insensitive)"
97
+ },
98
+ "revenue_type": {
99
+ "in": "spec",
100
+ "desc": "keep these revenue types: Royalties, Rents, Bonus, Other revenues, Civil penalties, Inspection fees"
101
+ },
102
+ "land_class": {
103
+ "in": "spec",
104
+ "desc": "Federal or Native American"
105
+ }
106
+ },
107
+ "records": "$csv",
108
+ "paging": {
109
+ "type": "none"
110
+ },
111
+ "max_rows": 2000000
112
+ },
113
+ "fiscal_year_disbursements": {
114
+ "path": "/downloads/fiscal_year_disbursements.csv",
115
+ "method": "GET",
116
+ "description": "Where the revenue went: disbursements by fiscal year to the U.S. Treasury, states and counties, the Reclamation Fund, Land and Water Conservation Fund, Historic Preservation Fund, Native American tribes and individuals, other funds (FY2003 on).",
117
+ "params": {
118
+ "state": {
119
+ "in": "spec",
120
+ "desc": "keep these states (full name as published, e.g. New Mexico; a list works)"
121
+ },
122
+ "from": {
123
+ "in": "spec",
124
+ "desc": "first year to keep (fiscal or calendar, as the file)"
125
+ },
126
+ "to": {
127
+ "in": "spec",
128
+ "desc": "last year to keep"
129
+ },
130
+ "fund_type": {
131
+ "in": "spec",
132
+ "desc": "keep these fund types as published (State and local governments, U.S. Treasury, Reclamation Fund ...)"
133
+ }
134
+ },
135
+ "records": "$csv",
136
+ "paging": {
137
+ "type": "none"
138
+ },
139
+ "max_rows": 600000
140
+ },
141
+ "fiscal_year_production": {
142
+ "path": "/downloads/fiscal_year_production.csv",
143
+ "method": "GET",
144
+ "description": "Production volumes on federal and Native American lands and offshore by fiscal year, state, county, offshore region and product (oil bbl, gas mcf, coal tons ...).",
145
+ "params": {
146
+ "state": {
147
+ "in": "spec",
148
+ "desc": "keep these states (full name as published, e.g. New Mexico; a list works)"
149
+ },
150
+ "from": {
151
+ "in": "spec",
152
+ "desc": "first year to keep (fiscal or calendar, as the file)"
153
+ },
154
+ "to": {
155
+ "in": "spec",
156
+ "desc": "last year to keep"
157
+ },
158
+ "product": {
159
+ "in": "spec",
160
+ "desc": "keep these products as published, e.g. Oil (bbl), Gas (mcf)"
161
+ }
162
+ },
163
+ "records": "$csv",
164
+ "paging": {
165
+ "type": "none"
166
+ },
167
+ "max_rows": 600000
168
+ },
169
+ "calendar_year_production": {
170
+ "path": "/downloads/calendar_year_production.csv",
171
+ "method": "GET",
172
+ "description": "The same production by calendar year.",
173
+ "params": {
174
+ "state": {
175
+ "in": "spec",
176
+ "desc": "keep these states (full name as published, e.g. New Mexico; a list works)"
177
+ },
178
+ "from": {
179
+ "in": "spec",
180
+ "desc": "first year to keep (fiscal or calendar, as the file)"
181
+ },
182
+ "to": {
183
+ "in": "spec",
184
+ "desc": "last year to keep"
185
+ },
186
+ "product": {
187
+ "in": "spec",
188
+ "desc": "keep these products as published, e.g. Oil (bbl), Gas (mcf)"
189
+ }
190
+ },
191
+ "records": "$csv",
192
+ "paging": {
193
+ "type": "none"
194
+ },
195
+ "max_rows": 600000
196
+ }
197
+ }
198
+ }
@@ -0,0 +1,91 @@
1
+ {
2
+ "id": "onrr",
3
+ "title": "ONRR natural resources revenue data: federal and Native American royalties, rents, bonuses, disbursements and production",
4
+ "agency": "U.S. Department of the Interior, Office of Natural Resources Revenue",
5
+ "depth": "standard",
6
+ "domains": [
7
+ "energy",
8
+ "federal revenue",
9
+ "public lands"
10
+ ],
11
+ "keywords": [
12
+ "onrr",
13
+ "office of natural resources revenue",
14
+ "natural resources revenue",
15
+ "federal royalties",
16
+ "oil and gas royalties",
17
+ "coal royalties",
18
+ "offshore leasing",
19
+ "lease bonus",
20
+ "rents",
21
+ "federal lands",
22
+ "public lands revenue",
23
+ "mineral leasing",
24
+ "disbursements to states",
25
+ "gomesa",
26
+ "reclamation fund",
27
+ "land and water conservation fund",
28
+ "production on federal lands",
29
+ "native american mineral revenue"
30
+ ],
31
+ "questions": [
32
+ "federal oil and gas royalties by state",
33
+ "revenue from federal lands in New Mexico or Wyoming",
34
+ "offshore revenue in the Gulf",
35
+ "how much mineral revenue went to a state",
36
+ "oil and gas production on federal lands by year",
37
+ "coal royalties over time"
38
+ ],
39
+ "homepage": "https://revenuedata.onrr.gov/",
40
+ "terms_url": "https://revenuedata.onrr.gov/downloads/",
41
+ "auth": {
42
+ "env": null,
43
+ "required": "none",
44
+ "placement": "none",
45
+ "signup_url": null,
46
+ "echoes_key": false
47
+ },
48
+ "limits": {
49
+ "rps": 1,
50
+ "burst": 2,
51
+ "max_rows": 2000000
52
+ },
53
+ "routes": {
54
+ "api": {
55
+ "base": "https://revenuedata.onrr.gov",
56
+ "probe": "https://revenuedata.onrr.gov/downloads/fiscal_year_disbursements.csv",
57
+ "hosts": [
58
+ "revenuedata.onrr.gov",
59
+ "revenuedata.doi.gov"
60
+ ]
61
+ },
62
+ "manual": {
63
+ "how": "Open https://revenuedata.onrr.gov/downloads/ (Revenue, Disbursements or Production, then 'Downloads and documentation'), download the CSV and upload it with ingest."
64
+ }
65
+ },
66
+ "cache": {
67
+ "mode": "run_only",
68
+ "ttl_hours": null,
69
+ "why": "Files are refreshed monthly; data/ is reused within a run."
70
+ },
71
+ "redistribution": {
72
+ "mode": "allowed",
73
+ "why": "ONRR data are U.S. government works in the public domain (17 U.S.C. 105)."
74
+ },
75
+ "notices": [],
76
+ "retention": null,
77
+ "citation": "U.S. Department of the Interior, Office of Natural Resources Revenue, {dataset}, revenuedata.onrr.gov, retrieved {retrieved_long}.",
78
+ "audit_hooks": [],
79
+ "clarify": [
80
+ "Revenue or disbursements? Revenue is what companies paid ONRR (by where the resource is); disbursements are what ONRR paid out to the Treasury, states, counties and funds. Default: revenue for 'how much came from', disbursements for 'how much a state got'.",
81
+ "Fiscal or calendar year? Federal fiscal years run October-September. Default: fiscal year, said as such."
82
+ ],
83
+ "formats": [
84
+ "csv"
85
+ ],
86
+ "aliases": [
87
+ "ONRR",
88
+ "Natural Resources Revenue Data",
89
+ "revenuedata.doi.gov"
90
+ ]
91
+ }
@@ -0,0 +1,55 @@
1
+ # ONRR natural resources revenue data: federal and Native American royalties, rents, bonuses, disbursements and production
2
+ Depth: standard. Key: none. The Office of Natural Resources Revenue's open data (Natural Resources Revenue Data,
3
+ revenuedata.onrr.gov), as its CSV downloads:
4
+ - revenue companies paid for extracting oil, gas, coal, minerals and renewable energy on federal onshore and
5
+ offshore lands and Native American lands (royalties, rents, bonuses, other revenues), by year or month;
6
+ - disbursements of that money to the U.S. Treasury, states and counties, and federal funds;
7
+ - production volumes on those lands.
8
+
9
+ ## When to use
10
+ - Federal royalties and other mineral revenue by state, county, offshore region, commodity or year; offshore
11
+ lease bonuses; how much a state received (disbursements); oil, gas and coal produced on federal lands.
12
+ - Not here: total U.S. or state production and prices on all lands (eia); federal receipts in the budget
13
+ (treasury MTS, omb); severance taxes states levy themselves (census government finances).
14
+
15
+ ## Endpoints
16
+ All take `state` (full name), `from`/`to` (years).
17
+
18
+ | Endpoint | Columns | More filters |
19
+ |---|---|---|
20
+ | `fiscal_year_revenue`, `calendar_year_revenue`, `monthly_revenue` (`Date` MM/DD/YYYY; 42 MB) | Fiscal Year (or Calendar Year, Date), Land Class, Land Category, State, County, FIPS Code, Offshore Region, Revenue Type, Mineral Lease Type, Commodity, Product, Revenue | `commodity`, `revenue_type`, `land_class` |
21
+ | `fiscal_year_disbursements` | Fiscal Year, Fund Type, Source, State, County, Disbursement | `fund_type` |
22
+ | `fiscal_year_production`, `calendar_year_production` | Fiscal Year (or Calendar Year), Land Class, Land Category, State, County, FIPS Code, Offshore Region, Product, Volume | `product` |
23
+
24
+ ## Spec examples
25
+ ```json
26
+ {"description": "Federal mineral revenue in New Mexico by type and commodity, FY2025",
27
+ "requests": [{"name": "nm_fy2025", "endpoint": "fiscal_year_revenue", "params": {"state": "New Mexico", "from": "2025", "to": "2025"}}]}
28
+ ```
29
+ ```json
30
+ {"description": "Disbursements to Wyoming, FY2020-2025",
31
+ "requests": [{"name": "wy_disb", "endpoint": "fiscal_year_disbursements", "params": {"state": "Wyoming", "from": "2020", "to": "2025"}}]}
32
+ ```
33
+
34
+ ## Data format and traps
35
+ - Revenue is in dollars, as text. Rows can be negative (adjustments and refunds: 3,486 negative rows in the
36
+ fiscal-year file of 2026-11-07). Sum them with the rest; never drop them.
37
+ - Revenue by state is where the resource is (onshore federal land). Offshore revenue has no state (`State`
38
+ empty, `Offshore Region` = Gulf of America, Pacific, Alaska, Atlantic). Native American revenue (`Land Class`
39
+ Native American) has no state or county in these files. A state total from the State column
40
+ is federal onshore revenue only: say so.
41
+ - Revenue and disbursements are different money flows and years: disbursements follow collection, and offshore
42
+ revenue reaches states under their own formulas. Never subtract one from the other.
43
+ - `Product` carries the unit in production files (Oil (bbl), Gas (mcf), Coal (tons) ...): never add volumes
44
+ across products.
45
+ - The current fiscal year is partial. Fiscal years run October-September. Revenue starts FY2004 (CY2003);
46
+ older years are in separate historical files (not covered).
47
+
48
+ ## Access
49
+ No key. `fetch` reads revenuedata.onrr.gov/downloads/<file>.csv (revenuedata.doi.gov redirects there; verified
50
+ 2026-11-07; up to 42 MB) and filters it. Manual: the Downloads page, then `ingest`. The site's documentation
51
+ pages under /downloads/ describe each field.
52
+
53
+ ## Citation and terms
54
+ "U.S. Department of the Interior, Office of Natural Resources Revenue, Natural Resources Revenue Data, <file>,
55
+ revenuedata.onrr.gov, retrieved <date>." Public domain (17 U.S.C. 105).