批量搜索多个关键词的统计数据。一次性查询多个指标，提高效率。

Args:

• keywords (string[]): 搜索关键词数组，如 ["GDP", "CPI", "人口"]

• pageSize (number): 每个关键词返回的结果数量，默认5

Returns: 按关键词分组的搜索结果

示例： cnbs_batch_search(keywords=["GDP", "CPI", "出生率"]) 返回三个关键词各自的搜索结果

对比不同地区或不同时间的数据。支持地区对比和时间对比。

Args:

• keyword (string): 搜索关键词

• regions (string[]): 要对比的地区名称数组，如 ["北京", "上海", "广东"]

• compareType (string): 对比类型，"region"（地区对比）或 "time"（时间对比）

• years (string[]): 时间对比时的年份数组，如 ["2022", "2023", "2024"]

Returns: 对比结果表格

示例：

• 地区对比：cnbs_compare(keyword="GDP", regions=["北京", "上海"], compareType="region")

• 时间对比：cnbs_compare(keyword="GDP", compareType="time", years=["2022", "2023", "2024"])

一次性获取中国当前核心宏观经济指标的最新值，覆盖 GDP、CPI、PPI、PMI、失业率、工业、消费、投资、贸易、货币供应。 适合需要快速了解中国经济全貌的场景，避免多次单独调用 cnbs_search。

Returns: 10 项核心指标的最新值及元数据（指标名、值、单位、时间）

示例： cnbs_economic_snapshot()

从特定数据源获取数据，支持扩展数据源。

Args:

• source (string): 数据源名称，如 "cnbs"、"census"、"international"、"department"

• params (object): 数据源特定的参数

Returns: 数据源返回的数据

⚠️ FRED 注意：通过此工具调用 source="fred" 时，仅支持 FRED_API_KEY 环境变量，不支持 X-Fred-Api-Key 请求头。HTTP 模式请改用专用工具 ext_fred。

示例： cnbs_fetch_data_from_source(source="cnbs", params={keyword: "GDP"}) cnbs_fetch_data_from_source(source="census", params={type: "population", year: "2020"}) cnbs_fetch_data_from_source(source="international", params={source: "world_bank", indicator: "GDP", country: "CHN"}) cnbs_fetch_data_from_source(source="department", params={department: "finance", indicator: "财政收入", period: "2024Q1"})

递归获取指定分类代码下所有叶子节点（setId）。注意：耗时长，不建议频繁使用。

Args:

• category (string): 分类代码：1月度 2季度 3年度 5分省季度 6分省年度 7其他

Returns: 所有叶子节点列表

根据数据集ID (setId) 获取所有可用指标列表。支持同时查询多个数据集。

Args:

• setIds (string | string[]): 单个或多个数据集ID，来自 cnbs_search 或 cnbs_fetch_nodes 的 isEnd=true 节点

• name (string): 指标名称过滤（可选，单个 setId 时有效）

Returns: 指标列表，多个 setId 时返回按 setId 分组的结果

获取中国国家统计局分类树节点。支持同时查询多个分类。isEnd=true 的节点 id 即为 setId。

Args:

• categories (string | string[]): 单个或多个分类代码，如 "3" 或 ["1","2","3"]（1月度 2季度 3年度 5分省季度 6分省年度 7其他）

• parentId (string): 父节点ID，空或省略表示从根节点开始（单分类时有效）

Returns: 分类树节点列表，多个分类时返回按分类代码分组的结果

批量获取统计指标数据。支持多个指标ID、多个时间段、多地区。

Args:

• setId (string): 数据集ID

• metricIds (string[]): 指标ID数组

• periods (string[]): 时间范围数组，如 ["202501MM-202503MM"] 或 ["2023YY-2025YY"]

• areas (array): 地区维度，默认全国

• rootId (string): 根节点ID，月度数据默认为 fc982599aa684be7969d7b90b1bd0e84

Returns: 统计数据点列表

获取所有数据分类信息，包括分类代码、名称和时间粒度。

Returns: 分类列表，包含代码、名称、时间粒度类型

示例返回：

• 代码 1：月度数据（CPI、PPI等）

• 代码 2：季度数据（GDP季度值等）

• 代码 3：年度数据（GDP年度值、人口等）

• 代码 6：分省年度数据

获取本 MCP 服务器的使用指南，包括工具列表、使用建议和重要提示。建议首次使用时调用此工具了解如何正确使用其他工具。

获取可用的地区列表，用于分省数据查询。返回地区代码和名称列表。

Args:

• keyword (string): 搜索关键词，可选，用于过滤地区

• level (string): 地区级别过滤，可选：province（省级）、city（市级）、county（县级）

Returns: 地区列表，包含 code（地区代码）、name（全称）、shortName（简称）

示例：

• 不传参数：返回所有省份

• keyword="广东"：返回广东省

• keyword="江"：返回名称包含"江"的省份（江苏、浙江等）

获取特定数据源的分类信息。

Args:

• source (string): 数据源名称，如 "census"、"international"、"department"

Returns: 数据源的分类信息

示例： cnbs_get_source_categories(source="census") cnbs_get_source_categories(source="international")

列出所有可用的数据源，包括国家统计局数据、普查数据、国际数据等。

Returns: 数据源列表，包括名称、描述、状态等信息

示例： cnbs_list_data_sources()

通过关键词搜索中国国家统计局指标和数据（推荐优先使用）。返回匹配的数据集列表，包含 setId、名称、时间范围等信息。

Args:

• keyword (string): 搜索关键词，如 "GDP"、"CPI"、"人口"

• pageNum (number): 页码，默认1

• pageSize (number): 每页数量，默认10

• sortBy (string): 排序方式，可选 relevance（相关性）或 time（时间）

• sortOrder (string): 排序顺序，可选 desc（降序）或 asc（升序）

• categories (string[]): 数据类型过滤，如 ["月度数据", "季度数据"]

• periodRange (object): 时间范围过滤

Returns: 匹配的数据集列表，包含 setId、名称、时间范围等信息

在特定数据源中搜索数据。

Args:

• source (string): 数据源名称，如 "census"、"international"、"department"

• keyword (string): 搜索关键词

Returns: 搜索结果

示例： cnbs_search_in_source(source="census", keyword="人口") cnbs_search_in_source(source="international", keyword="GDP")

查询国际清算银行 (BIS) 统计数据。涵盖有效汇率、信贷缺口、住宅房价、债务偿还比率等金融稳定指标。支持同时查询多个国家。完全免费，无需认证。

Args:

• dataset (string): 数据集名，如 "EER"（有效汇率）、"CREDIT_GAP"（信贷缺口）、"PROPERTY_PRICES"（房价）

• countries (string | string[]): 单个或多个 ISO2 代码，如 "CN" 或 ["CN","US","DE"]；默认 "CN"

• lastNObservations (number): 最近 N 期，默认 20

• startPeriod (string): 起始期间，如 "2015-Q1" 或 "2015-01"

预置数据集: EER | CREDIT_GAP | TOTAL_CREDIT | PROPERTY_PRICES | DEBT_SERVICE | CROSS_BORDER_BANKING

列出 BIS 数据源支持的所有预置数据集及键模板。

查询国家统计局普查数据（人口普查、经济普查、农业普查）。通过 NBS 官方 API 获取真实数据。

Args:

• type (string): 普查类型 "population"（人口）| "economic"（经济）| "agriculture"（农业）

• keyword (string): 自定义搜索关键词（可选，覆盖默认）

• pageSize (number): 返回结果数，默认 20

查询各部门在国家统计局发布的统计数据。涵盖财政、工业、商务、农业、货币金融、社会保障、房地产、能源等。

Args:

• department (string): 部门键

• indicator (string): 具体指标关键词（可选，不填则用部门默认首个关键词）

• pageSize (number): 返回数量，默认 20

• fetchAll (boolean): 是否获取该部门所有关键词数据（较慢），默认 false

可用部门: finance（财政）| industry（工业）| trade（商务）| agriculture（农业）| monetary（货币金融）| social_security（社保）| housing（房地产）| energy（能源）

列出所有可查询的部门及其指标关键词列表。

查询美联储经济数据库 (FRED)。涵盖美国GDP、利率、汇率、通胀、大宗商品价格等 800,000+ 系列。支持同时查询多个系列。 ⚠️ 需要 FRED API Key：在 MCP 客户端配置中添加请求头 X-Fred-Api-Key: <your_key>（在 https://fred.stlouisfed.org/docs/api/api_key.html 免费申请）。stdio 模式可改用 FRED_API_KEY 环境变量。

Args:

• series (string | string[]): 单个或多个系列名/FRED代码，如 "FED_FUNDS" 或 ["FED_FUNDS","CNY_USD","OIL_PRICE_WTI"]

• limit (number): 每个系列返回数量，默认 100

• sortOrder (string): "desc"（最新优先）或 "asc"

• observationStart (string): 起始日期，如 "2010-01-01"

常用系列: US_GDP | US_GDP_GROWTH | FED_FUNDS | US_10Y_YIELD | US_2Y_YIELD | CNY_USD | EUR_USD | US_UNEMPLOYMENT | US_CPI | OIL_PRICE_WTI | GOLD_PRICE | US_M2 | SP500 | VIX | DOLLAR_INDEX

列出 FRED 数据源支持的所有预置系列（利率、汇率、大宗商品、宏观经济等）。

同时从世界银行和 IMF 获取同一指标的多国数据，快速进行国际横向对比。

Args:

• wbIndicator (string): 世界银行指标，如 "GDP_GROWTH"

• imfIndicator (string): IMF 指标，如 "GDP_GROWTH"

• countries (string[]): ISO 代码，如 ["CHN","USA","DEU","JPN","IND"]

• startYear (number): 起始年份

查询 IMF 世界经济展望 (WEO) 数据。支持 GDP 增速、通胀、失业率、经常账户、政府债务等。支持同时查询多个指标。完全免费，无需认证。

Args:

• indicators (string | string[]): 单个或多个指标名/IMF代码，如 "GDP_GROWTH" 或 ["GDP_GROWTH","CPI_INFLATION","GOVT_DEBT"]

• countries (string[]): ISO 代码数组，如 ["CHN","USA","JPN"]；默认 ["CHN"]

• periods (string[]): 年份数组，如 ["2020","2021","2022","2023"]；不传则返回全部

常用指标: GDP_GROWTH | GDP_USD | GDP_PER_CAPITA | CPI_INFLATION | UNEMPLOYMENT | CURRENT_ACCOUNT | GOVT_DEBT | GOVT_BALANCE | GROSS_SAVINGS | INVESTMENT | POPULATION

获取 IMF DataMapper 完整指标目录（直接调用 IMF API）。

列出 IMF DataMapper 支持的所有预置指标。

查询 OECD 统计数据（SDMX-JSON）。支持季度GDP、就业、先行指标等。完全免费，无需认证。

Args:

• dataset (string): 预置数据集名，如 "QNA_GDP"、"KEI_CPI"、"EMPLOYMENT"

• key (string): SDMX 维度键，如 "Q.G20.B1GQ....V.N"（可选，默认 "all"，注意数据量可能较大）

• startPeriod (string): 起始期间，如 "2015-Q1" 或 "2015-01"

• lastNObservations (number): 返回最近 N 期，默认 20

预置数据集: QNA_GDP | KEI_CPI | EMPLOYMENT | TRADE

列出 OECD 数据源支持的所有预置数据集。

查询世界银行开放数据。支持 GDP、CPI、贸易、人口、失业率等全球 200+ 国家数据。完全免费，无需认证。

Args:

• indicator (string): 指标名（如 "GDP"、"CPI"、"UNEMPLOYMENT"）或 WB 指标代码（如 "NY.GDP.MKTP.CD"）

• countries (string[]): ISO3 国家代码数组，如 ["CHN","USA","JPN"]；默认 ["CHN"]

• startYear (number): 起始年份，默认 2000

• endYear (number): 结束年份，默认当前年

常用指标: GDP | GDP_GROWTH | GDP_PER_CAPITA | CPI | UNEMPLOYMENT | POPULATION | EXPORTS | IMPORTS | FDI_INFLOWS | GOVT_DEBT | GINI | LIFE_EXPECTANCY | CO2_EMISSIONS | CURRENT_ACCOUNT

列出世界银行数据源支持的所有预置指标及其代码和说明。

同时查询世界银行多个指标，跨国对比。

Args:

• indicators (string[]): 指标数组，如 ["GDP_GROWTH","CPI","UNEMPLOYMENT"]

• countries (string[]): ISO3 代码数组，如 ["CHN","USA","DEU"]

• startYear (number): 起始年份

• endYear (number): 结束年份