Edgrapi — SEC EDGAR Financials

Dados financeiros limpos da SEC EDGAR, índices, arquivamentos e seções 10-K/10-Q como JSON normalizado — um servidor MCP hospedado com 5 ferramentas e um nível gratuito.

GitHubExperimente este MCPPatrocinado

Documentação

edgrapi-skills

A API de Dados Governamentais dos EUA para agentes. Um servidor MCP hospedado que fornece dados oficiais do governo dos EUA como JSON limpo em uma única chave: arquivamentos SEC EDGAR (negociações de insiders, 8-Ks, participações 13F, participações 13D/G, fundamentos, índices), oportunidades de contratos SAM.gov, prêmios USAspending, subsídios Grants.gov e negociações de ações de congressistas — através da API Edgrapi. Além de habilidades Python prontas para o fluxo de trabalho financeiro da SEC.

Os dados oficiais são gratuitos, mas cada fonte traz sua própria dor de cabeça — variação de tags XBRL, linguagens de consulta específicas de agências, status separados por pipe, faixas de valores. A Edgrapi normaliza tudo em um único esquema JSON limpo, para que seu agente obtenha números confiáveis em uma única chamada.

Comece gratuitamente — obtenha uma chave (100 créditos gratuitos todo mês, sem necessidade de cartão) e você estará puxando dados do Claude, ChatGPT, Cursor ou seu próprio loop de agente em menos de dois minutos.

O servidor MCP hospedado expõe o conjunto completo de ferramentas, incluindo os endpoints de dados governamentais (get_opportunities, get_awards, get_grants, get_congress). As habilidades Python empacotadas skills/ abaixo cobrem o fluxo de trabalho de finanças de empresas da SEC; use o servidor MCP para todo o resto.

Biblioteca padrão Python pura. Sem dependências. Licença MIT-0.

Instalação

# Claude Code, Cursor, Cline, etc. — `skills` CLI, installs straight from this repo
npx skills add paperandbeyond23-gif/edgrapi-skills --all
# or pick one: npx skills add paperandbeyond23-gif/edgrapi-skills --skill edgrapi-full

# OpenClaw / ClawHub — published to the ClawHub registry
npx clawhub@latest install edgrapi-full   # also: edgrapi-fundamentals, edgrapi-filings

Use como servidor MCP

As habilidades acima são uma forma de acesso. A outra é o servidor MCP hospedado — aponte qualquer cliente MCP para uma única URL, sem nada para instalar e sem processo local:

{
  "mcpServers": {
    "edgrapi": {
      "url": "https://api.edgrapi.com/mcp",
      "headers": { "Authorization": "Bearer edgr_YOUR_KEY" }
    }
  }
}

Funciona no Claude Desktop, Claude Code, Cursor e Cline. O transporte é streamable-http. A autenticação é Authorization: Bearer edgr_..., ou OAuth 2.1 — o servidor é seu próprio provedor. A descoberta (initialize, tools/list) é aberta, para que você possa inspecionar a lista de ferramentas sem chave; tools/call precisa de uma.

A superfície MCP é mais ampla do que as habilidades neste repositório: além de fundamentos e arquivamentos, cobre negociações de insiders do Formulário 4 com detecção de compras em cluster, eventos materiais 8-K tipados, participações de fundos 13F comparadas trimestre a trimestre, participações ativistas 13D/13G >5%, XBRL para JSON, ações em circulação, resolução de entidades e busca em texto completo em todos os arquivamentos desde 2001. Para a lista atualizada, chame tools/list ou leia o cartão do servidor — ambos são gerados a partir do próprio servidor, então nenhum fica desatualizado.

Habilidades neste repositório

Habilidade	Propósito
`edgrapi-full`	Kit completo — fundamentos, índices, perfil da empresa e arquivamentos
`edgrapi-fundamentals`	Demonstrações financeiras normalizadas + índices calculados
`edgrapi-filings`	Perfis de empresas + arquivamentos recentes na SEC (10-K/10-Q/8-K)

Instale o edgrapi-full incluído para agentes que precisam de ampla cobertura. Instale as variantes focadas quando quiser uma superfície mínima de ferramentas.

Ferramentas

Ferramenta	Retorna
`get_fundamentals(ticker, period, limit)`	Demonstração de resultados, balanço patrimonial, fluxo de caixa — periodizados, em USD
`get_ratios(ticker)`	Margens, retornos (ROE/ROA), alavancagem, liquidez
`get_company(ticker)`	CIK, nome legal, indústria SIC, fim do ano fiscal, bolsas, site
`get_filings(ticker, limit, form)`	Arquivamentos recentes com datas de arquivamento/relatório e links de documentos

Autenticação

Defina a variável de ambiente EDGRAPI_KEY com sua chave Edgrapi (formato edgr_...). Ela é enviada como cabeçalho X-API-Key — a URL base é fixa, então a chave nunca chega a outro host.

export EDGRAPI_KEY="edgr_..."

Obtenha uma chave gratuita — 100 créditos gratuitos todo mês, sem necessidade de cartão. A mesma chave funciona para estas habilidades e chamadas REST diretas.

Preços

Os créditos são ponderados por endpoint, não um por solicitação: empresa, arquivamentos, eventos, resolução de entidades e busca em texto completo custam 1; fundamentos, índices e XBRL custam 3; seções, insider, participações e ativista custam 5. Os créditos nunca expiram. Todos os dados são do EDGAR público da SEC.

Plano	Preço	Créditos
Gratuito	$0	100 / mês
Inicial	$10/mês	10.000 / mês
Pro (mensal)	$29/mês	30.000 / mês
Pro (anual)	$290/ano	360.000 antecipados

Pacotes adicionais (únicos, nunca expiram): 5.000 / $7 · 15.000 / $18 · 50.000 / $55.

Gerencie planos em https://edgrapi.com/pricing. Também disponível com medição na RapidAPI.

Fonte

Documentação: https://edgrapi.com/docs · OpenAPI: https://edgrapi.com/openapi.json
Início rápido: obtenha uma chave em https://edgrapi.com/app, depois chame qualquer ferramenta

Problemas e contribuições

Veja CONTRIBUTING.md. Relatórios de segurança: SECURITY.md.

Licença

MIT No Attribution. Faça fork, envie, sublicencie — sem atribuição necessária.

Independência

A Edgrapi é um serviço independente e não é afiliada, endossada ou patrocinada pela Comissão de Valores Mobiliários dos EUA (SEC). Todos os dados são originários do sistema público EDGAR da SEC. "EDGAR" é um sistema operado pela SEC dos EUA.