终极指南：如何轻松获取美国国会数据？解锁政治分析的金钥匙 🔑

想要深入了解美国政治运作，分析国会法案和投票数据吗？unitedstates/congress项目为你提供了获取美国国会数据的完整解决方案。这个开源工具集让你能够轻松访问立法、修正案、点名投票等关键政治数据，是政治分析师、研究人员和开发者的必备利器！

📊 项目核心功能概览

这个强大的数据收集工具集主要包含以下功能：

法案数据收集 - 自动下载和转换国会官方批量法案状态数据，生成易于使用的JSON和XML格式

投票数据抓取 - 从众议院和参议院网站抓取点名投票信息

政府文档获取 - 从GovInfo.gov获取法案文本、法案状态和其他官方文档

修正案处理 - 收集和分析与法案相关的修正案信息

🚀 快速入门：三步搭建数据采集环境

第一步：安装系统依赖

在Ubuntu系统上，你需要安装以下软件包：

sudo apt-get install git python3-dev libxml2-dev libxslt1-dev libz-dev python3-pip python3-venv

第二步：创建Python虚拟环境

为了避免依赖冲突，强烈建议使用虚拟环境：

python3 -m venv env
source env/bin/activate

第三步：安装项目依赖

激活虚拟环境后，一键安装所有必要组件：

pip install .

🛠️ 数据采集实战教程

获取法案数据的完整流程

使用项目提供的命令行工具，轻松启动数据采集：

# 下载官方批量法案状态数据
usc-run govinfo --bulkdata=BILLSTATUS

# 处理法案数据
usc-run bills

投票数据收集方法

项目支持从众议院和参议院分别获取投票数据，确保数据的全面性和准确性。

📁 核心模块深度解析

法案处理模块 congress/tasks/bills.py

这是项目的核心组件，主要负责：

• 读取和处理GovInfo.gov的XML法案状态文件
• 将复杂XML数据转换为易用的JSON格式
• 生成向后兼容的XML输出文件

主要功能函数：

• process_bill() - 处理单个法案的核心逻辑
• form_bill_json_dict() - XML到JSON的转换引擎
• reparse_actions() - 重新解析法案行动历史

投票处理模块 congress/tasks/votes.py

专门负责：

• 从众议院书记官网站抓取投票列表
• 从参议院网站获取XML格式的投票数据
• 生成标准化的投票标识符

⚡ 高级配置技巧

调试模式开启

想要查看详细的处理过程？使用调试模式：

usc-run bills --log=info

强制刷新数据

如果需要重新下载所有数据，使用强制刷新选项：

usc-run bills --force

🔍 数据输出格式详解

项目会自动在顶层目录创建两个文件夹：

• cache - 存储下载页面的缓存
• data - 输出批量数据文件

每个法案会生成两个数据文件：

• data.json - JSON格式，便于程序处理
• data.xml - XML格式，保持向后兼容性

💡 实际应用场景

学术研究 - 分析立法趋势和投票模式 新闻媒体 - 实时跟踪国会动态 政策分析 - 评估立法影响和议员立场 数据可视化 - 基于收集的数据创建交互式图表

🎯 为什么选择这个项目？

✅ 完全开源 - 基于CC0协议，可自由使用 ✅ 持续维护 - 由GovTrack.us和社区共同维护 ✅ 数据完整 - 覆盖法案、修正案、投票等核心数据 ✅ 易于使用 - 简单的命令行接口

📈 项目发展前景

这个项目不仅是数据收集工具，更是美国政治数据生态系统的重要组成部分。随着越来越多的开发者加入，项目的功能和数据覆盖范围正在不断扩大。

🎉 开始你的国会数据分析之旅

现在你已经掌握了使用unitedstates/congress项目的基本知识。无论你是政治学学生、数据分析师还是软件开发人员，这个工具都能帮助你轻松获取和分析美国国会数据。

准备好探索美国政治的奥秘了吗？开始使用这个强大的数据收集工具，解锁美国国会数据的无限可能！✨