核心用途
Senado Federal技能提供对巴西联邦参议院（Senado Federal）官方开放数据API的完整访问能力，是拉丁美洲最具权威性的议会透明度数据源之一。该技能覆盖立法全流程监控，包括：议员档案查询（履历、党派归属、学术背景、委员会职务）、法案追踪（PL/PEC/PLS等类型的提案检索、状态监控、文本获取）、议程管理（全体会议及委员会日程、iCal订阅）、投票分析（记名投票记录、党团取向、委员会表决）、以及总统否决追踪等高级功能。
显著优势
数据权威性：直连 legis.senado.leg.br/dadosabertos 官方域名，数据由参议院信息技术局维护，法律效力等同于官方公报。 功能全面性：API v2体系支持50+端点，涵盖从议员个人履历（senador/{codigo}/historicoAcademico.json）到复杂流程检索（/processo高级搜索）的全谱系需求。 零门槛接入：无需API密钥或OAuth认证，直接附加 .json 或 .xml 后缀即可获取结构化数据。 实时性保障：支持当日议程查询（plenario/agenda/dia/{data}）、最近N天更新追踪（materia/atualizadas?numdias=7）等时效性操作。
主要局限
数据边界明确：财政透明度数据（CEAP津贴、资产申报、薪酬）被排除在开放API之外，需前往独立门户手工下载CSV。 稳定性风险：文档标注"API can be slow or return 500s"，建议实现指数退避重试机制。 版本碎片化：部分v1端点（如 /materia/{sigla}/{numero}/{ano}）已于2025年弃用，但文档中仍可见遗留引用。 语言单一性：仅葡萄牙语返回，对国际用户存在门槛。 嵌套结构复杂：响应体常深嵌3-4层（如 ListaParlamentarEmExercicio.Parlamamentares.Parlamamentar），需防御性解析单对象/列表混合格式。
适用人群
- 政治学者与议会研究员：需批量分析投票模式、法案共同提案网络
- 调查记者：追踪特定议员的全流程立法参与（提案→报告→表决）
- 公民社会组织：监控议程设置、委员会决策透明度
- 政府事务顾问：实时掌握立法动态、党团取向变化
- 开发者：构建议会监控仪表板、自动化立法预警系统
常规风险提示
- 服务可用性：500错误率偏高，生产环境必须配置重试逻辑
- 数据时效延迟："实时"议程可能存在数小时同步延迟
- 弃用端点陷阱：避免使用2025年后弃用的v1短路径
- 隐私合规：虽为公开数据，大规模爬取议员履历需关注LGPD（巴西通用数据保护法）合规边界