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,133 +1,133 @@
1
- {
2
- "id": "usda-fna",
3
- "title": "USDA Food and Nutrition Administration: SNAP, WIC and child nutrition program data, SNAP State Options Report and SNAP State Activity Reports",
4
- "agency": "U.S. Department of Agriculture, Food and Nutrition Administration (formerly Food and Nutrition Service)",
5
- "depth": "standard",
6
- "domains": [
7
- "nutrition assistance",
8
- "social safety net",
9
- "state policy",
10
- "program administration",
11
- "school meals"
12
- ],
13
- "keywords": [
14
- "snap",
15
- "food stamps",
16
- "supplemental nutrition assistance program",
17
- "fns",
18
- "fna",
19
- "food and nutrition service",
20
- "food and nutrition administration",
21
- "state options",
22
- "state options report",
23
- "snap waivers",
24
- "snap policy options",
25
- "bbce",
26
- "broad-based categorical eligibility",
27
- "abawd",
28
- "time limit waiver",
29
- "certification period",
30
- "simplified reporting",
31
- "standard utility allowance",
32
- "employment and training",
33
- "drug felony",
34
- "state activity report",
35
- "snap participation by state",
36
- "snap issuance",
37
- "snap benefits by state",
38
- "emergency allotments",
39
- "snap administrative costs",
40
- "fair hearings",
41
- "snap fraud",
42
- "trafficking",
43
- "recipient claims",
44
- "disqualifications",
45
- "wic",
46
- "women infants and children",
47
- "wic participation",
48
- "wic food costs",
49
- "breastfeeding",
50
- "school lunch",
51
- "nslp",
52
- "national school lunch program",
53
- "school breakfast",
54
- "sbp",
55
- "free and reduced price meals",
56
- "school meals",
57
- "child nutrition",
58
- "special milk program",
59
- "cacfp",
60
- "child and adult care food program",
61
- "summer meals",
62
- "summer food service program",
63
- "sfsp",
64
- "snap participation by month",
65
- "snap households",
66
- "program data"
67
- ],
68
- "questions": [
69
- "which states use broad-based categorical eligibility for SNAP",
70
- "which states have an ABAWD time limit waiver",
71
- "the SNAP policy options a state has chosen, compared with another state",
72
- "SNAP administrative costs by state and the federal share",
73
- "SNAP participation, issuance and average benefit by state for a fiscal year",
74
- "SNAP fraud investigations, disqualifications and recipient claims by state",
75
- "SNAP persons, households and benefits by state for the latest month or each month since FY 2020",
76
- "WIC participation by state, tribal organization or category (women, infants, children) and WIC food costs",
77
- "school lunch and breakfast participation, meals served and cash payments by state",
78
- "national trends in SNAP, WIC, school meals, summer meals and CACFP since 1969"
79
- ],
80
- "homepage": "https://www.fna.usda.gov/pd/overview",
81
- "terms_url": "https://www.usda.gov/policies-and-links",
82
- "auth": {
83
- "env": null,
84
- "required": "none",
85
- "placement": "none",
86
- "signup_url": null,
87
- "echoes_key": false
88
- },
89
- "limits": {
90
- "rps": 1,
91
- "burst": 2,
92
- "max_rows": 100000
93
- },
94
- "routes": {
95
- "api": {
96
- "base": "https://www.fna.usda.gov",
97
- "probe": "https://www.fna.usda.gov/snap/waivers/state-options-report",
98
- "hosts": [
99
- "www.fna.usda.gov",
100
- "fna-bwbufwdzbabpezgc.z01.azurefd.us",
101
- "publicdashboards.dl.usda.gov"
102
- ]
103
- },
104
- "manual": {
105
- "how": "Open each link in manual_download/INSTRUCTIONS.md in a browser and save the file under the name shown (the PDFs, Excel files and the SNAP zip download; a dashboard .csv link downloads a small CSV), then upload them. Without the links: Program Data Excel tables at https://www.fna.usda.gov/pd/supplemental-nutrition-assistance-program-snap, https://www.fna.usda.gov/pd/wic-program and https://www.fna.usda.gov/pd/child-nutrition-tables; the State Options Report PDFs at https://www.fna.usda.gov/snap/waivers/state-options-report, the SNAP State Activity Reports (PDF, FY 2004-2023) at https://www.fna.usda.gov/pd/snap-state-activity-reports; the dashboard at https://www.fna.usda.gov/data-research/data-visualization/snap/state-options has no download button, so upload the PDF instead."
106
- }
107
- },
108
- "cache": {
109
- "mode": "run_only",
110
- "ttl_hours": null,
111
- "why": "The reports change once a year and the Program Data tables monthly; data/ is reused only within a run."
112
- },
113
- "redistribution": {
114
- "mode": "allowed",
115
- "why": "Works of the U.S. Department of Agriculture, a federal agency: public domain (17 U.S.C. 105)."
116
- },
117
- "notices": [],
118
- "retention": null,
119
- "citation": "U.S. Department of Agriculture, Food and Nutrition Administration, {dataset}, fna.usda.gov, retrieved {retrieved_long}.",
120
- "audit_hooks": [],
121
- "clarify": [
122
- "Which State Options Report edition (as-of date)? Options change every year. Default: the latest, the 17th edition (Aug 2025, options in place Oct 1, 2024, FFY 2025).",
123
- "SNAP issuance with or without emergency allotments (FY 2020-2023)? Default: report both, named separately (the State Activity Reports' total issuance includes them).",
124
- "All 53 SNAP state agencies (50 states, DC, Guam, Virgin Islands) or the 50 states only? Default: all 53, the reports' own count.",
125
- "Latest months are preliminary (initial for the newest) and revised later: report the status column with them. Default: use them, labeled.",
126
- "Program year or federal fiscal year? FNA tables are federal fiscal years (October-September); school year SY 2024-25 is not FY 2025. Default: fiscal years, said so."
127
- ],
128
- "formats": [
129
- "csv",
130
- "pdf",
131
- "xlsx"
132
- ]
133
- }
1
+ {
2
+ "id": "usda-fna",
3
+ "title": "USDA Food and Nutrition Administration: SNAP, WIC and child nutrition program data, SNAP State Options Report and SNAP State Activity Reports",
4
+ "agency": "U.S. Department of Agriculture, Food and Nutrition Administration (formerly Food and Nutrition Service)",
5
+ "depth": "standard",
6
+ "domains": [
7
+ "nutrition assistance",
8
+ "social safety net",
9
+ "state policy",
10
+ "program administration",
11
+ "school meals"
12
+ ],
13
+ "keywords": [
14
+ "snap",
15
+ "food stamps",
16
+ "supplemental nutrition assistance program",
17
+ "fns",
18
+ "fna",
19
+ "food and nutrition service",
20
+ "food and nutrition administration",
21
+ "state options",
22
+ "state options report",
23
+ "snap waivers",
24
+ "snap policy options",
25
+ "bbce",
26
+ "broad-based categorical eligibility",
27
+ "abawd",
28
+ "time limit waiver",
29
+ "certification period",
30
+ "simplified reporting",
31
+ "standard utility allowance",
32
+ "employment and training",
33
+ "drug felony",
34
+ "state activity report",
35
+ "snap participation by state",
36
+ "snap issuance",
37
+ "snap benefits by state",
38
+ "emergency allotments",
39
+ "snap administrative costs",
40
+ "fair hearings",
41
+ "snap fraud",
42
+ "trafficking",
43
+ "recipient claims",
44
+ "disqualifications",
45
+ "wic",
46
+ "women infants and children",
47
+ "wic participation",
48
+ "wic food costs",
49
+ "breastfeeding",
50
+ "school lunch",
51
+ "nslp",
52
+ "national school lunch program",
53
+ "school breakfast",
54
+ "sbp",
55
+ "free and reduced price meals",
56
+ "school meals",
57
+ "child nutrition",
58
+ "special milk program",
59
+ "cacfp",
60
+ "child and adult care food program",
61
+ "summer meals",
62
+ "summer food service program",
63
+ "sfsp",
64
+ "snap participation by month",
65
+ "snap households",
66
+ "program data"
67
+ ],
68
+ "questions": [
69
+ "which states use broad-based categorical eligibility for SNAP",
70
+ "which states have an ABAWD time limit waiver",
71
+ "the SNAP policy options a state has chosen, compared with another state",
72
+ "SNAP administrative costs by state and the federal share",
73
+ "SNAP participation, issuance and average benefit by state for a fiscal year",
74
+ "SNAP fraud investigations, disqualifications and recipient claims by state",
75
+ "SNAP persons, households and benefits by state for the latest month or each month since FY 2020",
76
+ "WIC participation by state, tribal organization or category (women, infants, children) and WIC food costs",
77
+ "school lunch and breakfast participation, meals served and cash payments by state",
78
+ "national trends in SNAP, WIC, school meals, summer meals and CACFP since 1969"
79
+ ],
80
+ "homepage": "https://www.fna.usda.gov/pd/overview",
81
+ "terms_url": "https://www.usda.gov/policies-and-links",
82
+ "auth": {
83
+ "env": null,
84
+ "required": "none",
85
+ "placement": "none",
86
+ "signup_url": null,
87
+ "echoes_key": false
88
+ },
89
+ "limits": {
90
+ "rps": 1,
91
+ "burst": 2,
92
+ "max_rows": 100000
93
+ },
94
+ "routes": {
95
+ "api": {
96
+ "base": "https://www.fna.usda.gov",
97
+ "probe": "https://www.fna.usda.gov/snap/waivers/state-options-report",
98
+ "hosts": [
99
+ "www.fna.usda.gov",
100
+ "fna-bwbufwdzbabpezgc.z01.azurefd.us",
101
+ "publicdashboards.dl.usda.gov"
102
+ ]
103
+ },
104
+ "manual": {
105
+ "how": "Open each link in manual_download/INSTRUCTIONS.md in a browser and save the file under the name shown (the PDFs, Excel files and the SNAP zip download; a dashboard .csv link downloads a small CSV), then upload them. Without the links: Program Data Excel tables at https://www.fna.usda.gov/pd/supplemental-nutrition-assistance-program-snap, https://www.fna.usda.gov/pd/wic-program and https://www.fna.usda.gov/pd/child-nutrition-tables; the State Options Report PDFs at https://www.fna.usda.gov/snap/waivers/state-options-report, the SNAP State Activity Reports (PDF, FY 2004-2023) at https://www.fna.usda.gov/pd/snap-state-activity-reports; the dashboard at https://www.fna.usda.gov/data-research/data-visualization/snap/state-options has no download button, so upload the PDF instead."
106
+ }
107
+ },
108
+ "cache": {
109
+ "mode": "run_only",
110
+ "ttl_hours": null,
111
+ "why": "The reports change once a year and the Program Data tables monthly; data/ is reused only within a run."
112
+ },
113
+ "redistribution": {
114
+ "mode": "allowed",
115
+ "why": "Works of the U.S. Department of Agriculture, a federal agency: public domain (17 U.S.C. 105)."
116
+ },
117
+ "notices": [],
118
+ "retention": null,
119
+ "citation": "U.S. Department of Agriculture, Food and Nutrition Administration, {dataset}, fna.usda.gov, retrieved {retrieved_long}.",
120
+ "audit_hooks": [],
121
+ "clarify": [
122
+ "Which State Options Report edition (as-of date)? Options change every year. Default: the latest, the 17th edition (Aug 2025, options in place Oct 1, 2024, FFY 2025).",
123
+ "SNAP issuance with or without emergency allotments (FY 2020-2023)? Default: report both, named separately (the State Activity Reports' total issuance includes them).",
124
+ "All 53 SNAP state agencies (50 states, DC, Guam, Virgin Islands) or the 50 states only? Default: all 53, the reports' own count.",
125
+ "Latest months are preliminary (initial for the newest) and revised later: report the status column with them. Default: use them, labeled.",
126
+ "Program year or federal fiscal year? FNA tables are federal fiscal years (October-September); school year SY 2024-25 is not FY 2025. Default: fiscal years, said so."
127
+ ],
128
+ "formats": [
129
+ "csv",
130
+ "pdf",
131
+ "xlsx"
132
+ ]
133
+ }
@@ -1,181 +1,181 @@
1
- {
2
- "base_url": "https://api.nal.usda.gov/fdc/v1",
3
- "retry_html_400": 3,
4
- "endpoints": {
5
- "search": {
6
- "path": "/foods/search",
7
- "method": "GET",
8
- "description": "Foods matching a query (200 a page), with their nutrients.",
9
- "params": {
10
- "query": {
11
- "required": true,
12
- "desc": "search words, e.g. cheddar cheese; supports +word, -word, \"phrases\" and field queries such as foodCategory:\"Cheese\" or +foodCategory:\"Cheese\" +ingredients:\"annatto\" (quote a value of several words; spell category names exactly as FDC does)"
13
- },
14
- "dataType": {
15
- "desc": "Foundation, SR Legacy, Survey (FNDDS), Branded, Experimental (list or comma text)"
16
- },
17
- "brandOwner": {
18
- "desc": "Branded foods only: brand owner name"
19
- },
20
- "sortBy": {
21
- "desc": "dataType.keyword, lowercaseDescription.keyword, fdcId, publishedDate"
22
- },
23
- "sortOrder": {
24
- "desc": "asc or desc"
25
- }
26
- },
27
- "records": "foods",
28
- "total": "totalHits",
29
- "paging": {
30
- "type": "page",
31
- "page_param": "pageNumber",
32
- "size_param": "pageSize",
33
- "size": 200,
34
- "start": 1
35
- },
36
- "max_rows": 10000,
37
- "missing": [
38
- ""
39
- ],
40
- "flatten": true
41
- },
42
- "food": {
43
- "path": "/food/{fdcId}",
44
- "method": "GET",
45
- "description": "One food by FDC id, with every nutrient (format full) or the main ones (abridged).",
46
- "params": {
47
- "fdcId": {
48
- "in": "path",
49
- "required": true,
50
- "desc": "FoodData Central id, e.g. 328637"
51
- },
52
- "format": {
53
- "desc": "full (default) or abridged",
54
- "enum": [
55
- "full",
56
- "abridged"
57
- ]
58
- },
59
- "nutrients": {
60
- "desc": "nutrient NUMBERS to keep, e.g. 203,204,208 (protein, fat, energy)"
61
- }
62
- },
63
- "records": "",
64
- "paging": {
65
- "type": "none"
66
- },
67
- "max_rows": 1,
68
- "missing": [
69
- ""
70
- ],
71
- "flatten": true
72
- },
73
- "foods": {
74
- "path": "/foods",
75
- "method": "GET",
76
- "description": "Up to 20 foods by FDC id in one call (the documented maximum; the API silently drops ids past 50).",
77
- "params": {
78
- "fdcIds": {
79
- "required": true,
80
- "desc": "comma-separated FDC ids, or a list; the pack refuses more than 20 (the API silently drops extra ids)"
81
- },
82
- "format": {
83
- "desc": "abridged (default here) or full",
84
- "enum": [
85
- "full",
86
- "abridged"
87
- ]
88
- },
89
- "nutrients": {
90
- "desc": "nutrient numbers to keep, e.g. 203,204,208"
91
- }
92
- },
93
- "defaults": {
94
- "format": "abridged"
95
- },
96
- "records": "",
97
- "paging": {
98
- "type": "none"
99
- },
100
- "max_rows": 20,
101
- "missing": [
102
- ""
103
- ],
104
- "flatten": true
105
- },
106
- "list": {
107
- "path": "/foods/list",
108
- "method": "GET",
109
- "description": "Every food of a data type, paged (abridged nutrients).",
110
- "params": {
111
- "dataType": {
112
- "desc": "Foundation, SR Legacy, Survey (FNDDS), Branded"
113
- },
114
- "sortBy": {
115
- "desc": "dataType.keyword, lowercaseDescription.keyword, fdcId, publishedDate"
116
- },
117
- "sortOrder": {
118
- "desc": "asc or desc"
119
- }
120
- },
121
- "records": "",
122
- "paging": {
123
- "type": "page",
124
- "page_param": "pageNumber",
125
- "size_param": "pageSize",
126
- "size": 200,
127
- "start": 1
128
- },
129
- "max_rows": 20000,
130
- "missing": [
131
- ""
132
- ],
133
- "flatten": true
134
- }
135
- },
136
- "catalog": {
137
- "foundation": {
138
- "id": "Foundation",
139
- "name": "Foundation Foods",
140
- "description": "Minimally processed foods with analytical nutrient values and metadata (dataType Foundation)",
141
- "endpoint": "search"
142
- },
143
- "sr_legacy": {
144
- "id": "SR Legacy",
145
- "name": "SR Legacy",
146
- "description": "USDA National Nutrient Database for Standard Reference, final 2018 release (dataType SR Legacy)",
147
- "endpoint": "search"
148
- },
149
- "survey_fndds": {
150
- "id": "Survey (FNDDS)",
151
- "name": "Food and Nutrient Database for Dietary Studies",
152
- "description": "Foods as eaten in What We Eat in America / NHANES (dataType Survey (FNDDS))",
153
- "endpoint": "search"
154
- },
155
- "branded": {
156
- "id": "Branded",
157
- "name": "Global Branded Food Products Database",
158
- "description": "Label data for branded products from manufacturers (dataType Branded; the largest set)",
159
- "endpoint": "search"
160
- }
161
- },
162
- "nutrient_numbers": {
163
- "208": "Energy (kcal)",
164
- "203": "Protein (g)",
165
- "204": "Total lipid (fat) (g)",
166
- "205": "Carbohydrate, by difference (g)",
167
- "269": "Total sugars (g)",
168
- "291": "Fiber, total dietary (g)",
169
- "307": "Sodium, Na (mg)",
170
- "301": "Calcium, Ca (mg)",
171
- "303": "Iron, Fe (mg)",
172
- "306": "Potassium, K (mg)",
173
- "601": "Cholesterol (mg)",
174
- "606": "Fatty acids, total saturated (g)",
175
- "605": "Fatty acids, total trans (g)",
176
- "401": "Vitamin C (mg)",
177
- "320": "Vitamin A, RAE (ug)",
178
- "328": "Vitamin D (D2 + D3) (ug)",
179
- "255": "Water (g)"
180
- }
1
+ {
2
+ "base_url": "https://api.nal.usda.gov/fdc/v1",
3
+ "retry_html_400": 3,
4
+ "endpoints": {
5
+ "search": {
6
+ "path": "/foods/search",
7
+ "method": "GET",
8
+ "description": "Foods matching a query (200 a page), with their nutrients.",
9
+ "params": {
10
+ "query": {
11
+ "required": true,
12
+ "desc": "search words, e.g. cheddar cheese; supports +word, -word, \"phrases\" and field queries such as foodCategory:\"Cheese\" or +foodCategory:\"Cheese\" +ingredients:\"annatto\" (quote a value of several words; spell category names exactly as FDC does)"
13
+ },
14
+ "dataType": {
15
+ "desc": "Foundation, SR Legacy, Survey (FNDDS), Branded, Experimental (list or comma text)"
16
+ },
17
+ "brandOwner": {
18
+ "desc": "Branded foods only: brand owner name"
19
+ },
20
+ "sortBy": {
21
+ "desc": "dataType.keyword, lowercaseDescription.keyword, fdcId, publishedDate"
22
+ },
23
+ "sortOrder": {
24
+ "desc": "asc or desc"
25
+ }
26
+ },
27
+ "records": "foods",
28
+ "total": "totalHits",
29
+ "paging": {
30
+ "type": "page",
31
+ "page_param": "pageNumber",
32
+ "size_param": "pageSize",
33
+ "size": 200,
34
+ "start": 1
35
+ },
36
+ "max_rows": 10000,
37
+ "missing": [
38
+ ""
39
+ ],
40
+ "flatten": true
41
+ },
42
+ "food": {
43
+ "path": "/food/{fdcId}",
44
+ "method": "GET",
45
+ "description": "One food by FDC id, with every nutrient (format full) or the main ones (abridged).",
46
+ "params": {
47
+ "fdcId": {
48
+ "in": "path",
49
+ "required": true,
50
+ "desc": "FoodData Central id, e.g. 328637"
51
+ },
52
+ "format": {
53
+ "desc": "full (default) or abridged",
54
+ "enum": [
55
+ "full",
56
+ "abridged"
57
+ ]
58
+ },
59
+ "nutrients": {
60
+ "desc": "nutrient NUMBERS to keep, e.g. 203,204,208 (protein, fat, energy)"
61
+ }
62
+ },
63
+ "records": "",
64
+ "paging": {
65
+ "type": "none"
66
+ },
67
+ "max_rows": 1,
68
+ "missing": [
69
+ ""
70
+ ],
71
+ "flatten": true
72
+ },
73
+ "foods": {
74
+ "path": "/foods",
75
+ "method": "GET",
76
+ "description": "Up to 20 foods by FDC id in one call (the documented maximum; the API silently drops ids past 50).",
77
+ "params": {
78
+ "fdcIds": {
79
+ "required": true,
80
+ "desc": "comma-separated FDC ids, or a list; the pack refuses more than 20 (the API silently drops extra ids)"
81
+ },
82
+ "format": {
83
+ "desc": "abridged (default here) or full",
84
+ "enum": [
85
+ "full",
86
+ "abridged"
87
+ ]
88
+ },
89
+ "nutrients": {
90
+ "desc": "nutrient numbers to keep, e.g. 203,204,208"
91
+ }
92
+ },
93
+ "defaults": {
94
+ "format": "abridged"
95
+ },
96
+ "records": "",
97
+ "paging": {
98
+ "type": "none"
99
+ },
100
+ "max_rows": 20,
101
+ "missing": [
102
+ ""
103
+ ],
104
+ "flatten": true
105
+ },
106
+ "list": {
107
+ "path": "/foods/list",
108
+ "method": "GET",
109
+ "description": "Every food of a data type, paged (abridged nutrients).",
110
+ "params": {
111
+ "dataType": {
112
+ "desc": "Foundation, SR Legacy, Survey (FNDDS), Branded"
113
+ },
114
+ "sortBy": {
115
+ "desc": "dataType.keyword, lowercaseDescription.keyword, fdcId, publishedDate"
116
+ },
117
+ "sortOrder": {
118
+ "desc": "asc or desc"
119
+ }
120
+ },
121
+ "records": "",
122
+ "paging": {
123
+ "type": "page",
124
+ "page_param": "pageNumber",
125
+ "size_param": "pageSize",
126
+ "size": 200,
127
+ "start": 1
128
+ },
129
+ "max_rows": 20000,
130
+ "missing": [
131
+ ""
132
+ ],
133
+ "flatten": true
134
+ }
135
+ },
136
+ "catalog": {
137
+ "foundation": {
138
+ "id": "Foundation",
139
+ "name": "Foundation Foods",
140
+ "description": "Minimally processed foods with analytical nutrient values and metadata (dataType Foundation)",
141
+ "endpoint": "search"
142
+ },
143
+ "sr_legacy": {
144
+ "id": "SR Legacy",
145
+ "name": "SR Legacy",
146
+ "description": "USDA National Nutrient Database for Standard Reference, final 2018 release (dataType SR Legacy)",
147
+ "endpoint": "search"
148
+ },
149
+ "survey_fndds": {
150
+ "id": "Survey (FNDDS)",
151
+ "name": "Food and Nutrient Database for Dietary Studies",
152
+ "description": "Foods as eaten in What We Eat in America / NHANES (dataType Survey (FNDDS))",
153
+ "endpoint": "search"
154
+ },
155
+ "branded": {
156
+ "id": "Branded",
157
+ "name": "Global Branded Food Products Database",
158
+ "description": "Label data for branded products from manufacturers (dataType Branded; the largest set)",
159
+ "endpoint": "search"
160
+ }
161
+ },
162
+ "nutrient_numbers": {
163
+ "208": "Energy (kcal)",
164
+ "203": "Protein (g)",
165
+ "204": "Total lipid (fat) (g)",
166
+ "205": "Carbohydrate, by difference (g)",
167
+ "269": "Total sugars (g)",
168
+ "291": "Fiber, total dietary (g)",
169
+ "307": "Sodium, Na (mg)",
170
+ "301": "Calcium, Ca (mg)",
171
+ "303": "Iron, Fe (mg)",
172
+ "306": "Potassium, K (mg)",
173
+ "601": "Cholesterol (mg)",
174
+ "606": "Fatty acids, total saturated (g)",
175
+ "605": "Fatty acids, total trans (g)",
176
+ "401": "Vitamin C (mg)",
177
+ "320": "Vitamin A, RAE (ug)",
178
+ "328": "Vitamin D (D2 + D3) (ug)",
179
+ "255": "Water (g)"
180
+ }
181
181
  }