核心功能
Senado Federal 技能提供对巴西联邦参议院（Senado Federal）开放数据API的全面访问，覆盖立法、行政与财政透明三大维度。
立法追踪：支持按类型（PL/PEC/PLS等）、作者、关键词、年份搜索法案；监控法案流转状态（tramitação）、投票记录、修正案及报告人分配；追踪总统否决（vetos presidenciais）及国会复议结果。
议员档案：获取现任及历史参议员完整履历，包括所属委员会、领导职务、党派变迁、学术背景、演讲记录（discursos/apartes）、投票倾向及作者身份法案。
议程与会议：查询全体会议（plenário）及委员会（comissões）日程，支持iCal订阅；获取会议记录、速记文本（taquigrafia）及视频资源。
财政透明：通过ADM子API访问议员办公津贴（CEAP）、住房补贴、辅助办公室信息；查询公务员薪酬、加班费、企业卡（cartão corporativo）交易；监控政府采购合同与招标流程。
高级搜索：Processo API支持多条件组合检索，Orientação de Bancada追踪党团投票导向，Distribuição分析法案起草与报告分配模式。
显著优点
- 官方数据源：直接对接参议院基础设施，数据权威性无可比拟
- 双API架构：legis.senado.leg.br（立法）与 adm.senado.gov.br（行政）分离，职责清晰
- 零认证门槛：无需API密钥，完全开放访问
- 多格式支持：JSON/XML可选，Python异步客户端封装完整
- 实时性强：当日议程、最新投票、近期开支均可查询
潜在局限
- 数据深度参差：立法数据详尽，但议员财产申报（declaração de bens）仅限网页端，无API
- 日期格式混乱：不同端点使用YYYYMMDD、YYYYMM或YYYY，需额外处理
- 单条返回陷阱：部分端点单结果时返回字典而非列表，易引发解析错误
- 稳定性波动：偶发500错误，建议实现指数退避重试
- API版本更迭：v1端点已弃用，需持续关注文档变更
适合人群
- 政治学者与立法研究员
- 调查记者与透明监督组织（如Open Knowledge Brasil）
- 数据新闻团队
- 关注巴西政治的公众与智库分析师
常规风险
- 隐私边界：CEAP数据虽公开，但聚合分析可能暴露议员行为模式
- 误读风险：法案状态流转复杂，"tramitando"不代表即将表决
- 语言壁垒：原数据为葡萄牙语，关键术语（如"apartes""requerimentos"）需理解
- 依赖性：政府API服务连续性无SLA保障