Senado Federal

核心功能

Senado Federal API 提供巴西联邦参议院全面的立法数据开放接口，分为两大系统：LEGIS（立法活动）和 ADM（行政透明度）。LEGIS 覆盖议员信息、法案追踪、议程投票、委员会事务等完整立法流程；ADM 专注财政透明度，包括议员办公经费（CEAP）、住房补贴、政府合同、公务员薪酬及企业卡消费记录。

显著优点

• 官方权威: 直接源自巴西联邦参议院 legis.senado.leg.br 和 adm.senado.gov.br，数据实时性与准确性最高
• 功能完备: 支持60+类查询场景，从法案全文到议员学术履历，从当日议程到历年投票记录
• 无需认证: 完全开放访问，降低使用门槛
• 双格式支持: JSON/XML 可选，便于不同技术栈集成
• 财政透明: ADM 系统提供罕见的政府支出细颗粒度数据，包括CEAP逐项、合同全链条、公务员薪酬等

潜在局限

• 数据嵌套深: 响应结构复杂（3-4层嵌套），需额外解析处理
• 日期格式不统一: 不同端点使用 YYYYMMDD、YYYYMM 或 YYYY，易混淆
• API版本混杂: v1 端点已废弃但仍在文档中，需留意 /processo 等新推荐路径
• 稳定性波动: 偶发500错误，建议实现指数退避重试
• 单条/列表返回不一致: 单结果时可能返回对象而非数组

适用人群

• 政治研究者与学者：分析立法行为、投票模式、党派动态
• 记者与调查机构：追踪特定法案进展、挖掘财政支出异常
• 公民社会组织：监督议员履职、推进政府透明度
• 数据科学家：巴西政治数据集构建、选举研究
• 开发者：政务信息应用、新闻自动化、政策追踪工具

常规风险提示

• 数据解读需专业知识: 巴西立法程序复杂（如"regime de urgência"、"tramitação conclusiva"），误解流程状态可能导致错误分析
• 隐私边界: ADM 数据虽公开，但涉及个人住址、完整CPF等敏感信息，使用需符合巴西数据保护法（LGPD）
• 时效性差异: 立法数据通常实时，但财政数据可能有月度延迟
• 政治敏感性: 财政透明度数据常用于政治监督，使用场景可能引发争议

核心用法

该 Skill 是一套完整的巴西联邦参议院（Senado Federal）开放数据 API 客户端，支持两大官方数据源：立法数据 API（legis.senado.leg.br）和行政透明数据 API（adm.senado.gov.br）。用户可通过自然语言指令查询议员信息、法案状态、投票记录、委员会日程、演讲记录、总统否决案等立法活动，同时可深入调查议会开支（CEAP）、住房补贴、公务卡消费、合同招标等财政透明度数据。

API 采用 RESTful 设计，无需认证即可访问，支持 JSON 和 XML 格式返回。Python 客户端封装了 80+ 个方法，涵盖同步/异步请求、自动重试、深度嵌套 JSON 解析等实用功能，极大降低了政府数据获取的技术门槛。

显著优点

数据权威性：直接对接巴西联邦参议院官方 API，数据实时、准确、完整，涵盖立法流程全生命周期。

功能全面性：从议员档案（学历、职业、党派变迁、委员会任职）到法案追踪（提案、修订、表决、生效状态），再到财政透明（CEAP 明细、合同招标、公务支出），形成政务数据闭环。

技术成熟度：代码结构清晰，采用类型提示、异步 IO、指数退避重试等现代 Python 实践；文档详尽，包含大量 CLI 示例和 API quirks 说明。

透明度价值：为研究者、记者、公民社会提供监督政府的重要工具，特别强化了议会开支和合同招标的可追溯性。

潜在缺点与局限性

地域限制：数据仅限于巴西联邦参议院，不涉及众议院（Câmara dos Deputados）或其他层级政府，完整国会分析需配合其他数据源。

API 稳定性：官方服务偶发 500 错误或响应延迟，虽已内置重试机制，但高频调用仍可能受影响。

数据一致性：API v1 部分端点已于 2025 年弃用，日期格式在不同端点存在差异（YYYYMMDD vs YYYY），需开发者注意兼容处理。

语言门槛：原始数据以葡萄牙语返回，非葡语用户需额外翻译处理。

适合的目标群体

• 学术研究者：政治学、公共管理、立法行为研究领域
• 调查记者：监督报道、数据新闻、政治人物背景调查
• NGO 与公民组织：政府透明度倡导、政策倡导
• 数据分析师：巴西政治风险研究、ESG 评级中的政府治理维度
• 法律从业者：追踪特定法案进展、判例研究

使用风险

性能风险：政府 API 无 SLA 保障，高峰时段（如重要表决日）可能出现服务降级。

依赖风险：核心依赖 httpx 库，虽当前无已知 CVE，但需关注版本更新。

合规风险：数据虽公开，但大规模爬取或商业用途需遵守巴西《信息访问法》（LAI）及 API 使用条款。

维护风险：项目为个人开发者维护（T3 级别），长期更新承诺需自行评估。