Sobre o projeto

Este repositório fornece um exemplo orientado para desenvolvedores de acesso a um ator Apify que expõe os Relatórios de Transações Periódicas do Congresso dos EUA como JSON limpo e estruturado. Ele abrange as divulgações financeiras de ambos a Câmara e o Senado sob a Lei STOCK, normalizando cada transação divulgada em uma linha consistente com detalhes do membro, câmara, estado e distrito, ativo, ticker, tipo de transação, faixa de valor reportado, datas, propriedade e identificadores de arquivamento. O projeto inclui um exemplo em Python usando UV, uma configuração de chave de API do Apify e instruções para usar o ator como uma ferramenta MCP em assistentes como Claude Desktop, Claude Code, Claude web, Cursor e ChatGPT. Os usuários podem filtrar os resultados por nome do membro (primeiro ou último), ticker de ação, data exata ou intervalo de datas, e controlar o tamanho da saída com Max_Results. A saída preserva os brackets de valor reportado exatamente como arquivados, inclui IDs de arquivamento e documento para rastreabilidade e adiciona metadados de pesquisa por execução para trilhas de auditoria. O README também documenta os parâmetros de entrada, campos de saída, códigos de tipo de ativo, tipos de transação, atribuição de propriedade e opções de instalação do MCP. Isso é melhor entendido como um exemplo de acesso e integração de dados para divulgações de negociação do Congresso, em vez de um banco de dados local ou uma estrutura de scraping.