data-analyst-mcp 0.3.0 → 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.
Files changed (153) hide show
  1. package/README.md +262 -262
  2. package/dist/report/method_audit.js +7 -1
  3. package/dist/report/method_audit.js.map +1 -1
  4. package/dist/report/scan_secrets.d.ts +4 -1
  5. package/dist/report/scan_secrets.js +36 -5
  6. package/dist/report/scan_secrets.js.map +1 -1
  7. package/dist/server.d.ts +1 -1
  8. package/dist/server.js +3 -2
  9. package/dist/server.js.map +1 -1
  10. package/guide/WORKFLOW.md +134 -134
  11. package/guide/assets/disclaimer.txt +1 -1
  12. package/guide/assets/download_data.ps1 +162 -162
  13. package/guide/assets/report_template.html +597 -597
  14. package/guide/references/routing.md +171 -171
  15. package/guide/references/style_guide.md +398 -398
  16. package/package.json +56 -56
  17. package/packs/acf/endpoints.json +114 -114
  18. package/packs/acf/policy.json +104 -104
  19. package/packs/actuaries/endpoints.json +82 -82
  20. package/packs/actuaries/policy.json +109 -109
  21. package/packs/bea/assets/download_bea.ps1 +182 -182
  22. package/packs/bea/docs/bea_api.md +461 -461
  23. package/packs/bea/docs/datasets.md +157 -157
  24. package/packs/bea/docs/report_patterns.md +112 -112
  25. package/packs/bea/policy.json +170 -170
  26. package/packs/bea/source.md +152 -152
  27. package/packs/bls/assets/download_bls.ps1 +152 -152
  28. package/packs/bls/docs/analysis_patterns.md +108 -108
  29. package/packs/bls/docs/bls_api.md +73 -73
  30. package/packs/bls/docs/series_ids.md +149 -149
  31. package/packs/bls/policy.json +238 -238
  32. package/packs/bts/endpoints.json +346 -346
  33. package/packs/bts/policy.json +94 -94
  34. package/packs/cdc/endpoints.json +197 -197
  35. package/packs/cdc/policy.json +83 -83
  36. package/packs/census/endpoints.json +99 -99
  37. package/packs/cfpb/endpoints.json +326 -326
  38. package/packs/cfpb/policy.json +119 -119
  39. package/packs/clinical-trials/endpoints.json +166 -166
  40. package/packs/clinical-trials/policy.json +84 -84
  41. package/packs/cms/endpoints.json +69 -69
  42. package/packs/cms/policy.json +96 -96
  43. package/packs/college-scorecard/endpoints.json +252 -252
  44. package/packs/college-scorecard/policy.json +106 -106
  45. package/packs/congress/endpoints.json +1701 -1701
  46. package/packs/congress/policy.json +117 -117
  47. package/packs/dhs-ohss/endpoints.json +66 -66
  48. package/packs/dhs-ohss/policy.json +107 -107
  49. package/packs/doj-news/endpoints.json +59 -59
  50. package/packs/doj-news/policy.json +96 -96
  51. package/packs/dol/endpoints.json +817 -817
  52. package/packs/dol/policy.json +135 -135
  53. package/packs/eia/endpoints.json +717 -717
  54. package/packs/eia/policy.json +112 -112
  55. package/packs/epa/endpoints.json +291 -291
  56. package/packs/epa/policy.json +99 -99
  57. package/packs/epa-aqs/endpoints.json +173 -173
  58. package/packs/epa-aqs/policy.json +96 -96
  59. package/packs/fbi/endpoints.json +1841 -1841
  60. package/packs/fbi/policy.json +118 -118
  61. package/packs/fda/endpoints.json +237 -237
  62. package/packs/fda/policy.json +121 -121
  63. package/packs/fdic/endpoints.json +416 -416
  64. package/packs/fdic/policy.json +83 -83
  65. package/packs/fec/endpoints.json +707 -707
  66. package/packs/fec/policy.json +93 -93
  67. package/packs/fed-board/endpoints.json +89 -89
  68. package/packs/fed-board/policy.json +136 -136
  69. package/packs/federal-register/endpoints.json +143 -143
  70. package/packs/federal-register/policy.json +86 -86
  71. package/packs/fema/endpoints.json +645 -645
  72. package/packs/fema/policy.json +103 -103
  73. package/packs/fhfa/endpoints.json +105 -105
  74. package/packs/fhfa/policy.json +109 -109
  75. package/packs/fred/assets/download_fred.ps1 +122 -122
  76. package/packs/fred/docs/analysis_patterns.md +124 -124
  77. package/packs/fred/docs/fred_api.md +94 -94
  78. package/packs/fred/docs/series.md +188 -188
  79. package/packs/fred/policy.json +253 -253
  80. package/packs/fsa/endpoints.json +150 -150
  81. package/packs/fsa/policy.json +99 -99
  82. package/packs/govinfo/endpoints.json +519 -519
  83. package/packs/gsa-calc/endpoints.json +93 -93
  84. package/packs/gsa-calc/policy.json +97 -97
  85. package/packs/hud/endpoints.json +146 -146
  86. package/packs/hud/policy.json +84 -84
  87. package/packs/ipums/docs/report_patterns.md +117 -117
  88. package/packs/irs-soi/endpoints.json +114 -114
  89. package/packs/irs-soi/policy.json +107 -107
  90. package/packs/medicaid/endpoints.json +412 -412
  91. package/packs/medicaid/policy.json +108 -108
  92. package/packs/naep/endpoints.json +217 -217
  93. package/packs/naep/policy.json +100 -100
  94. package/packs/nhtsa/endpoints.json +132 -132
  95. package/packs/nhtsa/policy.json +93 -93
  96. package/packs/nih/endpoints.json +452 -452
  97. package/packs/nih/policy.json +86 -86
  98. package/packs/noaa/endpoints.json +431 -431
  99. package/packs/noaa/policy.json +95 -95
  100. package/packs/nrel/endpoints.json +327 -327
  101. package/packs/nrel/policy.json +96 -96
  102. package/packs/nws/endpoints.json +271 -271
  103. package/packs/nws/policy.json +82 -82
  104. package/packs/nyfed/endpoints.json +80 -80
  105. package/packs/nyfed/policy.json +92 -92
  106. package/packs/omb/endpoints.json +460 -460
  107. package/packs/omb/policy.json +106 -106
  108. package/packs/open-payments/endpoints.json +297 -297
  109. package/packs/open-payments/policy.json +101 -101
  110. package/packs/opm/assets/download_opm.ps1 +125 -125
  111. package/packs/opm/docs/fields.md +184 -184
  112. package/packs/opm/docs/opm_api.md +71 -71
  113. package/packs/opm/docs/report_patterns.md +83 -83
  114. package/packs/opm/lib/data_dictionary.csv +73 -73
  115. package/packs/pbgc/endpoints.json +483 -483
  116. package/packs/pbgc/policy.json +94 -94
  117. package/packs/philfed/endpoints.json +85 -85
  118. package/packs/philfed/policy.json +94 -94
  119. package/packs/regulations/endpoints.json +287 -287
  120. package/packs/regulations/policy.json +86 -86
  121. package/packs/sec/endpoints.json +236 -236
  122. package/packs/sec/policy.json +86 -86
  123. package/packs/senate-lobbying/endpoints.json +553 -553
  124. package/packs/senate-lobbying/policy.json +99 -99
  125. package/packs/snapqc/endpoints.json +1426 -1426
  126. package/packs/snapqc/policy.json +92 -92
  127. package/packs/treasury/catalog.json +2267 -2267
  128. package/packs/treasury/docs/api_guide.md +245 -245
  129. package/packs/treasury/docs/datasets.md +56 -56
  130. package/packs/treasury/docs/report_patterns.md +126 -126
  131. package/packs/treasury/policy.json +159 -159
  132. package/packs/treasury/source.md +170 -165
  133. package/packs/treasury-yields/endpoints.json +226 -226
  134. package/packs/treasury-yields/policy.json +86 -86
  135. package/packs/usaspending/endpoints.json +1315 -1315
  136. package/packs/usaspending/policy.json +109 -109
  137. package/packs/usda-fna/policy.json +133 -133
  138. package/packs/usda-fooddata/endpoints.json +180 -180
  139. package/packs/usda-fooddata/policy.json +94 -94
  140. package/packs/usda-nass/endpoints.json +323 -323
  141. package/packs/usda-nass/policy.json +95 -95
  142. package/packs/usda-outlook/endpoints.json +86 -86
  143. package/packs/usda-outlook/policy.json +109 -109
  144. package/packs/usgs/endpoints.json +313 -313
  145. package/packs/usgs/policy.json +95 -95
  146. package/packs/usitc/endpoints.json +74 -74
  147. package/packs/usitc/policy.json +111 -111
  148. package/packs/uspto/endpoints.json +141 -141
  149. package/packs/uspto/policy.json +95 -95
  150. package/packs/va/endpoints.json +414 -414
  151. package/packs/va/policy.json +101 -101
  152. package/packs/world-bank/endpoints.json +122 -122
  153. package/packs/world-bank/policy.json +101 -101
@@ -1,94 +1,94 @@
1
- {
2
- "id": "pbgc",
3
- "title": "PBGC Pension Insurance Data Tables (single-employer and multiemployer programs)",
4
- "agency": "Pension Benefit Guaranty Corporation",
5
- "depth": "standard",
6
- "domains": [
7
- "pensions",
8
- "retirement",
9
- "social insurance"
10
- ],
11
- "keywords": [
12
- "pbgc",
13
- "pension benefit guaranty corporation",
14
- "pension insurance",
15
- "defined benefit",
16
- "single-employer",
17
- "multiemployer",
18
- "pension plan",
19
- "insured participants",
20
- "plan terminations",
21
- "trusteed plans",
22
- "claims",
23
- "premiums",
24
- "flat-rate premium",
25
- "variable-rate premium",
26
- "maximum guaranteed benefit",
27
- "net financial position",
28
- "underfunding",
29
- "funding ratio",
30
- "special financial assistance",
31
- "sfa",
32
- "financial assistance",
33
- "benefit payments",
34
- "payees",
35
- "pension risk transfer",
36
- "data book"
37
- ],
38
- "questions": [
39
- "PBGC single-employer program net position over time",
40
- "number of participants in PBGC-insured multiemployer plans",
41
- "PBGC premium rates history (flat-rate and variable-rate)",
42
- "special financial assistance paid to multiemployer plans",
43
- "PBGC maximum guaranteed benefit by year",
44
- "underfunding of PBGC-insured single-employer plans"
45
- ],
46
- "homepage": "https://www.pbgc.gov/about/reports/pension-insurance-data",
47
- "terms_url": "https://www.pbgc.gov/about/policies/website",
48
- "auth": {
49
- "env": null,
50
- "required": "none",
51
- "placement": "none",
52
- "signup_url": null,
53
- "echoes_key": false
54
- },
55
- "limits": {
56
- "rps": 1,
57
- "burst": 2,
58
- "max_rows": 50000
59
- },
60
- "routes": {
61
- "api": {
62
- "base": "https://www.pbgc.gov",
63
- "probe": "https://www.pbgc.gov/about/reports/pension-insurance-data",
64
- "hosts": [
65
- "www.pbgc.gov"
66
- ]
67
- },
68
- "manual": {
69
- "how": "Open https://www.pbgc.gov/about/reports/pension-insurance-data in a browser, click the Excel link in the row of the edition you need (e.g. \"2024 Pension Insurance Data Tables (1st Installment)\"), save the workbook under the name shown in INSTRUCTIONS.md, and upload it. The PDF next to it has the same tables with their titles."
70
- }
71
- },
72
- "cache": {
73
- "mode": "run_only",
74
- "ttl_hours": null,
75
- "why": "An edition changes only when PBGC posts a revision or the next installment; workbooks are 1-3 MB."
76
- },
77
- "redistribution": {
78
- "mode": "allowed",
79
- "why": "PBGC is a federal agency; its data tables are U.S. government works (17 U.S.C. 105), in the public domain."
80
- },
81
- "notices": [],
82
- "retention": null,
83
- "citation": "Pension Benefit Guaranty Corporation, Pension Insurance Data Tables ({dataset}), www.pbgc.gov, retrieved {retrieved_long}.",
84
- "audit_hooks": [],
85
- "clarify": [
86
- "Single-employer program (S- tables), multiemployer program (M- tables), or both? They are separate insurance programs with separate finances, premiums and guarantees; never add them unless the table does (GLANCE has combined totals).",
87
- "Which edition? The newest (2024, a 1st installment) lacks the Form 5500-based tables (participant status, funding, industry, state); those come from the 2023 edition. Default: the newest edition that has the table."
88
- ],
89
- "formats": [
90
- "xlsx",
91
- "xls",
92
- "html"
93
- ]
94
- }
1
+ {
2
+ "id": "pbgc",
3
+ "title": "PBGC Pension Insurance Data Tables (single-employer and multiemployer programs)",
4
+ "agency": "Pension Benefit Guaranty Corporation",
5
+ "depth": "standard",
6
+ "domains": [
7
+ "pensions",
8
+ "retirement",
9
+ "social insurance"
10
+ ],
11
+ "keywords": [
12
+ "pbgc",
13
+ "pension benefit guaranty corporation",
14
+ "pension insurance",
15
+ "defined benefit",
16
+ "single-employer",
17
+ "multiemployer",
18
+ "pension plan",
19
+ "insured participants",
20
+ "plan terminations",
21
+ "trusteed plans",
22
+ "claims",
23
+ "premiums",
24
+ "flat-rate premium",
25
+ "variable-rate premium",
26
+ "maximum guaranteed benefit",
27
+ "net financial position",
28
+ "underfunding",
29
+ "funding ratio",
30
+ "special financial assistance",
31
+ "sfa",
32
+ "financial assistance",
33
+ "benefit payments",
34
+ "payees",
35
+ "pension risk transfer",
36
+ "data book"
37
+ ],
38
+ "questions": [
39
+ "PBGC single-employer program net position over time",
40
+ "number of participants in PBGC-insured multiemployer plans",
41
+ "PBGC premium rates history (flat-rate and variable-rate)",
42
+ "special financial assistance paid to multiemployer plans",
43
+ "PBGC maximum guaranteed benefit by year",
44
+ "underfunding of PBGC-insured single-employer plans"
45
+ ],
46
+ "homepage": "https://www.pbgc.gov/about/reports/pension-insurance-data",
47
+ "terms_url": "https://www.pbgc.gov/about/policies/website",
48
+ "auth": {
49
+ "env": null,
50
+ "required": "none",
51
+ "placement": "none",
52
+ "signup_url": null,
53
+ "echoes_key": false
54
+ },
55
+ "limits": {
56
+ "rps": 1,
57
+ "burst": 2,
58
+ "max_rows": 50000
59
+ },
60
+ "routes": {
61
+ "api": {
62
+ "base": "https://www.pbgc.gov",
63
+ "probe": "https://www.pbgc.gov/about/reports/pension-insurance-data",
64
+ "hosts": [
65
+ "www.pbgc.gov"
66
+ ]
67
+ },
68
+ "manual": {
69
+ "how": "Open https://www.pbgc.gov/about/reports/pension-insurance-data in a browser, click the Excel link in the row of the edition you need (e.g. \"2024 Pension Insurance Data Tables (1st Installment)\"), save the workbook under the name shown in INSTRUCTIONS.md, and upload it. The PDF next to it has the same tables with their titles."
70
+ }
71
+ },
72
+ "cache": {
73
+ "mode": "run_only",
74
+ "ttl_hours": null,
75
+ "why": "An edition changes only when PBGC posts a revision or the next installment; workbooks are 1-3 MB."
76
+ },
77
+ "redistribution": {
78
+ "mode": "allowed",
79
+ "why": "PBGC is a federal agency; its data tables are U.S. government works (17 U.S.C. 105), in the public domain."
80
+ },
81
+ "notices": [],
82
+ "retention": null,
83
+ "citation": "Pension Benefit Guaranty Corporation, Pension Insurance Data Tables ({dataset}), www.pbgc.gov, retrieved {retrieved_long}.",
84
+ "audit_hooks": [],
85
+ "clarify": [
86
+ "Single-employer program (S- tables), multiemployer program (M- tables), or both? They are separate insurance programs with separate finances, premiums and guarantees; never add them unless the table does (GLANCE has combined totals).",
87
+ "Which edition? The newest (2024, a 1st installment) lacks the Form 5500-based tables (participant status, funding, industry, state); those come from the 2023 edition. Default: the newest edition that has the table."
88
+ ],
89
+ "formats": [
90
+ "xlsx",
91
+ "xls",
92
+ "html"
93
+ ]
94
+ }
@@ -1,85 +1,85 @@
1
- {
2
- "base_url": "https://www.philadelphiafed.org/-/media/FRBP/Assets/Surveys-And-Data",
3
- "timeout": 90,
4
- "endpoints": {
5
- "spf": {
6
- "path": "/survey-of-professional-forecasters/historical-data/{file}.xlsx",
7
- "description": "Survey of Professional Forecasters, median or mean across forecasters, one row per quarterly survey since 1968:Q4 (YEAR, QUARTER) for one variable (worksheet). Level files: VAR1 = last quarter of history, VAR2 = current-quarter nowcast, VAR3..VAR6 = the next four quarters, VARA/VARB(/C/D) = annual averages for the survey year and the following years. Growth files: dvar2..dvar6 = annualized quarter-over-quarter growth of the median (mean) level for the current and next four quarters.",
8
- "params": {
9
- "file": {"in": "path", "required": true, "enum": ["medianLevel", "medianGrowth", "meanLevel", "meanGrowth"], "desc": "medianLevel / meanLevel (levels, and CPI/PCE inflation rates) or medianGrowth / meanGrowth (q/q annualized growth of the level forecasts; not for CPI/PCE or rates)"},
10
- "sheet": {"in": "records", "required": true, "desc": "the variable = worksheet name, case-sensitive: RGDP, NGDP, PGDP, UNEMP, EMP, CPI, CORECPI, PCE, COREPCE, TBILL, TBOND, HOUSING, INDPROD, RCONSUM, ...; long-run: CPI10, PCE10, RGDP10, CPI5YR, PCE5YR (level files only)"}
11
- },
12
- "records": "$xlsx",
13
- "header_row": 1,
14
- "missing": ["", "#N/A"],
15
- "paging": {"type": "none"}
16
- },
17
- "spf_dispersion": {
18
- "path": "/survey-of-professional-forecasters/historical-data/Dispersion_{measure}.xlsx",
19
- "description": "SPF cross-sectional dispersion, one row per survey (Survey_Date(T) like 2026Q3): 25th and 75th percentiles across forecasters and their difference for horizons T..T+4. measure 1 = levels (D1), 2 = q/q annualized growth (D2), 3 = 100*log(P75/P25) of levels (D3).",
20
- "params": {
21
- "measure": {"in": "path", "required": true, "enum": ["1", "2", "3"], "desc": "1 levels, 2 q/q growth (annualized percentage points), 3 percent difference of levels"},
22
- "sheet": {"in": "records", "required": true, "desc": "variable worksheet, e.g. RGDP (measures 2 and 3), UNEMP, CPI, TBOND (measure 1); see source.md"}
23
- },
24
- "records": "$xlsx",
25
- "header_row": 10,
26
- "missing": ["", "#N/A"],
27
- "paging": {"type": "none"}
28
- },
29
- "spf_prob": {
30
- "path": "/survey-of-professional-forecasters/historical-data/prob.xlsx",
31
- "description": "SPF mean probabilities (percent) across forecasters, one row per survey: PRGDP (annual-average real GDP growth ranges), PRPGDP (GDP price inflation), PRCCPI, PRCPCE (core inflation, Q4/Q4), PRUNEMP (annual unemployment rate), RECESS (RECESS1..5 = probability of a decline in real GDP in the current and next four quarters; RECESS2 is the Anxious Index). Bin columns (PRGDP1..) are ranges whose definitions changed over time: see source.md.",
32
- "params": {
33
- "sheet": {"in": "records", "required": true, "enum": ["PRGDP", "PRPGDP", "PRUNEMP", "PRCCPI", "PRCPCE", "RECESS"], "desc": "probability variable"}
34
- },
35
- "records": "$xlsx",
36
- "header_row": 1,
37
- "missing": ["", "#N/A"],
38
- "paging": {"type": "none"}
39
- },
40
- "greenbook": {
41
- "path": "/greenbook-data/documentation/GBweb_Row_Format.xlsx",
42
- "description": "Federal Reserve Board staff Greenbook/Tealbook projections, one row per Greenbook (DATE = year.quarter of the Greenbook, GBdate = publication date yyyymmdd), 1967 to the last released year (5-year lag: through December 2020 as of 2026). Columns VARB4..VARB1 = history for quarters T-4..T-1, VARF0 = current quarter, VARF1..VARF9 = the next nine quarters.",
43
- "params": {
44
- "sheet": {"in": "records", "required": true, "enum": ["gRGDP", "gPGDP", "UNEMP", "gPCPI", "gPCPIX", "gPPCE", "gPPCEX", "gRPCE", "gRBF", "gRRES", "gRGOVF", "gRGOVSL", "gNGDP", "HSTART", "gIP"], "desc": "variable worksheet: g-prefixed = q/q annualized growth or inflation; UNEMP percent; HSTART millions of units"}
45
- },
46
- "records": "$xlsx",
47
- "header_row": 1,
48
- "missing": ["", "#N/A"],
49
- "paging": {"type": "none"}
50
- },
51
- "livingston": {
52
- "path": "/livingston-survey/historical-data/{file}.xlsx",
53
- "description": "Livingston Survey (June and December since 1946), median or mean across forecasters, one row per survey (Date = Excel serial date; the pack adds survey_date). Level files: X_BP last known value, X_ZM survey month/quarter, X_6M, X_12M ahead, X_BY last annual average, X_ZY survey-year annual average, X_1Y, X_2Y following years, X_10Y 10-year average growth (RGDPX, CPI). Growth files: G_BP_To_ZM ... G_1Y_To_2Y annualized growth between those horizons.",
54
- "params": {
55
- "file": {"in": "path", "required": true, "enum": ["medians", "means", "MedianGrowthRate", "MeanGrowthRate"], "desc": "medians / means (levels) or MedianGrowthRate / MeanGrowthRate"},
56
- "sheet": {"in": "records", "required": true, "desc": "variable worksheet: RGDPX (real GDP), GDPX (nominal GDP), CPI, PPI, UNPR (unemployment), IP, TPHS (housing starts), TBILL, TBOND, PRIME, SPIF (S&P 500), BFIX, CPAT, WMFG, RTTR, AUTODF"}
57
- },
58
- "records": "$xlsx",
59
- "header_row": 1,
60
- "missing": ["", "#N/A"],
61
- "paging": {"type": "none"}
62
- },
63
- "rtdsm": {
64
- "path": "/real-time-data/data-files/xlsx/{file}.xlsx",
65
- "description": "Real-Time Data Set for Macroeconomists: one variable, one row per observation date (DATE like 2025:Q4 or 2025:M10) and one column per data vintage (e.g. ROUTPUT26Q3 = as published in mid-August 2026). Use it for the history the SPF forecasters saw, first releases and revisions.",
66
- "params": {
67
- "file": {"in": "path", "required": true, "catalog": true, "desc": "file stem: ROUTPUTQvQd (real GDP, quarterly vintages), routputMvQd (monthly vintages), NOUTPUTQvQd, PQvQd (GDP price index), pcpiMvMd (CPI), rucQvMd (unemployment rate), employMvMd (payrolls), RCONQvQd; or a catalog alias (real_gdp, cpi, unemployment ...). Other variables: the page of each variable under real-time-data-set-full-time-series-history"}
68
- },
69
- "records": "$xlsx",
70
- "header_row": 1,
71
- "missing": ["", "#N/A"],
72
- "paging": {"type": "none"}
73
- }
74
- },
75
- "catalog": {
76
- "real_gdp": {"id": "ROUTPUTQvQd", "name": "Real GDP (real GNP before 1992), quarterly data, quarterly vintages", "description": "Billions of chained dollars, SAAR; base year changes across vintages", "endpoint": "rtdsm"},
77
- "real_gdp_monthly_vintages": {"id": "routputMvQd", "name": "Real GDP, quarterly data, monthly vintages", "description": "Each monthly vintage (advance, second, third estimates)", "endpoint": "rtdsm"},
78
- "nominal_gdp": {"id": "NOUTPUTQvQd", "name": "Nominal GDP, quarterly data, quarterly vintages", "description": "Billions of dollars, SAAR", "endpoint": "rtdsm"},
79
- "gdp_price_index": {"id": "PQvQd", "name": "GDP price index (deflator), quarterly data, quarterly vintages", "description": "Index, base year changes across vintages", "endpoint": "rtdsm"},
80
- "real_consumption": {"id": "RCONQvQd", "name": "Real personal consumption expenditures, quarterly vintages", "description": "Billions of chained dollars, SAAR", "endpoint": "rtdsm"},
81
- "cpi": {"id": "pcpiMvMd", "name": "Consumer price index (CPI-U), monthly data, monthly vintages", "description": "Index 1982-84=100, seasonally adjusted", "endpoint": "rtdsm"},
82
- "unemployment": {"id": "rucQvMd", "name": "Civilian unemployment rate, monthly data, quarterly vintages", "description": "Percent, seasonally adjusted", "endpoint": "rtdsm"},
83
- "payrolls": {"id": "employMvMd", "name": "Nonfarm payroll employment, monthly data, monthly vintages", "description": "Thousands, seasonally adjusted", "endpoint": "rtdsm"}
84
- }
85
- }
1
+ {
2
+ "base_url": "https://www.philadelphiafed.org/-/media/FRBP/Assets/Surveys-And-Data",
3
+ "timeout": 90,
4
+ "endpoints": {
5
+ "spf": {
6
+ "path": "/survey-of-professional-forecasters/historical-data/{file}.xlsx",
7
+ "description": "Survey of Professional Forecasters, median or mean across forecasters, one row per quarterly survey since 1968:Q4 (YEAR, QUARTER) for one variable (worksheet). Level files: VAR1 = last quarter of history, VAR2 = current-quarter nowcast, VAR3..VAR6 = the next four quarters, VARA/VARB(/C/D) = annual averages for the survey year and the following years. Growth files: dvar2..dvar6 = annualized quarter-over-quarter growth of the median (mean) level for the current and next four quarters.",
8
+ "params": {
9
+ "file": {"in": "path", "required": true, "enum": ["medianLevel", "medianGrowth", "meanLevel", "meanGrowth"], "desc": "medianLevel / meanLevel (levels, and CPI/PCE inflation rates) or medianGrowth / meanGrowth (q/q annualized growth of the level forecasts; not for CPI/PCE or rates)"},
10
+ "sheet": {"in": "records", "required": true, "desc": "the variable = worksheet name, case-sensitive: RGDP, NGDP, PGDP, UNEMP, EMP, CPI, CORECPI, PCE, COREPCE, TBILL, TBOND, HOUSING, INDPROD, RCONSUM, ...; long-run: CPI10, PCE10, RGDP10, CPI5YR, PCE5YR (level files only)"}
11
+ },
12
+ "records": "$xlsx",
13
+ "header_row": 1,
14
+ "missing": ["", "#N/A"],
15
+ "paging": {"type": "none"}
16
+ },
17
+ "spf_dispersion": {
18
+ "path": "/survey-of-professional-forecasters/historical-data/Dispersion_{measure}.xlsx",
19
+ "description": "SPF cross-sectional dispersion, one row per survey (Survey_Date(T) like 2026Q3): 25th and 75th percentiles across forecasters and their difference for horizons T..T+4. measure 1 = levels (D1), 2 = q/q annualized growth (D2), 3 = 100*log(P75/P25) of levels (D3).",
20
+ "params": {
21
+ "measure": {"in": "path", "required": true, "enum": ["1", "2", "3"], "desc": "1 levels, 2 q/q growth (annualized percentage points), 3 percent difference of levels"},
22
+ "sheet": {"in": "records", "required": true, "desc": "variable worksheet, e.g. RGDP (measures 2 and 3), UNEMP, CPI, TBOND (measure 1); see source.md"}
23
+ },
24
+ "records": "$xlsx",
25
+ "header_row": 10,
26
+ "missing": ["", "#N/A"],
27
+ "paging": {"type": "none"}
28
+ },
29
+ "spf_prob": {
30
+ "path": "/survey-of-professional-forecasters/historical-data/prob.xlsx",
31
+ "description": "SPF mean probabilities (percent) across forecasters, one row per survey: PRGDP (annual-average real GDP growth ranges), PRPGDP (GDP price inflation), PRCCPI, PRCPCE (core inflation, Q4/Q4), PRUNEMP (annual unemployment rate), RECESS (RECESS1..5 = probability of a decline in real GDP in the current and next four quarters; RECESS2 is the Anxious Index). Bin columns (PRGDP1..) are ranges whose definitions changed over time: see source.md.",
32
+ "params": {
33
+ "sheet": {"in": "records", "required": true, "enum": ["PRGDP", "PRPGDP", "PRUNEMP", "PRCCPI", "PRCPCE", "RECESS"], "desc": "probability variable"}
34
+ },
35
+ "records": "$xlsx",
36
+ "header_row": 1,
37
+ "missing": ["", "#N/A"],
38
+ "paging": {"type": "none"}
39
+ },
40
+ "greenbook": {
41
+ "path": "/greenbook-data/documentation/GBweb_Row_Format.xlsx",
42
+ "description": "Federal Reserve Board staff Greenbook/Tealbook projections, one row per Greenbook (DATE = year.quarter of the Greenbook, GBdate = publication date yyyymmdd), 1967 to the last released year (5-year lag: through December 2020 as of 2026). Columns VARB4..VARB1 = history for quarters T-4..T-1, VARF0 = current quarter, VARF1..VARF9 = the next nine quarters.",
43
+ "params": {
44
+ "sheet": {"in": "records", "required": true, "enum": ["gRGDP", "gPGDP", "UNEMP", "gPCPI", "gPCPIX", "gPPCE", "gPPCEX", "gRPCE", "gRBF", "gRRES", "gRGOVF", "gRGOVSL", "gNGDP", "HSTART", "gIP"], "desc": "variable worksheet: g-prefixed = q/q annualized growth or inflation; UNEMP percent; HSTART millions of units"}
45
+ },
46
+ "records": "$xlsx",
47
+ "header_row": 1,
48
+ "missing": ["", "#N/A"],
49
+ "paging": {"type": "none"}
50
+ },
51
+ "livingston": {
52
+ "path": "/livingston-survey/historical-data/{file}.xlsx",
53
+ "description": "Livingston Survey (June and December since 1946), median or mean across forecasters, one row per survey (Date = Excel serial date; the pack adds survey_date). Level files: X_BP last known value, X_ZM survey month/quarter, X_6M, X_12M ahead, X_BY last annual average, X_ZY survey-year annual average, X_1Y, X_2Y following years, X_10Y 10-year average growth (RGDPX, CPI). Growth files: G_BP_To_ZM ... G_1Y_To_2Y annualized growth between those horizons.",
54
+ "params": {
55
+ "file": {"in": "path", "required": true, "enum": ["medians", "means", "MedianGrowthRate", "MeanGrowthRate"], "desc": "medians / means (levels) or MedianGrowthRate / MeanGrowthRate"},
56
+ "sheet": {"in": "records", "required": true, "desc": "variable worksheet: RGDPX (real GDP), GDPX (nominal GDP), CPI, PPI, UNPR (unemployment), IP, TPHS (housing starts), TBILL, TBOND, PRIME, SPIF (S&P 500), BFIX, CPAT, WMFG, RTTR, AUTODF"}
57
+ },
58
+ "records": "$xlsx",
59
+ "header_row": 1,
60
+ "missing": ["", "#N/A"],
61
+ "paging": {"type": "none"}
62
+ },
63
+ "rtdsm": {
64
+ "path": "/real-time-data/data-files/xlsx/{file}.xlsx",
65
+ "description": "Real-Time Data Set for Macroeconomists: one variable, one row per observation date (DATE like 2025:Q4 or 2025:M10) and one column per data vintage (e.g. ROUTPUT26Q3 = as published in mid-August 2026). Use it for the history the SPF forecasters saw, first releases and revisions.",
66
+ "params": {
67
+ "file": {"in": "path", "required": true, "catalog": true, "desc": "file stem: ROUTPUTQvQd (real GDP, quarterly vintages), routputMvQd (monthly vintages), NOUTPUTQvQd, PQvQd (GDP price index), pcpiMvMd (CPI), rucQvMd (unemployment rate), employMvMd (payrolls), RCONQvQd; or a catalog alias (real_gdp, cpi, unemployment ...). Other variables: the page of each variable under real-time-data-set-full-time-series-history"}
68
+ },
69
+ "records": "$xlsx",
70
+ "header_row": 1,
71
+ "missing": ["", "#N/A"],
72
+ "paging": {"type": "none"}
73
+ }
74
+ },
75
+ "catalog": {
76
+ "real_gdp": {"id": "ROUTPUTQvQd", "name": "Real GDP (real GNP before 1992), quarterly data, quarterly vintages", "description": "Billions of chained dollars, SAAR; base year changes across vintages", "endpoint": "rtdsm"},
77
+ "real_gdp_monthly_vintages": {"id": "routputMvQd", "name": "Real GDP, quarterly data, monthly vintages", "description": "Each monthly vintage (advance, second, third estimates)", "endpoint": "rtdsm"},
78
+ "nominal_gdp": {"id": "NOUTPUTQvQd", "name": "Nominal GDP, quarterly data, quarterly vintages", "description": "Billions of dollars, SAAR", "endpoint": "rtdsm"},
79
+ "gdp_price_index": {"id": "PQvQd", "name": "GDP price index (deflator), quarterly data, quarterly vintages", "description": "Index, base year changes across vintages", "endpoint": "rtdsm"},
80
+ "real_consumption": {"id": "RCONQvQd", "name": "Real personal consumption expenditures, quarterly vintages", "description": "Billions of chained dollars, SAAR", "endpoint": "rtdsm"},
81
+ "cpi": {"id": "pcpiMvMd", "name": "Consumer price index (CPI-U), monthly data, monthly vintages", "description": "Index 1982-84=100, seasonally adjusted", "endpoint": "rtdsm"},
82
+ "unemployment": {"id": "rucQvMd", "name": "Civilian unemployment rate, monthly data, quarterly vintages", "description": "Percent, seasonally adjusted", "endpoint": "rtdsm"},
83
+ "payrolls": {"id": "employMvMd", "name": "Nonfarm payroll employment, monthly data, monthly vintages", "description": "Thousands, seasonally adjusted", "endpoint": "rtdsm"}
84
+ }
85
+ }
@@ -1,94 +1,94 @@
1
- {
2
- "id": "philfed",
3
- "title": "Philadelphia Fed Real-Time Data Research Center (Survey of Professional Forecasters, Greenbook/Tealbook, Livingston Survey, Real-Time Data Set)",
4
- "agency": "Federal Reserve Bank of Philadelphia",
5
- "depth": "standard",
6
- "domains": [
7
- "macroeconomic forecasts",
8
- "economic outlook",
9
- "inflation expectations",
10
- "real-time data"
11
- ],
12
- "keywords": [
13
- "survey of professional forecasters",
14
- "spf",
15
- "professional forecasters",
16
- "consensus forecast",
17
- "private forecasters",
18
- "median forecast",
19
- "gdp forecast",
20
- "inflation forecast",
21
- "unemployment forecast",
22
- "inflation expectations",
23
- "long-run inflation expectations",
24
- "10-year inflation",
25
- "forecast dispersion",
26
- "forecast uncertainty",
27
- "probability of recession",
28
- "anxious index",
29
- "greenbook",
30
- "tealbook",
31
- "fed staff forecast",
32
- "livingston survey",
33
- "real-time data",
34
- "data vintages",
35
- "first release",
36
- "forecast accuracy",
37
- "philadelphia fed"
38
- ],
39
- "questions": [
40
- "what do professional forecasters expect for real GDP growth this year and next",
41
- "median SPF forecast for unemployment and CPI inflation over the next four quarters",
42
- "10-year inflation expectations of professional forecasters over time",
43
- "how far apart are forecasters (dispersion) on next year's GDP growth",
44
- "Fed staff Greenbook forecasts of inflation in 2008",
45
- "real GDP as it was first published, by vintage"
46
- ],
47
- "homepage": "https://www.philadelphiafed.org/surveys-and-data/real-time-data-research",
48
- "terms_url": "https://www.philadelphiafed.org/about-us/privacy-notice",
49
- "auth": {
50
- "env": null,
51
- "required": "none",
52
- "placement": "none",
53
- "signup_url": null,
54
- "echoes_key": false
55
- },
56
- "limits": {
57
- "rps": 1,
58
- "burst": 3,
59
- "max_rows": 100000
60
- },
61
- "routes": {
62
- "api": {
63
- "base": "https://www.philadelphiafed.org/-/media/FRBP/Assets/Surveys-And-Data",
64
- "probe": "https://www.philadelphiafed.org/-/media/FRBP/Assets/Surveys-And-Data/survey-of-professional-forecasters/spf-release-dates.txt",
65
- "hosts": [
66
- "www.philadelphiafed.org"
67
- ]
68
- },
69
- "manual": {
70
- "how": "Open each link in manual_download/INSTRUCTIONS.md in a browser; it downloads the Philadelphia Fed's .xlsx workbook. Upload the workbook unchanged (the pack reads the worksheet named in the spec). Without the links: SPF median and mean forecasts at https://www.philadelphiafed.org/surveys-and-data/real-time-data-research/median-forecasts and .../mean-forecasts, dispersion at .../dispersion-forecasts, probabilities at .../probability-variables, Greenbook/Tealbook at .../greenbook, Livingston at .../livingston-historical-data, real-time data at .../real-time-data-set-full-time-series-history (each page lists the files)."
71
- }
72
- },
73
- "cache": {
74
- "mode": "run_only",
75
- "ttl_hours": null,
76
- "why": "Workbooks change once a quarter (SPF) or less often; data/ is reused only within a run."
77
- },
78
- "redistribution": {
79
- "mode": "allowed",
80
- "why": "Published openly by the Federal Reserve Bank of Philadelphia; its online terms of use allow informational, educational and research use, with the Bank credited as the source. The Bank is not a federal agency, so the data are not public domain: credit it and do not imply its endorsement."
81
- },
82
- "notices": [],
83
- "retention": null,
84
- "citation": "Federal Reserve Bank of Philadelphia, Real-Time Data Research Center, {dataset}, philadelphiafed.org, retrieved {retrieved_long}.",
85
- "audit_hooks": [],
86
- "clarify": [
87
- "Which growth measure: quarter-over-quarter annualized (the SPF quarterly forecasts), annual-average over annual-average (SPF and Livingston annual GDP), or fourth-quarter over fourth-quarter (SPF annual CPI and PCE inflation)? Default: the measure the SPF release itself reports for that variable, named in the answer.",
88
- "Median or mean across forecasters? Default: median, as in the SPF news release.",
89
- "Which survey: the latest (default) or the one in force at a past date (each row is one survey)?"
90
- ],
91
- "formats": [
92
- "xlsx"
93
- ]
94
- }
1
+ {
2
+ "id": "philfed",
3
+ "title": "Philadelphia Fed Real-Time Data Research Center (Survey of Professional Forecasters, Greenbook/Tealbook, Livingston Survey, Real-Time Data Set)",
4
+ "agency": "Federal Reserve Bank of Philadelphia",
5
+ "depth": "standard",
6
+ "domains": [
7
+ "macroeconomic forecasts",
8
+ "economic outlook",
9
+ "inflation expectations",
10
+ "real-time data"
11
+ ],
12
+ "keywords": [
13
+ "survey of professional forecasters",
14
+ "spf",
15
+ "professional forecasters",
16
+ "consensus forecast",
17
+ "private forecasters",
18
+ "median forecast",
19
+ "gdp forecast",
20
+ "inflation forecast",
21
+ "unemployment forecast",
22
+ "inflation expectations",
23
+ "long-run inflation expectations",
24
+ "10-year inflation",
25
+ "forecast dispersion",
26
+ "forecast uncertainty",
27
+ "probability of recession",
28
+ "anxious index",
29
+ "greenbook",
30
+ "tealbook",
31
+ "fed staff forecast",
32
+ "livingston survey",
33
+ "real-time data",
34
+ "data vintages",
35
+ "first release",
36
+ "forecast accuracy",
37
+ "philadelphia fed"
38
+ ],
39
+ "questions": [
40
+ "what do professional forecasters expect for real GDP growth this year and next",
41
+ "median SPF forecast for unemployment and CPI inflation over the next four quarters",
42
+ "10-year inflation expectations of professional forecasters over time",
43
+ "how far apart are forecasters (dispersion) on next year's GDP growth",
44
+ "Fed staff Greenbook forecasts of inflation in 2008",
45
+ "real GDP as it was first published, by vintage"
46
+ ],
47
+ "homepage": "https://www.philadelphiafed.org/surveys-and-data/real-time-data-research",
48
+ "terms_url": "https://www.philadelphiafed.org/about-us/privacy-notice",
49
+ "auth": {
50
+ "env": null,
51
+ "required": "none",
52
+ "placement": "none",
53
+ "signup_url": null,
54
+ "echoes_key": false
55
+ },
56
+ "limits": {
57
+ "rps": 1,
58
+ "burst": 3,
59
+ "max_rows": 100000
60
+ },
61
+ "routes": {
62
+ "api": {
63
+ "base": "https://www.philadelphiafed.org/-/media/FRBP/Assets/Surveys-And-Data",
64
+ "probe": "https://www.philadelphiafed.org/-/media/FRBP/Assets/Surveys-And-Data/survey-of-professional-forecasters/spf-release-dates.txt",
65
+ "hosts": [
66
+ "www.philadelphiafed.org"
67
+ ]
68
+ },
69
+ "manual": {
70
+ "how": "Open each link in manual_download/INSTRUCTIONS.md in a browser; it downloads the Philadelphia Fed's .xlsx workbook. Upload the workbook unchanged (the pack reads the worksheet named in the spec). Without the links: SPF median and mean forecasts at https://www.philadelphiafed.org/surveys-and-data/real-time-data-research/median-forecasts and .../mean-forecasts, dispersion at .../dispersion-forecasts, probabilities at .../probability-variables, Greenbook/Tealbook at .../greenbook, Livingston at .../livingston-historical-data, real-time data at .../real-time-data-set-full-time-series-history (each page lists the files)."
71
+ }
72
+ },
73
+ "cache": {
74
+ "mode": "run_only",
75
+ "ttl_hours": null,
76
+ "why": "Workbooks change once a quarter (SPF) or less often; data/ is reused only within a run."
77
+ },
78
+ "redistribution": {
79
+ "mode": "allowed",
80
+ "why": "Published openly by the Federal Reserve Bank of Philadelphia; its online terms of use allow informational, educational and research use, with the Bank credited as the source. The Bank is not a federal agency, so the data are not public domain: credit it and do not imply its endorsement."
81
+ },
82
+ "notices": [],
83
+ "retention": null,
84
+ "citation": "Federal Reserve Bank of Philadelphia, Real-Time Data Research Center, {dataset}, philadelphiafed.org, retrieved {retrieved_long}.",
85
+ "audit_hooks": [],
86
+ "clarify": [
87
+ "Which growth measure: quarter-over-quarter annualized (the SPF quarterly forecasts), annual-average over annual-average (SPF and Livingston annual GDP), or fourth-quarter over fourth-quarter (SPF annual CPI and PCE inflation)? Default: the measure the SPF release itself reports for that variable, named in the answer.",
88
+ "Median or mean across forecasters? Default: median, as in the SPF news release.",
89
+ "Which survey: the latest (default) or the one in force at a past date (each row is one survey)?"
90
+ ],
91
+ "formats": [
92
+ "xlsx"
93
+ ]
94
+ }