核心用法
Senado Federal 技能提供对巴西联邦参议院官方开放数据API的全面访问，覆盖立法流程的完整生命周期。核心功能包括：
1. 议员信息查询：获取现任参议员名单、详细档案（含党派归属、学术背景、职业经历）、任期历史、委员会职务及领导职位
2. 法案追踪：按类型（PL/PEC/PLS等）、作者、关键词、年份搜索法案；监控法案状态（tramitação）、文本版本、修正案及报告人指派
3. 议程与投票：查询全体会议日程（当日/月度）、委员会会议安排、投票结果（记名/非记名）、议员发言记录
4. 实时数据：获取当前会期法案、近期更新事项、本周投票动态
API采用RESTful设计，支持JSON/XML格式，无需认证即可访问。
显著优点
- 官方权威性：直连
legis.senado.leg.br官方数据源，数据实时性与准确性有保障 - 覆盖完整性：涵盖巴西立法机构运作的几乎全部公开数据维度，从议员个人信息到逐条投票记录
- 零门槛接入：无需API密钥或认证，适合学术研究、新闻调查、公民监督等场景
- 结构化数据：返回格式规范的JSON/XML，便于程序化处理与分析
- 多语言友好：提供Python异步客户端，降低开发门槛
潜在局限
- 语言障碍：数据内容为葡萄牙语，非葡语用户需额外翻译处理
- 数据深度：部分历史数据可能存在缺失，API v1端点已弃用
- 性能波动：官方文档提示偶发500错误，需实现重试机制
- 地理局限：专注巴西联邦层面，不涵盖州级立法机构
- 更新频率：委员会日程等数据可能存在延迟
适合人群
- 政治学者/研究机构：巴西政治制度、立法行为、投票模式研究
- 调查记者/NGO：监督议员履职、追踪争议法案、分析党派立场
- 数据科学家：构建巴西政治知识图谱、预测立法结果
- 开发者/公民技术社群：开发议会透明度工具、投票提醒应用
- 国际观察者：追踪巴西外交、环境、经济政策的立法进展
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据可用性 | 政府API可能因维护或政策变更中断服务 |
| 法律合规 | 数据公开使用需遵守巴西信息访问法(LAI)，大规模爬取需注意速率限制 |
| 隐私边界 | 议员公开档案含教育、职业等个人信息，分析时需注意伦理边界 |
| 误解风险 | 葡语法律术语翻译易产生歧义，关键信息建议交叉核实 |
| 技术债务 | v1 API已弃用，依赖旧端点的系统需迁移至v2 |
技术提示
- 日期格式不统一：全体会议用
YYYYMMDD，法案搜索年份仅用YYYY - 单条返回可能是对象而非数组，解析时需做类型检查
- 推荐优先使用
/processo端点获取完整法案流程，而非简化的/materia - 当前会期为第57届（2023年2月起）