APIs de Datos Deterministas (punctual_alghoza en Apify Store)
Una familia de pequeños actores deterministas y de cierre ante fallos (fail-closed) para la transformación de archivos y conjuntos de datos. Sin LLM en la ruta de conversión; dinero decimal exacto; cada actor verifica su trabajo o se niega a ejecutarlo. Úsalos cuando el usuario necesite resultados verificables y repetibles, no generación probabilística.
Cuándo usar cada actor
| Necesidad | Actor (slug de la tienda) | Precio por evento |
|---|---|---|
| Deduplicar / normalizar dinero+fechas / eliminar PII en CSV o JSON desordenados | punctual_alghoza/dataset-cleaner | $0.30 / dataset |
| Verificar + normalizar exportaciones financieras (CSV con mapeo, OFX, QIF) | punctual_alghoza/financial-file-normalizer | $0.25 / archivo |
Analizar My Clippings.txt de Kindle en JSON deduplicado | punctual_alghoza/kindle-clippings-parser | $0.20 / archivo |
| Normalizar informes de ventas de eBay en un libro mayor verificado | punctual_alghoza/marketplace-sales-normalizer | $0.30 / archivo |
| Escanear exportaciones en busca de secretos/PII filtrados, obtener copia depurada | punctual_alghoza/export-secrets-scanner | $0.30 / escaneo |
| Comparar dos exportaciones (qué se añadió/eliminó/cambió, diferencias exactas) | punctual_alghoza/export-diff | $0.20 / comparación |
| Crear paquete de procedencia firmado con SHA-256 para un artículo de reventa | punctual_alghoza/provenance-packet | $0.25 / paquete |
| Normalizar exportaciones de criptomonedas de Coinbase/Kraken en un libro mayor verificado | punctual_alghoza/crypto-export-normalizer | $0.25 / archivo |
Cómo llamarlo (Apify MCP o API)
search-actorscon el nombre de la plataforma o producto (por ejemplo, "dataset-cleaner", "crypto export", "kindle") — no frases de objetivo.fetch-actor-detailspara obtener el esquema de entrada + README + precio.call-actorcon la entrada JSON. Siempre pasa límites de costo encallOptions:maxTotalChargeUsd(el tope de gasto por ejecución) ytimeout. Ejemplo:callOptions: {maxTotalChargeUsd: 0.5, timeout: 120}.- Los resultados son elementos del dataset — léelos a través del dataset predeterminado de la ejecución.
Contratos de entrada (concisos)
- dataset-cleaner:
{"content": "<texto csv/json>", "format": "csv"|"json", "money_columns": "price,amount", "date_columns": "date", "scrub": true}(columnas de dinero/fecha opcionales; de lo contrario se auto-detectan y notifican) - financial-file-normalizer:
{"content": "...", "format": "csv", "csv_mapping": {"date": "Date", "amount": "Amount"}, "csv_currency": "USD"}— CSV requiere un mapeo explícito; nunca se adivina. - kindle-clippings-parser:
{"content": "<My Clippings.txt>"} - marketplace-sales-normalizer:
{"content": "<csv>", "platform": "ebay"} - export-secrets-scanner:
{"content": "<csv/json>"}— devuelve hallazgos, contenido depurado, SHA-256 original/depurado. - export-diff:
{"before": "...", "after": "...", "key_column": "id", "money_columns": "amount"}(money_columns opcional, cadena separada por comas) - provenance-packet:
{"item": {"item_title": "...", "item_serial": "...", "acquired_on": "YYYY-MM-DD"}, "records": [{"kind": "receipt", "content": "..."}]} - crypto-export-normalizer:
{"content": "<csv>", "kind": "coinbase_transactions"|"kraken_ledger"}
Semántica de fallo (cierre ante fallos)
SCHEMA_DRIFT/UNKNOWN_COLUMN/UNSUPPORTED_EXCHANGE: el diseño del archivo no es compatible — reintentar no ayudará; dile al usuario el código exacto en su lugar.INVALID_REQUEST: la entrada no pasó la validación; corrige la entrada y reintenta.- La verificación está basada en evidencia: las filas no coincidentes se MARCAN con valores calculados y nunca se corrigen silenciosamente.
not_verifiablesignifica que la fuente no tiene datos comprobables (por ejemplo, filas de envío de criptomonedas) — no es un error. - Estos actores nunca: se conectan a las cuentas bancarias/de intercambio del usuario, eliminan datos del usuario, adivinan fechas/dinero, ni dan consejos fiscales/contables.
Nota de pago para agentes
Los actores se pagan por evento, se ejecutan con permisos limitados. Cuando la plataforma del llamante lo soporta, una sola ejecución cuesta un cargo por evento (ver tabla) más pequeños eventos de plataforma. Limita cada ejecución con maxTotalChargeUsd en callOptions.