Câmara dos Deputados

Access and search Brazilian Chamber of Deputies data including deputies, bills, votes, committees, agendas, expenses, and legislative statuses via public API...

Security Scan

This skill is internally consistent: it implements a client and CLI for the public Câmara dos Deputados open-data API, requests no secrets, and its files and SKILL.md align with that purpose.

Purpose & Capability

Name/description match the code and SKILL.md. The package provides a Python async client, a CLI script, examples and tests that all operate against the public API (dadosabertos.camara.leg.br). No unrelated credentials, binaries, or services are requested.

Instruction Scope

SKILL.md only instructs making HTTP GET requests to documented public endpoints and gives curl/python examples. It does not ask the agent to read local secrets, system files, or to send data to unknown external endpoints.

Install Mechanism

No install spec is included (instruction-only in registry), and code files are present that rely on standard Python (httpx). Dependencies are minimal and come from PyPI (httpx). No downloads from obscure URLs or archive extraction are present in the manifest.

Credentials

The skill declares no required environment variables, no primary credential, and the runtime code does not attempt to access unrelated env vars or config paths. All network calls target the official chamber API and related public resources (e.g., bulk CEAP JSON).

Persistence & Privilege

The skill does not request permanent/intrusive privileges (always:false). It does not modify other skills or system-wide agent settings. Autonomous invocation is allowed by platform default and is not a red flag here.

Assessment

This skill appears to do exactly what it says: a client and CLI for the Câmara dos Deputados public API that requires no credentials. If you plan to run the code, run it in a virtual environment and install only the listed dependency (httpx). Because the registry source is listed as unknown, you may want to verify the repository origin/author (README references a GitHub user) before trusting it in production. Running the included tests is a good way to validate behavior in your environment. No secrets need to be provided for normal operation.

Câmara dos Deputados — API de Dados Abertos

Base URL: https://dadosabertos.camara.leg.br/api/v2 Docs/Swagger: https://dadosabertos.camara.leg.br/swagger/api.html No authentication required. All endpoints return JSON.

Common query params

• itens — page size (default 15, max 100)
• pagina — page number
• ordem — ASC or DESC
• ordenarPor — field name for sorting

---

Key Endpoints

Deputies (Deputados)

GET /deputados
  ?nome=         # name search
  ?siglaPartido= # party (e.g. PT, PL, MDB)
  ?siglaUf=      # state (e.g. SP, RJ, AM)
  ?idLegislatura=57  # current legislature
  ?ordem=ASC&ordenarPor=nome

GET /deputados/{id}           # full profile
GET /deputados/{id}/discursos # speeches
  ?dataInicio=YYYY-MM-DD&dataFim=YYYY-MM-DD
GET /deputados/{id}/despesas  # CEAP expenses
  ?ano=YYYY&mes=MM
GET /deputados/{id}/frentes   # parliamentary fronts
GET /deputados/{id}/ocupacoes # professional history
GET /deputados/{id}/orgaos    # committee memberships

Bills / Proposições

GET /proposicoes
  ?siglaTipo=PL      # type: PL, PEC, MPV, PDC, PLP, etc.
  ?numero=123
  ?ano=2026
  ?autor=Nome        # author name (partial match)
  ?tema=             # topic id (see /referencias/temas)
  ?keywords=         # keywords
  ?dataApresentacaoInicio=YYYY-MM-DD
  ?dataApresentacaoFim=YYYY-MM-DD
  ?codSituacao=      # status code
  ?tramitacaoSenado=true  # bills currently in Senate
  ?ordem=DESC&ordenarPor=id

GET /proposicoes/{id}             # full detail
GET /proposicoes/{id}/autores     # authorship
GET /proposicoes/{id}/relacionadas# related bills
GET /proposicoes/{id}/temas       # topics
GET /proposicoes/{id}/tramitacoes # full history/status
GET /proposicoes/{id}/votacoes    # votes on this bill

Votações (Voting)

GET /votacoes
  ?dataInicio=YYYY-MM-DD&dataFim=YYYY-MM-DD
  ?idOrgao=180       # 180 = Plenário
  ?siglaPartido=
  ?ordem=DESC&ordenarPor=dataHoraRegistro

GET /votacoes/{id}             # vote detail
GET /votacoes/{id}/votos       # individual votes per deputy
GET /votacoes/{id}/orientacoes # party orientations

Events / Agenda (Eventos)

GET /eventos
  ?dataInicio=YYYY-MM-DD
  ?dataFim=YYYY-MM-DD
  ?siglaOrgao=       # committee sigla or PLEN for plenary
  ?codTipoEvento=    # see /referencias/tiposEvento
  ?codSituacao=      # see /referencias/situacoesEvento
  ?ordem=ASC&ordenarPor=dataHoraInicio

GET /eventos/{id}          # event detail
GET /eventos/{id}/deputados # attending deputies
GET /eventos/{id}/orgaos    # organizing bodies
GET /eventos/{id}/pauta     # agenda items
GET /eventos/{id}/votacoes  # votes in this session

Committees (Órgãos / Comissões)

GET /orgaos
  ?sigla=CCJC        # committee abbreviation
  ?codTipoOrgao=     # type (see /referencias/tiposOrgao)
  ?nome=

GET /orgaos/{id}            # detail
GET /orgaos/{id}/eventos    # committee agenda
GET /orgaos/{id}/membros    # current membership
GET /orgaos/{id}/votacoes   # votes by committee

Parties & Blocs (Partidos / Blocos)

GET /partidos?ordem=ASC&ordenarPor=sigla
GET /partidos/{id}
GET /partidos/{id}/membros

GET /blocos
GET /blocos/{id}

Parliamentary Fronts (Frentes)

GET /frentes
GET /frentes/{id}
GET /frentes/{id}/membros

Working Groups (Grupos de Trabalho)

GET /gruposTrabalho
GET /gruposTrabalho/{id}
GET /gruposTrabalho/{id}/membros

Legislative Sessions (Legislaturas)

GET /legislaturas
GET /legislaturas/{id}
GET /legislaturas/{id}/mesa  # presiding board

Reference Data

GET /referencias/deputados/codSituacao
GET /referencias/proposicoes/codSituacaoProposicao
GET /referencias/proposicoes/siglaTipo
GET /referencias/proposicoes/tema
GET /referencias/tiposEvento
GET /referencias/tiposOrgao
GET /referencias/uf

---

Common Tasks

Today's agenda

DATE=$(date +%Y-%m-%d)
curl "https://dadosabertos.camara.leg.br/api/v2/eventos?dataInicio=$DATE&dataFim=$DATE&ordem=ASC&ordenarPor=dataHoraInicio"

Search bills by keyword

curl "https://dadosabertos.camara.leg.br/api/v2/proposicoes?keywords=transporte+público&ano=2026&ordem=DESC&ordenarPor=id&itens=20"

Find a deputy

curl "https://dadosabertos.camara.leg.br/api/v2/deputados?nome=Marcos+Pontes&idLegislatura=57"

Recent plenary votes

curl "https://dadosabertos.camara.leg.br/api/v2/votacoes?idOrgao=180&dataInicio=2026-03-01&ordem=DESC&ordenarPor=dataHoraRegistro&itens=10"

Bill status / tramitação

curl "https://dadosabertos.camara.leg.br/api/v2/proposicoes/{id}/tramitacoes"

---

Notes

• Legislature 57 = current (started Feb 2023)
• Plenário orgão id = 180
• CEAP data also available as bulk download: https://www.camara.leg.br/cotas/Ano-{ano}.json.zip
• Full API reference: see references/api-endpoints.md for parameter details
• Swagger UI: https://dadosabertos.camara.leg.br/swagger/api.html

---

API Quirks & Tips

• Standard response wrapper: All endpoints return {dados: [...], links: [...]}. The Python client's _get() automatically extracts dados.
• Pagination: Use itens (page size, max 100) and pagina (page number). The Python client's _get_list() auto-paginates — if dados has fewer items than itens, it's the last page.
• Date format: Always ISO format YYYY-MM-DD (unlike Senado which uses YYYYMMDD).
• Legislature 57: Current legislature (2023-2027). Most endpoints default to current if not specified.
• Plenário ID: orgão id = 180 for plenary hall.
• tramitacaoSenado: Use ?tramitacaoSenado=true on proposições endpoint to find bills currently being reviewed by the Senate.
• CEAP bulk data: Deputy expenses also available as bulk download at https://www.camara.leg.br/cotas/Ano-{ano}.json.zip.

---

Python Client (async)

You can use the async Python client for programmatic access:

import asyncio
from camara_client import get_camara_client

async def main():
    client = get_camara_client()
    
    # Listar deputados
    deps = await client.lista_deputados()
    
    # Buscar por nome
    resultado = await client.buscar_deputado_por_nome("Lula")
    
    # Pesquisar proposições
    props = await client.pesquisar_proposicoes(keywords="transporte", ano=2026)
    
    # Eventos de hoje
    from datetime import date
    eventos = await client.get_eventos_dia(date.today())
    
    await client.close()

asyncio.run(main())

Available Methods

Deputados:

• lista_deputados(legislatura) — List deputies
• buscar_deputado_por_nome(nome, legislatura) — Search by name
• get_deputado_detalhe(id) — Full profile
• get_despesas_deputado(id, ano) — CEAP expenses
• get_frentes_deputado(id) — Parliamentary fronts
• get_discursos_deputado(id, data_inicio, data_fim) — Speeches
• get_presenca_deputado(id, data_inicio, data_fim) — Attendance
• get_deputado_orgaos(id) — Committee memberships
• get_deputado_ocupacoes(id) — Professional history

Proposições:

• pesquisar_proposicoes(keywords, sigla_tipo, numero, ano, autor, tramitando, tema, tramitacao_senado) — Search bills
• get_proposicao_detalhe(id) — Full detail
• get_proposicao_tramitacao(id) — Status history
• get_proposicao_votacoes(id) — Votes on bill
• get_proposicao_autores(id) — Authors
• get_proposicao_temas(id) — Topics/tags
• get_proposicao_relacionadas(id) — Related bills

Eventos:

• get_eventos_dia(data) — Day agenda
• get_eventos_periodo(data_inicio, data_fim) — Events in period
• get_evento_detalhe(id) — Event detail
• get_evento_deputados(id) — Deputies in event
• get_evento_orgaos(id) — Organizing bodies
• get_evento_votacoes(id) — Votes in event

Votações:

• get_votacoes_periodo(data_inicio, data_fim, id_orgao) — Votes in period
• get_votacao_detalhe(id) — Vote detail
• get_votos_votacao(id) — Individual votes
• get_orientacoes_votacao(id) — Party orientations

Órgãos/Comissões:

• lista_orgaos() — List committees
• get_orgao_detalhe(id) — Committee detail
• get_eventos_orgao_periodo(id, data_inicio, data_fim) — Committee agenda
• get_membros_orgao(id) — Current members
• get_orgao_membros_periodo(id, data_inicio, data_fim) — Members in period
• get_votacoes_orgao(id, data_inicio, data_fim) — Committee votes

Legislaturas:

• lista_legislaturas() — List legislatures
• get_legislatura_detalhe(id) — Legislature detail
• get_legislatura_mesa(id) — Presiding board

Partidos:

• lista_partidos() — List parties
• get_partido_detalhe(id) — Party detail
• get_partido_membros(id) — Party members

Blocos:

• lista_blocos() — List parliamentary blocs
• get_bloco_detalhe(id) — Bloc detail

Frentes:

• lista_frentes(id_legislatura) — List parliamentary fronts
• get_frente_detalhe(id) — Front detail
• get_frente_membros(id) — Front members

Referências:

• get_referencias_situacao_deputado() — Deputy status codes
• get_referencias_situacao_proposicao() — Bill status codes
• get_referencias_tipo_proposicao() — Bill type codes (PL, PEC, etc)
• get_referencias_temas() — Topic/theme list
• get_referencias_tipos_evento() — Event types
• get_referencias_tipos_orgao() — Committee types
• get_referencias_uf() — Brazilian states

Utilitários:

• get_proposicoes_recentes(dias) — Recent bills
• get_votacoes_semana() — This week's votes
• get_eventos_semana() — This week's events
• get_pauta_evento(id) — Event agenda items

Requires: pip install httpx