ahf15811987-sketch/agent-skills

Deterministische Daten-APIs (punctual_alghoza im Apify Store)

Eine Familie kleiner, deterministischer, fehlergeschlossener Actors für Datei- und Datensatztransformation. Kein LLM im Konvertierungspfad; exaktes Decimal-Money; jeder Actor überprüft entweder seine Arbeit oder lehnt sie ab. Verwenden Sie diese, wenn der Benutzer überprüfbare, wiederholbare Ergebnisse benötigt – keine probabilistische Generierung.

Wann welcher Actor eingesetzt wird

Bedarf	Actor (Store-Slug)	Event-Preis
Deduplizieren / Geld+Datumsnormalisierung / PII-Scrubbing in unordentlichem CSV oder JSON	punctual_alghoza/dataset-cleaner	0,30 $ / Datensatz
Finanzexporte verifizieren + normalisieren (CSV mit Mapping, OFX, QIF)	punctual_alghoza/financial-file-normalizer	0,25 $ / Datei
Kindle My Clippings.txt in dedupliziertes JSON parsen	punctual_alghoza/kindle-clippings-parser	0,20 $ / Datei
eBay-Verkaufsberichte in ein verifiziertes Hauptbuch normalisieren	punctual_alghoza/marketplace-sales-normalizer	0,30 $ / Datei
Exporte auf durchgesickerte Secrets/PII scannen, bereinigte Kopie erhalten	punctual_alghoza/export-secrets-scanner	0,30 $ / Scan
Zwei Exporte vergleichen (was wurde hinzugefügt/entfernt/geändert, exakte Deltas)	punctual_alghoza/export-diff	0,20 $ / Diff
SHA-256-signiertes Provenienz-Paket für einen Wiederverkaufsartikel erstellen	punctual_alghoza/provenance-packet	0,25 $ / Paket
Coinbase/Kraken-Krypto-Exporte in ein verifiziertes Hauptbuch normalisieren	punctual_alghoza/crypto-export-normalizer	0,25 $ / Datei

Aufrufmethode (Apify MCP oder API)

1. search-actors mit dem Plattform- oder Produktnamen (z. B. "dataset-cleaner", "crypto export", "kindle") – keine Zielformulierungen.
2. fetch-actor-details für das Eingabeschema + README + Preise.
3. call-actor mit JSON-Eingabe. Übergeben Sie immer Kostenobergrenzen in callOptions: maxTotalChargeUsd (das Kostenlimit pro Ausführung) und timeout. Beispiel: callOptions: {maxTotalChargeUsd: 0.5, timeout: 120}.
4. Ergebnisse sind Datensatzelemente – lesen Sie sie über den Standarddatensatz des Laufs.

Eingabeverträge (kurzgefasst)

• dataset-cleaner: {"content": "<csv/json-text>", "format": "csv"|"json", "money_columns": "price,amount", "date_columns": "date", "scrub": true} (Geld-/Datumsspalten optional; werden ansonsten automatisch erkannt und gemeldet)
• financial-file-normalizer: {"content": "...", "format": "csv", "csv_mapping": {"date": "Date", "amount": "Amount"}, "csv_currency": "USD"} – CSV erfordert ein explizites Mapping; es wird nie geraten.
• kindle-clippings-parser: {"content": "<My Clippings.txt>"}
• marketplace-sales-normalizer: {"content": "<csv>", "platform": "ebay"}
• export-secrets-scanner: {"content": "<csv/json>"} – liefert Funde, bereinigten Inhalt, Original-/Bereinigt-SHA-256.
• export-diff: {"before": "...", "after": "...", "key_column": "id", "money_columns": "amount"} (money_columns optional, kommaseparierte Zeichenfolge)
• 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"}

Fehlersemantik (fehlergeschlossen)

• SCHEMA_DRIFT / UNKNOWN_COLUMN / UNSUPPORTED_EXCHANGE: Das Layout der Datei wird nicht unterstützt – ein erneuter Versuch hilft nicht; teilen Sie dem Benutzer stattdessen den genauen Code mit.
• INVALID_REQUEST: Die Eingabe hat die Validierung nicht bestanden; korrigieren Sie die Eingabe und wiederholen Sie den Vorgang.
• Die Überprüfung erfolgt evidenzbasiert: Nicht übereinstimmende Zeilen werden mit berechneten Werten GEKENNZEICHNET und niemals stillschweigend korrigiert. not_verifiable bedeutet, dass die Quelle keine überprüfbaren Daten enthält (z. B. Krypto-Sendezeilen) – kein Fehler.
• Diese Actors tun niemals: eine Verbindung zu den Börsen-/Bankkonten des Benutzers herstellen, Benutzerdaten löschen, Daten/Umsätze schätzen oder Steuer-/Buchhaltungsberatung geben.

Hinweis zur agentischen Bezahlung

Actors werden pro Ereignis bezahlt und laufen mit eingeschränkten Berechtigungen. Wenn die Plattform des Aufrufers dies unterstützt, kostet ein einzelner Lauf eine Ereignisgebühr (siehe Tabelle) plus kleine Plattformereignisse. Begrenzen Sie jeden Lauf mit maxTotalChargeUsd in callOptions.