API de Données Déterministes (punctual_alghoza sur Apify Store)

Que fait API de Données Déterministes (punctual_alghoza sur Apify Store) ?

Une famille de petits Acteurs déterministes, fonctionnant en mode "fail-closed", pour la transformation de fichiers et de jeux de données. Aucun LLM dans le chemin de conversion ; gestion exacte des montants décimaux ; chaque Acteur vérifie son travail ou refuse de le produire. Utilisez-les lorsque l'utilisateur a besoin de résultats vérifiables et reproductibles — et non de génération probabiliste.

Quand utiliser quel Acteur

Besoin	Acteur (slug store)	Prix par événement
Déduplication / normalisation monétaire+dates / nettoyage PII dans un CSV ou JSON désordonné	punctual_alghoza/dataset-cleaner	0,30 $ / jeu de données
Vérifier + normaliser des exports financiers (CSV avec mapping, OFX, QIF)	punctual_alghoza/financial-file-normalizer	0,25 $ / fichier
Analyser le fichier Kindle My Clippings.txt en JSON dédupliqué	punctual_alghoza/kindle-clippings-parser	0,20 $ / fichier
Normaliser les rapports de ventes eBay en un registre vérifié	punctual_alghoza/marketplace-sales-normalizer	0,30 $ / fichier
Scanner les exports à la recherche de secrets/PII divulgués, obtenir une copie nettoyée	punctual_alghoza/export-secrets-scanner	0,30 $ / scan
Comparer deux exports (ce qui a été ajouté/supprimé/modifié, écarts exacts)	punctual_alghoza/export-diff	0,20 $ / diff
Construire un paquet de provenance signé SHA-256 pour un article revendu	punctual_alghoza/provenance-packet	0,25 $ / paquet
Normaliser les exports crypto Coinbase/Kraken en un registre vérifié	punctual_alghoza/crypto-export-normalizer	0,25 $ / fichier

Comment appeler (via Apify MCP ou API)

1. search-actors avec le nom de la plateforme ou du produit (par ex. "dataset-cleaner", "crypto export", "kindle") — pas de phrases décrivant l'objectif.
2. fetch-actor-details pour le schéma d'entrée + README + tarification.
3. call-actor avec l'entrée JSON. Toujours passer des limites de coût dans callOptions : maxTotalChargeUsd (plafond de dépense par exécution) et timeout. Exemple : callOptions: {maxTotalChargeUsd: 0.5, timeout: 120}.
4. Les résultats sont des éléments du jeu de données — lisez-les via le jeu de données par défaut de l'exécution.

Contrats d'entrée (concis)

• dataset-cleaner : {"content": "<texte csv/json>", "format": "csv"|"json", "money_columns": "price,amount", "date_columns": "date", "scrub": true} (colonnes monétaires/de date optionnelles ; autrement détectées et signalées automatiquement)
• financial-file-normalizer : {"content": "...", "format": "csv", "csv_mapping": {"date": "Date", "amount": "Montant"}, "csv_currency": "USD"} — le CSV nécessite un mapping explicite ; il n'est jamais deviné.
• kindle-clippings-parser : {"content": "<My Clippings.txt>"}
• marketplace-sales-normalizer : {"content": "<csv>", "platform": "ebay"}
• export-secrets-scanner : {"content": "<csv/json>"} — retourne les résultats, le contenu nettoyé, les empreintes SHA-256 originales et nettoyées.
• export-diff : {"before": "...", "after": "...", "key_column": "id", "money_columns": "amount"} (money_columns optionnel, chaîne séparée par des virgules)
• provenance-packet : {"item": {"item_title": "...", "item_serial": "...", "acquired_on": "AAAA-MM-JJ"}, "records": [{"kind": "receipt", "content": "..."}]}
• crypto-export-normalizer : {"content": "<csv>", "kind": "coinbase_transactions"|"kraken_ledger"}

Comportement en cas d'échec (fail-closed)

• SCHEMA_DRIFT / UNKNOWN_COLUMN / UNSUPPORTED_EXCHANGE : la disposition du fichier n'est pas prise en charge — une nouvelle tentative ne résoudra pas le problème ; indiquez plutôt le code exact à l'utilisateur.
• INVALID_REQUEST : l'entrée n'a pas été validée ; corrigez l'entrée et réessayez.
• La vérification est basée sur les preuves : les lignes discordantes sont MARQUÉES avec les valeurs calculées et jamais corrigées silencieusement. not_verifiable signifie que la source ne contient pas de données vérifiables (par exemple, les lignes d'envoi crypto) — ce n'est pas une erreur.
• Ces Acteurs ne : se connectent jamais aux comptes bancaires/d'échange de l'utilisateur, ne suppriment jamais de données utilisateur, ne devinent jamais les dates/montants, et ne donnent jamais de conseils fiscaux ou comptables.

Note sur le paiement pour les agents

Les Acteurs sont payés par événement et exécutés avec des autorisations limitées. Lorsque la plateforme de l'appelant le permet, une seule exécution coûte un débit d'événement (voir tableau) plus de petits événements de plateforme. Plafonnez chaque exécution avec maxTotalChargeUsd dans callOptions.