Deterministic Data APIs (punctual_alghoza na Apify Store)

APIs de Dados Determinísticos (punctual_alghoza na Apify Store)

Uma família de pequenos Atores determinísticos, que falham de forma segura, para transformação de arquivos e conjuntos de dados. Sem LLM no caminho de conversão; moeda Decimal exata; cada Ator verifica seu trabalho ou se recusa. Use estes quando o usuário precisar de resultados verificáveis e repetíveis — não de geração probabilística.

Quando usar cada Ator

Necessidade	Ator (slug da loja)	Preço por evento
Deduplicar / normalizar moeda+datas / remover PII em CSV ou JSON bagunçado	punctual_alghoza/dataset-cleaner	$0,30 / conjunto de dados
Verificar + normalizar exportações financeiras (CSV com mapeamento, OFX, QIF)	punctual_alghoza/financial-file-normalizer	$0,25 / arquivo
Analisar My Clippings.txt do Kindle em JSON deduplicado	punctual_alghoza/kindle-clippings-parser	$0,20 / arquivo
Normalizar relatórios de vendas do eBay em um razão verificado	punctual_alghoza/marketplace-sales-normalizer	$0,30 / arquivo
Escanear exportações em busca de segredos/PII vazados, obter cópia limpa	punctual_alghoza/export-secrets-scanner	$0,30 / varredura
Comparar duas exportações (o que foi adicionado/removido/alterado, deltas exatos)	punctual_alghoza/export-diff	$0,20 / diff
Construir pacote de procedência com assinatura SHA-256 para um item de revenda	punctual_alghoza/provenance-packet	$0,25 / pacote
Normalizar exportações de criptomoedas Coinbase/Kraken em um razão verificado	punctual_alghoza/crypto-export-normalizer	$0,25 / arquivo

Como chamar (MCP ou API do Apify)

1. search-actors com o nome da plataforma ou produto (ex.: "dataset-cleaner", "exportação cripto", "kindle") — não frases de objetivo.
2. fetch-actor-details para obter o esquema de entrada + README + preços.
3. call-actor com entrada JSON. Sempre passe limites de custo em callOptions: maxTotalChargeUsd (limite de gasto por execução) e timeout. Exemplo: callOptions: {maxTotalChargeUsd: 0.5, timeout: 120}.
4. Os resultados são itens do conjunto de dados — leia-os através do conjunto de dados padrão da execução.

Contratos de entrada (concisos)

• dataset-cleaner: {"content": "<texto csv/json>", "format": "csv"|"json", "money_columns": "preço,quantia", "date_columns": "data", "scrub": true} (colunas de moeda/data opcionais; auto-detectadas e relatadas caso contrário)
• financial-file-normalizer: {"content": "...", "format": "csv", "csv_mapping": {"date": "Data", "amount": "Quantia"}, "csv_currency": "USD"} — CSV requer um mapeamento explícito; nunca é adivinhado.
• kindle-clippings-parser: {"content": "<My Clippings.txt>"}
• marketplace-sales-normalizer: {"content": "<csv>", "platform": "ebay"}
• export-secrets-scanner: {"content": "<csv/json>"} — retorna achados, conteúdo limpo, SHA-256 original/limpo.
• export-diff: {"before": "...", "after": "...", "key_column": "id", "money_columns": "quantia"} (money_columns opcional, string separada por vírgulas)
• provenance-packet: {"item": {"item_title": "...", "item_serial": "...", "acquired_on": "AAAA-MM-DD"}, "records": [{"kind": "recibo", "content": "..."}]}
• crypto-export-normalizer: {"content": "<csv>", "kind": "coinbase_transactions"|"kraken_ledger"}

Semântica de falha (falha fechada)

• SCHEMA_DRIFT / UNKNOWN_COLUMN / UNSUPPORTED_EXCHANGE: o layout do arquivo não é suportado — repetir não ajudará; informe ao usuário o código exato.
• INVALID_REQUEST: a entrada não foi validada; corrija a entrada e tente novamente.
• A verificação é baseada em evidências: linhas incompatíveis são SINALIZADAS com valores calculados e nunca corrigidas silenciosamente. not_verifiable significa que a fonte não possui dados verificáveis (ex.: linhas de Envio de criptomoedas) — não é um erro.
• Estes Atores nunca: conectam-se às contas bancárias/corretoras do usuário, excluem dados do usuário, adivinham datas/moedas ou fornecem conselhos fiscais/contábeis.

Nota de pagamento agentivo

Atores são pagos por evento, executados com permissões limitadas. Quando a plataforma do chamador suportar, uma única execução custa um encargo de evento (veja tabela) mais pequenos encargos de plataforma. Limite cada execução com maxTotalChargeUsd em callOptions.