Docs
Documentação
do DataX PIRANOT.
O que é o DataX PIRANOT, para quem serve, as três portas de acesso e o compromisso de qualidade.
O DataX é a marca de dados do PIRANOT, portal nacional com audiência massiva em Piracicaba. Ele coleta dados de fontes oficiais uma única vez, guarda cada corte com data e hash, aplica métodos publicados e serve o resultado em páginas, gráficos, API e MCP, sempre com a fonte ao lado do número.
Para quem
- Profissionais e empresas que precisam do dado pronto e atualizado: contadores e RH, advogados, assessorias e mandatos, imobiliárias, postos e concessionárias, imprensa e desenvolvedores.
- Agentes de IA e assistentes, que já consultam o PIRANOT e passam a ter acesso estruturado e citável.
- Leitores, que usam as calculadoras e as histórias sem cadastro.
As três portas
- Site
- Páginas de dados, histórias e ferramentas em piranot.com.br/datax.
- API v1
- REST com JSON, chave por cabeçalho X-Api-Key. Cobrança por uso: cota gratuita mensal de 3.000 operações no lançamento (1.000 por mês depois), limite de 60 operações por minuto e créditos pré-pagos quando a cota acaba; cada chamada à API ou ao MCP custa 1 operação. Sem cota e sem saldo, a resposta é 402 com o link de recarga. Documentação em /api/docs.
- MCP
- Servidor Model Context Protocol em https://www.piranot.com.br/datax/mcp (Streamable HTTP, protocolo 2025-06-18) com as ferramentas catalogo, consultar (todos os datasets do catálogo), serie e verificar. Mesma chave da API.
Como garantimos qualidade
- Coleta uma vez, serve sempre: a API e as páginas leem só do estado gravado; uma consulta de cliente nunca dispara requisição à fonte.
- Cadência igual à da publicação oficial, com orçamento de requisições declarado por coletor e identificação no User-Agent.
- Checks antes de publicar: falha vira quarentena e a última versão boa continua no ar; toda resposta informa a data do dado e a da coleta.
- Métodos só publicados e citáveis (IBGE, IPEA, BCB, DIEESE, Census Bureau, artigos revisados, bibliotecas científicas). Nenhuma fórmula própria.
- Erro reportado gera recheque na fonte e, se procedente, correção pública em /erratas.
Aviso. O DataX PIRANOT organiza dados de fontes oficiais e pode conter erros ou atrasos. Confira na fonte oficial, indicada em cada dado, antes de qualquer decisão importante. Respostas geradas por IA podem errar.DataX PIRANOT organises data from official sources and may contain errors or delays. Check the official source, linked with each dataset, before any important decision. AI-generated answers can be wrong.