中国70城住宅价格指数数据技能
本技能通过国家统计局 RSS 抓取《70个大中城市商品住宅销售价格变动情况》，返回可直接供 agent 总结的结构化数据。
依赖：Python 3、requests、beautifulsoup4，以及在需要图表时可用的 matplotlib。运行时需要能访问 stats.gov.cn。
何时使用
- - 用户问某个 70 城城市最近房价走势、环比/同比/定基指数
- 用户要看新建商品住宅或二手住宅的价格指数
- 用户要最新一期官方数据，或指定近几期历史数据
- 用户需要图表辅助分析
快速流程
- 1. 先告知用户正在从国家统计局获取官方数据。
- 判断需求是“最新一期”还是“历史走势”：
- 最新一期：使用
--latest
- 历史走势：使用
--limit <N>
- 3. 运行脚本：
CODEBLOCK0
- 4. 读取 JSON 输出中的顶层字段，再决定如何组织回答。
- 以表格或简短摘要呈现，不要把原始 JSON 直接贴给用户，除非用户明确要求。
常用参数
- -
--city：目标城市，支持常见输入变体，如 INLINECODE7 - INLINECODE8 ：逗号分隔，支持
环比、同比、 INLINECODE11 - INLINECODE12 ：只返回最新一期
- INLINECODE13 ：返回最近 N 期历史数据
- INLINECODE14 ：生成图表
- INLINECODE15 ：图表输出路径
- INLINECODE16 ：禁用缓存
指标别名可直接输入：mom、yoy、环比指数、同比指数、fixed-base。
输出重点
重点看这些字段：
- -
requested_city：用户请求的城市输入 - INLINECODE23 ：脚本最终匹配到的规范城市名
- INLINECODE24 ：本次结果中的最新期次
- INLINECODE25 ：返回记录数
- INLINECODE26 ：核心数据
INLINECODE27 中每条记录包含：
- - INLINECODE28
- INLINECODE29
- INLINECODE30
- INLINECODE31
- INLINECODE32
呈现建议
- - 默认优先展示最新一期或最近几期结果
- 指标名可简写为：
-
新建商品住宅销售价格指数 ->
新建商品住宅
-
二手住宅销售价格指数 ->
二手住宅
- 高于
100 表示上涨
- 低于
100 表示下降
示例
CODEBLOCK1
参考资料
- - 城市列表和指标说明： INLINECODE40
- 数据来源：国家统计局 RSS 与公告正文
- 注意：这里是价格指数，不是绝对房价
注意事项
- - 国家统计局通常在每月中旬发布上月数据
- 网络受限时可能出现 RSS 或详情页抓取失败
- 图表默认保存到当前 skill 目录，可用
--output 覆盖
中国70城住宅价格指数数据技能
本技能通过国家统计局RSS抓取《70个大中城市商品住宅销售价格变动情况》，返回可直接供agent总结的结构化数据。
依赖：Python 3、requests、beautifulsoup4，以及在需要图表时可用的matplotlib。运行时需要能访问stats.gov.cn。
何时使用
- - 用户问某个70城城市最近房价走势、环比/同比/定基指数
- 用户要看新建商品住宅或二手住宅的价格指数
- 用户要最新一期官方数据，或指定近几期历史数据
- 用户需要图表辅助分析
快速流程
- 1. 先告知用户正在从国家统计局获取官方数据。
- 判断需求是最新一期还是历史走势：
- 最新一期：使用--latest
- 历史走势：使用--limit
- 3. 运行脚本：
bash
python3 scripts/fetch_data.py --city <城市> --metrics <指标> --latest
python3 scripts/fetch_data.py --city <城市> --metrics <指标> --limit 24
python3 scripts/fetch_data.py --city <城市> --chart --limit 24
- 4. 读取JSON输出中的顶层字段，再决定如何组织回答。
- 以表格或简短摘要呈现，不要把原始JSON直接贴给用户，除非用户明确要求。
常用参数
- - --city：目标城市，支持常见输入变体，如北京市
- --metrics：逗号分隔，支持环比、同比、定基
- --latest：只返回最新一期
- --limit：返回最近N期历史数据
- --chart：生成图表
- --output：图表输出路径
- --no-cache：禁用缓存
指标别名可直接输入：mom、yoy、环比指数、同比指数、fixed-base。
输出重点
重点看这些字段：
- - requestedcity：用户请求的城市输入
- matchedcity：脚本最终匹配到的规范城市名
- latestperiod：本次结果中的最新期次
- recordcount：返回记录数
- records：核心数据
records中每条记录包含：
- - period
- city
- indicator
- metrics
- source_url
呈现建议
- - 默认优先展示最新一期或最近几期结果
- 指标名可简写为：
- 新建商品住宅销售价格指数 -> 新建商品住宅
- 二手住宅销售价格指数 -> 二手住宅
- 高于100表示上涨
- 低于100表示下降
示例
bash
python3 scripts/fetch_data.py --city 武汉 --metrics 环比,同比 --latest
python3 scripts/fetch_data.py --city 上海市 --metrics yoy --limit 12
python3 scripts/fetch_data.py --city 北京 --metrics 环比,同比 --chart --limit 24
参考资料
- - 城市列表和指标说明：references/REFERENCE.md
- 数据来源：国家统计局RSS与公告正文
- 注意：这里是价格指数，不是绝对房价
注意事项
- - 国家统计局通常在每月中旬发布上月数据
- 网络受限时可能出现RSS或详情页抓取失败
- 图表默认保存到当前skill目录，可用--output覆盖
