/** * Census SDK — typed API client for the U.S. Census Bureau Data API. * * Standalone — no MCP server required. Usage: * * import { queryCensus, searchVariables } from "us-gov-open-data-mcp/sdk/census"; * * const data = await queryCensus("2023/acs/acs1", "NAME,B01001_001E", "state:*"); * console.log(data.headers, data.rows); * * Requires CENSUS_API_KEY env var. Get one at https://api.census.gov/data/key_signup.html */ /** Transformed Census query result: first row becomes headers, rest becomes rows. */ export interface CensusQueryResult { headers: string[]; rows: string[][]; } /** Census Variable. */ export interface CensusVariable { label?: string; concept?: string; predicateType?: string; } /** Census Variable Match. */ export interface CensusVariableMatch { id: string; label: string; concept: string; } /** Census Dataset. */ export interface CensusDataset { path: string; name: string; description: string; } /** Commonly used Census API variable codes. */ export declare const commonVariables: { readonly NAME: "Geographic area name"; readonly B01001_001E: "Total population"; readonly B01002_001E: "Median age"; readonly B02001_002E: "White alone population"; readonly B02001_003E: "Black/African American alone"; readonly B03003_003E: "Hispanic/Latino population"; readonly B19013_001E: "Median household income"; readonly B19001_001E: "Household income distribution (total)"; readonly B19301_001E: "Per capita income"; readonly B25077_001E: "Median home value (owner-occupied)"; readonly B25064_001E: "Median gross rent"; readonly B25003_001E: "Housing tenure (total occupied)"; readonly B25003_002E: "Owner-occupied housing units"; readonly B25003_003E: "Renter-occupied housing units"; readonly B17001_002E: "Population below poverty level"; readonly B15003_022E: "Bachelor's degree"; readonly B15003_023E: "Master's degree"; readonly B15003_025E: "Doctorate degree"; readonly B23025_002E: "In labor force"; readonly B23025_005E: "Unemployed"; }; /** Datasets. */ export declare const datasets: CensusDataset[]; /** * Query the Census Bureau Data API. * The raw API returns a 2D string array; this transforms it into { headers, rows }. */ export declare function queryCensus(dataset: string, variables: string, forGeo: string, inGeo?: string, extra?: Record): Promise; /** * Search for Census variable names/codes by keyword within a dataset. * Fetches the dataset's variables.json and filters locally. */ export declare function searchVariables(dataset: string, keyword: string, maxResults?: number): Promise; /** Clear cached responses. */ export declare function clearCache(): void; //# sourceMappingURL=sdk.d.ts.map