Scan to join WeChat group宏观经济数据查询
本skill提供查询全球宏观经济数据的能力，基于国信证券专业数据库，支持自然语言查询宏观经济指标。
服务地址
默认服务地址: https://dgzt.guosen.com.cn/skills
密钥来源与安全说明
- 本技能使用一个环境变量：
GS_API_KEY。 GS_API_KEY由国信证券接口服务签发，用于接口鉴权。- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。
- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。
功能范围
5.1 国内经济指标
| 数据领域 | 覆盖指标（示例） | 可用频率 | |----------|------------------|----------| | 国民经济核算 | GDP、GNP、工业增加值、服务业增加值 | 年、季、月 | | 价格指数 | CPI、PPI、PPIRM、GDP平减指数、房价指数 | 年、季、月 | | 货币金融 | M0/M1/M2、社融规模、信贷数据、LPR、SHIBOR、汇率 | 年、季、月、周、日 | | 财政收支 | 公共财政收入/支出、政府性基金收支、债务余额 | 年、月 | | 对外贸易 | 进出口总额、贸易差额、外汇储备、实际利用外资 | 年、月 | | 就业民生 | 城镇调查失业率、城镇新增就业、居民可支配收入 | 年、季、月 | | 产业运行 | PMI（制造业/非制造业）、发电量、工业产量、固定资产投资 | 年、月 |
5.2 国际宏观指标
| 地区 | 覆盖指标（示例） | 可用频率 | |------|------------------|----------| | 美国 | CPI/PCE、非农就业、联邦基准利率、GDP、PMI | 视指标而定 | | 欧元区 | CPI、PMI（制造业/服务业）、GDP增速、ECB利率 | 视指标而定 | | 日本 | GDP、CPI、PMI、贸易数据 | 视指标而定 | | 其他主要经济体 | 印度、巴西、英国等主要经济体核心指标 | 视指标而定 |
5.3 大宗商品价格
注意：大宗商品查询必须指定具体品种名称，不支持「大宗商品」「有色金属」等大类泛指。
| 品类 | 代表品种 | |------|----------| | 能源 | WTI原油、布伦特原油、天然气 | | 贵金属 | COMEX黄金、COMEX白银 | | 有色金属 | LME铜、LME铝、LME铅、LME锌 |
5.4 支持的时间维度
| 时间表述方式 | 示例 | 说明 | |--------------|------|------| | 相对时间 | 过去三年、近十年、上个月 | 无需绝对日期，自动推算时间范围 | | 绝对时间 | 2020年至2024年 | 支持指定起止年份 | | 缺省（最新） | （不指定时间） | 返回最新可用数据 |
5.5 典型查询示例
| 类型 | 错误示例（禁止） | 正确示例（推荐） | |------|------------------|------------------| | 国内经济 | 查询中国经济 | 查询中国GDP同比增速、CPI同比、PPI同比 | | 货币金融 | 查询中国货币情况 | 查询中国M2同比增速、社融存量同比 | | 区域数据 | 查询华东地区经济 | 查询华东地区各省GDP | | 全球宏观 | 查询全球通胀 | 查询美国、欧元区、日本的CPI同比 | | 商品价格 | 查询大宗商品价格 | 查询WTI原油、LME铜、COMEX黄金的近期价格走势 | | 时间灵活 | — | 查询中国过去十年的固定资产投资完成额累计同比 | | 默认时间 | — | 查询美国最新的非农就业数据 |
更多查询示例
- 查询中国近五年GDP同比增速
- 查询上个月美国的非农就业数据
- 查询华东地区各省GDP季度数据
- 查询中国过去一年的M2同比增速和社融存量
- 查询近三个月铜和铝的LME现货价格
- 查询美国联邦基准利率近两年的变化
- 查询中国各省近三年的固定资产投资完成额
- 查询欧元区和美国最新的CPI同比数据
输入约束
时间、地区描述
时间维度：支持相对时间表述（如”今年”、”过去三年”、”上月”、”近十年”）。 地域维度：支持宏观地区表述（如”中国”、”美国”、”欧元区”、”华东地区”、”中国各省”），无需拆解为具体省市列表。
禁止模糊商品类别
禁止输入：大类统称（如”稀土金属”、”有色金属”、”农产品”、”大宗商品”、”能源”）。 要求：必须解包为具体的交易品种名称或代码。 示例类型 示例内容 ❌ 错误示例 查询有色金属价格走势 ❌ 错误示例 查询大宗商品价格 ✅ 正确示例 查询铜、铝、铅、锌的现货价格走势 ✅ 正确示例 查询 WTI 原油、LME 铜、COMEX 黄金的近期价格走势
禁止宏观泛指查询
禁止输入：宽泛经济概念而无具体指标（如”中国经济情况”、”美国制造业状况”、”全球通胀”）。 要求：必须指定具体的指标名称（如 GDP、CPI、PPI、PMI、M2、失业率等）。 示例类型 示例内容 ❌ 错误示例 查询中国经济数据 ❌ 错误示例 查询美国制造业状况 ✅ 正确示例 查询中国 GDP 同比增速、CPI 同比、PPI 同比 ✅ 正确示例 查询美国制造业 PMI
时间与地域的灵活性
时间维度支持相对时间表述；地域维度支持宏观地区表述，无需拆解为具体省市列表。 维度 支持形式 注意事项 时间 今年、过去三年、上月、近十年、缺省（返回最新） 无需指定绝对日期 地域 中国、美国、欧元区、华东地区、中国各省 华东地区将自动解析为7个省市；动态排名表述建议先列举具体国家
操作步骤
步骤 1: 获取并配置 API Key
检查 API Key 配置:
- 尝试读取
./memory.md文件中的GS_API_KEY字段 - 如果文件不存在或字段未配置，引导用户获取
获取 API Key（当未配置时）:
- 访问国信证券 Skill 聚合网站: https://www.guosen.com.cn/gs/xxskills/key-index.html?softName=tx_skills
- 注册/登录账号
- 点击网页顶部「登录」按钮
- 登录后点击账号，在弹窗中一键复制 API Key
保存 API Key:
- 注册成功后，立即将以下内容写入
./memory.md:GS_API_KEY=your_actual_api_key_here - 如果
./memory.md文件不存在，创建该文件并写入上述内容 - 如果文件已存在，添加或更新
GS_API_KEY字段
使用脚本读取 API Key:
- 调用
scripts/get_data.py时，脚本会自动从环境变量读取GS_API_KEY - 智能体需要先从
./memory.md读取GS_API_KEY，然后将其设置为环境变量供脚本使用
步骤 2: 执行查询
- 根据用户需求选择查询接口:
- 调用
scripts/get_data.py脚本，传入查询参数。
# Windows PowerShell
# 假设当前目录为项目根目录（即 gs_economy_query 所在目录）
$env:GS_API_KEY="your_api_key"
python .\gs_economy_query\scripts\get_data.py "中国一季度GDP增速"
# macOS / Linux
# 假设当前目录为项目根目录（即 gs_economy_query 所在目录）
export GS_API_KEY="your_api_key"
python3 ./gs_economy_query/scripts/get_data.py "中国一季度GDP增速"
参数说明：
| 参数 | 说明 | 必填 |
|---|---|---|
| query（位置参数） | 自然语言查询文本 | ✅ |
| --no-stream | 一次性返回完整结果（非流式） | 否 |
代码调用
from pathlib import Path
from scripts.get_data import query_macro_data
result = query_macro_data(
query="中国一季度GDP增速",
stream=False
)
if "error" in result:
print(result["error"])
else:
print(result["content"])
返回字段说明
content：查询结果内容（markdown格式）error：查询失败时返回错误信息
环境要求
- Python 3.13 及以上版本
环境变量
| 变量 | 说明 | 默认 |
|---|---|---|
| GS_API_KEY | 国信接口鉴权 key（必填） | 空 |
密钥来源与安全说明
- 本技能使用一个环境变量：
GS_API_KEY。 GS_API_KEY由国信证券接口服务签发，用于接口鉴权。- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。
- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。
注意事项
- API Key 需要从
./memory.md的GS_API_KEY字段读取，不要硬编码 - 调用脚本前必须设置环境变量
GS_API_KEY - 重要: 如果 API 调用失败，直接提醒用户"数据获取失败"，不要尝试从联网搜索或其他渠道获取数据
- 注意：返回数据仅供参考，不作为投资建议。