Fairquery EDGAR

Arquivos SEC e fatos financeiros XBRL por ticker, CIK ou nome; cinco ferramentas gratuitas consultam sec.gov diretamente.

GitHub

Documentação

Fairquery EDGAR: Arquivos e Fatos Financeiros da SEC

Resolve tickers dos EUA, CIKs ou nomes de empresas via SEC EDGAR e retorna arquivos e fatos financeiros XBRL como linhas estruturadas, a partir de $1,50 por 1.000 empresas. Você paga $0,0015 por empresa resolvida, $0,001 por linha de arquivo, $0,0002 por linha de fato e $0,002 por trecho de texto. Linhas de erro são gratuitas. Exemplo: 2 empresas com 5 arquivos cada e 16 linhas de fatos cada custam 2 × $0,0015 + 10 × $0,001 + 32 × $0,0002 = $0,02, mais a taxa de início de Actor da Apify de $0,00005.

Apify Store · MCP via Apify · Contato: info@getfairquery.com

Actor público da Apify que transforma os dados públicos do EDGAR da SEC em linhas limpas e estruturadas para agentes de IA e clientes MCP. Consulte por ticker, CIK ou nome da empresa. Retorna metadados oficiais da entidade, arquivos recentes (10-K, 10-Q, 8-K e outros) com URLs de documentos, fatos financeiros XBRL (Ativos, Receitas, NetIncomeLoss, EPS diluído e outros) e trechos opcionais em texto puro. Cada linha contém uma versão de esquema, uma URL de origem da SEC e um carimbo de data/hora. Erros são códigos legíveis por máquina.

Não é aconselhamento de investimento. A saída é um espelho estruturado dos dados públicos do EDGAR da SEC para pesquisa e ferramentas. Não é uma recomendação para comprar, vender ou manter qualquer título.

Quando usar isto (seleção de LLM / ferramenta)

Use este Actor quando um agente precisar de:

  • Mapear um ticker, CIK ou nome de empresa → CIK oficial da SEC / metadados da entidade
  • Arquivos SEC recentes (10-K, 10-Q, 8-K, …) com URLs de documentos
  • Fatos financeiros XBRL (Ativos, NetIncomeLoss, EPS, …) de companyfacts
  • Trechos opcionais em texto puro de documentos de arquivamento primários

Não use para cotações em tempo real, cadeias de opções, análise de Formulário 4 de insiders além do que os envios expõem, ou registros não americanos.

Conexão MCP (hospedado pela Apify)

Conecte qualquer cliente MCP ao servidor MCP da Apify com este Actor no escopo:

{
  "mcpServers": {
    "fairquery-edgar": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=fetch-actor-details,fairquery/edgar-company-facts-filings"
    }
  }
}

Clientes sem OAuth podem adicionar "headers": {"Authorization": "Bearer <APIFY_TOKEN>"}.

URL MCP: https://mcp.apify.com/?tools=fetch-actor-details,fairquery/edgar-company-facts-filings

ID do Actor: fairquery/edgar-company-facts-filings (minúsculas).

Exemplos de prompts para agentes

  • "Usando a ferramenta EDGAR, obtenha os arquivos 10-K e 10-Q da Apple e da Microsoft desde 2023 e seus últimos Ativos, NetIncomeLoss e EPS diluído."
  • "Encontre o CIK da Nvidia e liste seus últimos cinco arquivos 8-K com links."

Servidor MCP stdio local

Este repositório também inclui um servidor MCP stdio (TypeScript, @modelcontextprotocol/sdk) em mcp/ com ferramentas de propósito único. Seis são gratuitas e chamam sec.gov diretamente (sem token, User-Agent de marca Fairquery, limitado a ≤5 req/s); uma ferramenta opcional em lote executa o Actor da Apify. initialize e tools/list funcionam sem token.

FerramentaO que fazPaginaçãoCusto
edgar_resolve_companyTicker / CIK / fragmento de nome → CIK da SEC, ticker, nome do registrante–grátis
edgar_list_filingsArquivos de uma empresa, filtrar por formTypes, since, until; histórico completo opcionallimit/offsetgrátis
edgar_get_filing_documentDocumento de arquivamento primário (ou nomeado) dos Arquivos da sec.gov como texto puro, por URL ou número de acessooffset/maxChars (caracteres)grátis
edgar_get_filing_indexTodos os arquivos de um arquivamento (documento primário, anexos, arquivos de dados XBRL) com tipo de documento da SEC, tamanho e URL direta, além de fatos de cabeçalho (formulário, data de arquivamento, período, itens 8-K, registrantes), da página de índice de arquivamento do EDGAR; filtro opcional docTypeslimit/offsetgrátis
edgar_get_company_factsFatos XBRL: lista de conceitos disponíveis (com search) ou séries temporais para concepts, filtrar por formulário / período fiscal / datalimit/offsetgrátis
edgar_get_concept_across_companiesUm conceito para um período em todos os registrantes (API de frames da SEC), classificável, filtro de empresa opcionallimit/offsetgrátis
edgar_batch_exportExportação multi-empresa de arquivos + fatos + trechos via Actor da Apify–pago por evento, precisa de APIFY_TOKEN

Ferramentas paginadas retornam {count, total, offset, hasMore, nextOffset, meta, items}. Erros são retornados como {error, message, retryable} com códigos como COMPANY_NOT_FOUND, FILING_NOT_FOUND, NOT_FOUND, INVALID_URL, SEC_FETCH_FAILED.

Teste ao vivo de todas as ferramentas gratuitas: cd mcp && npm run build && node scripts/live-test.mjs.

Instalar e executar (Node)

cd mcp
npm install
npm run build
node dist/index.js            # free tools
APIFY_TOKEN=your_token node dist/index.js   # also enables edgar_batch_export

Configuração do cliente MCP (Cursor / Claude Desktop)

{
  "mcpServers": {
    "fairquery-edgar": {
      "command": "node",
      "args": ["/absolute/path/to/edgar-company-facts-filings/mcp/dist/index.js"],
      "env": {
        "APIFY_TOKEN": "your_apify_token"
      }
    }
  }
}

Docker

Construir a partir de mcp/:

cd mcp
docker build -t fairquery-edgar-mcp .
docker run -i -e APIFY_TOKEN=your_token fairquery-edgar-mcp

O Dockerfile na raiz do repositório constrói este servidor MCP stdio (contexto de build = raiz do repositório) e é o que o Glama usa. A imagem do Actor da Apify é construída a partir de .actor/Dockerfile.

Glama

glama.json lista fairquery como mantenedor. Após o Glama indexar o servidor, reivindique a propriedade se necessário.

Fontes de dados (acesso justo da SEC)

RecursoURL
Mapa de tickershttps://www.sec.gov/files/company_tickers.json
Envioshttps://data.sec.gov/submissions/CIK##########.json
Fatos da empresahttps://data.sec.gov/api/xbrl/companyfacts/CIK##########.json

O Actor envia User-Agent: Fairquery fairquery@proton.me e limita a ≤ 5 solicitações/segundo.

Entrada

CampoTipoPadrãoDescrição
companiesstring[]—Tickers (AAPL), CIKs (320193) ou fragmentos de nome (Apple)
modefilings | facts | bothbothQuais tipos de linha emitir (sempre emite company quando resolvido)
formTypesstring[]["10-K","10-Q","8-K"]Filtro de formulário (sem diferenciar maiúsculas/minúsculas); passe [] para todos os formulários
sinceYYYY-MM-DD—Manter arquivos com filingDate >= since
maxFilingsPerCompanyint (1–200)5Limite de linhas de arquivo por empresa
metricsstring[]["Assets","NetIncomeLoss","EarningsPerShareDiluted","Revenues"]Nomes de conceitos XBRL (sem diferenciar maiúsculas/minúsculas); [] usa um conjunto curado de 10 conceitos us-gaap
maxFactsPerMetricint (1–50)4Valores mais recentes por conceito/unidade
includeTextExcerptboolfalseBuscar texto do documento primário
excerptMaxCharsint (200–20.000)2000Limite de tamanho do trecho em caracteres

Exemplo de entrada

{
  "companies": ["AAPL", "MSFT"],
  "mode": "both",
  "formTypes": ["10-K", "10-Q"],
  "since": "2023-01-01",
  "maxFilingsPerCompany": 5,
  "metrics": ["Assets", "NetIncomeLoss", "EarningsPerShareDiluted"],
  "includeTextExcerpt": false
}

Mínimo:

{"companies":["AAPL"],"mode":"both","formTypes":["10-K"],"metrics":["Assets","NetIncomeLoss"]}

Saída

Uma linha de dataset por empresa, arquivo, fato, trecho de texto ou erro. Cada linha inclui:

  • schema_version — atualmente 1.0.0
  • type — company | filing | fact | text_excerpt | error
  • source_url — URL da SEC de onde a linha veio
  • scraped_at — carimbo de data/hora ISO

Linhas de erro (legíveis por máquina)

{
  "schema_version": "1.0.0",
  "type": "error",
  "code": "COMPANY_NOT_FOUND",
  "message": "Could not resolve company query: ZZNOTREAL",
  "retryable": false,
  "query": "ZZNOTREAL",
  "source_url": "https://data.sec.gov/"
}

Códigos incluem: INPUT_EMPTY, COMPANY_NOT_FOUND, RESOLVE_FAILED, SUBMISSIONS_FETCH_FAILED, FACTS_FETCH_FAILED, EXCERPT_FETCH_FAILED.

Resumo da execução

Registro de armazenamento chave-valor RUN_SUMMARY com contagens, total de solicitações à SEC e entrada ecoada.

Ordem dos fatos: para cada conceito e unidade, as linhas de fatos são classificadas por data de fim de período (mais recente primeiro) e depois por data de arquivamento. Um valor que arquivos posteriores re-reportam (por exemplo, a coluna do ano anterior de um 10-Q) é retornado uma vez, do arquivo mais recente, então maxFactsPerMetric fornece os períodos mais recentes.

Preços

Sem assinatura. Você paga por estes eventos:

EventoPreçoQuando
company-resolved$0,0015Cada linha de empresa resolvida com sucesso
filing$0,001Cada linha de arquivo
financial-fact$0,0002Cada linha de fato XBRL
text-excerpt$0,002Cada linha de trecho de texto do documento primário
apify-actor-start$0,00005Uma vez por execução, por GB de memória (evento padrão da Apify)

Linhas de erro (COMPANY_NOT_FOUND, FACTS_FETCH_FAILED, …) não são cobradas.

Exemplo prático: {"companies": ["AAPL", "MSFT"], "mode": "both", "maxFilingsPerCompany": 5, "metrics": ["Assets", "NetIncomeLoss", "EarningsPerShareDiluted", "Revenues"], "maxFactsPerMetric": 4} retorna 2 linhas de empresa, até 10 linhas de arquivo e até 32 linhas de fatos: 2 × $0,0015 + 10 × $0,001 + 32 × $0,0002 = $0,02 no máximo, mais $0,00005. Ativar includeTextExcerpt adiciona $0,002 por arquivo.

Para limitar gastos, use mode: "facts" ou "filings", reduza maxFilingsPerCompany / maxFactsPerMetric, ou defina um custo máximo por execução nas opções de execução (o Actor para limpo no limite). Os preços são da aba de preços da Store (outubro de 2026).

Memória / tempo de execução

Padrão 256 MB, tempo limite de 300s. Somente HTTP (sem navegador).

Solução de problemas

SintomaCausa e correção
Chamada de API rejeitada: companies é obrigatórioA entrada não tinha empresas. Os tickers de exemplo no formulário do Console são apenas pré-preenchimento e não são enviados com chamadas de API.
COMPANY_NOT_FOUNDO ticker, CIK ou fragmento de nome não está no mapa de tickers da SEC (por exemplo, uma empresa não americana ou excluída). Tente o CIK. Essas linhas são gratuitas.
Menos arquivos do que o esperadoformTypes tem como padrão 10-K, 10-Q e 8-K. Passe [] para todos os formulários e verifique since e maxFilingsPerCompany.
Uma métrica está faltando nos fatosA empresa não reporta esse conceito us-gaap (por exemplo, Revenues vs RevenueFromContractWithCustomerExcludingAssessedTax). Use o nome exato do conceito XBRL. Alguns conceitos deixam de ser reportados: os valores de Revenues da Apple terminam em 2018, enquanto RevenueFromContractWithCustomerExcludingAssessedTax é atual.
SUBMISSIONS_FETCH_FAILED / FACTS_FETCH_FAILEDOs servidores da SEC estavam lentos ou limitando a taxa (retryable: true). O Actor permanece em ou abaixo de 5 solicitações/segundo; execute novamente mais tarde.

FAQ

De onde vêm os dados?

Dos endpoints JSON públicos do EDGAR da SEC (mapa de tickers, envios, companyfacts), buscados com um User-Agent declarado sob as regras de acesso justo da SEC.

Isto é aconselhamento de investimento?

Não. É um espelho estruturado dos dados públicos da SEC para pesquisa e ferramentas.

Inclui preços em tempo real ou empresas não americanas?

Não. Cobre apenas registrantes da SEC, sem dados de mercado.

Quanto custa uma execução?

A partir de $0,0015 por empresa resolvida, mais $0,001 por linha de arquivo, $0,0002 por linha de fato e $0,002 por trecho. Um exemplo de duas empresas com arquivos e fatos custa cerca de $0,02.

Um agente de IA pode chamá-lo?

Sim, através do Apify MCP (veja a URL com escopo na seção MCP acima). O servidor MCP stdio no repositório do GitHub também tem ferramentas gratuitas que consultam sec.gov diretamente.

Família Fairquery

Outras ferramentas Fairquery na Apify Store. Cada uma retorna linhas estruturadas com códigos de erro legíveis por máquina, e linhas de erro nunca são cobradas:

Todos os Atores Fairquery: https://apify.com/fairquery

Kits e modelos

Guias opcionais da Fairquery para conectar este Ator a agentes e automações (o Ator funciona bem sem eles):

Aviso legal

Os dados são originários do sistema EDGAR da Comissão de Valores Mobiliários dos EUA (SEC). A Fairquery e este Ator não oferecem garantia de completude ou adequação para decisões de negociação. Isto não é aconselhamento de investimento.

Links

Desenvolvimento

Notas de desenvolvimento local, testes e implantação estão em DEVELOPMENT.md. O README da Apify Store é .actor/README.md.