確定性資料 API（Apify Store 上的 punctual_alghoza 系列）
一系列小型、確定性、故障關閉（fail-closed）的 Actor，專為檔案與資料集轉換設計。轉換路徑中不使用任何 LLM；金額處理使用精確十進位；每個 Actor 若不是驗證其工作成果，就是直接拒絕。當使用者需要可驗證、可重複的結果時使用這些 Actor — 而非機率性生成。
何時使用哪個 Actor
| 需求 | Actor（商店縮寫） | 單次事件價格 |
|---|---|---|
| 髒亂 CSV 或 JSON 的去重 / 金額+日期正規化 / PII 清除 | punctual_alghoza/dataset-cleaner | $0.30 / 資料集 |
| 驗證並正規化財務匯出（CSV 含對應、OFX、QIF） | punctual_alghoza/financial-file-normalizer | $0.25 / 檔案 |
解析 Kindle My Clippings.txt 為去重 JSON | punctual_alghoza/kindle-clippings-parser | $0.20 / 檔案 |
| 正規化 eBay 銷售報表為可驗證帳簿 | punctual_alghoza/marketplace-sales-normalizer | $0.30 / 檔案 |
| 掃描匯出檔案中的洩漏機密/PII，取得清除後副本 | punctual_alghoza/export-secrets-scanner | $0.30 / 掃描 |
| 比較兩個匯出檔案（新增/移除/變更內容，精確差異） | punctual_alghoza/export-diff | $0.20 / 差異 |
| 為轉售物品建立 SHA-256 簽署的來源證明封包 | punctual_alghoza/provenance-packet | $0.25 / 封包 |
| 正規化 Coinbase/Kraken 加密貨幣匯出為可驗證帳簿 | punctual_alghoza/crypto-export-normalizer | $0.25 / 檔案 |
如何呼叫（Apify MCP 或 API）
- 使用平台或產品名稱（例如 "dataset-cleaner"、"crypto export"、"kindle"）執行
search-actors— 請使用精確名稱而非目標短語。 - 執行
fetch-actor-details取得輸入結構 + README + 定價。 - 搭配 JSON 輸入執行
call-actor。務必在callOptions中傳遞成本上限：maxTotalChargeUsd（每次執行花費上限）與timeout。 範例：callOptions: {maxTotalChargeUsd: 0.5, timeout: 120}。 - 結果為資料集項目 — 透過執行作業的預設資料集讀取。
輸入合約（簡潔版）
- dataset-cleaner:
{"content": "<csv/json text>", "format": "csv"|"json", "money_columns": "price,amount", "date_columns": "date", "scrub": true}（金額/日期欄位可選；否則自動偵測並回報） - financial-file-normalizer:
{"content": "...", "format": "csv", "csv_mapping": {"date": "Date", "amount": "Amount"}, "csv_currency": "USD"}— CSV 需要明確對應；絕不猜測。 - kindle-clippings-parser:
{"content": "<My Clippings.txt>"} - marketplace-sales-normalizer:
{"content": "<csv>", "platform": "ebay"} - export-secrets-scanner:
{"content": "<csv/json>"}— 回傳發現結果、清除後內容、原始/清除後 SHA-256。 - export-diff:
{"before": "...", "after": "...", "key_column": "id", "money_columns": "amount"}（money_columns 可選，逗號分隔字串） - 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"}
失敗語意（故障關閉）
SCHEMA_DRIFT/UNKNOWN_COLUMN/UNSUPPORTED_EXCHANGE：檔案格式不受支援 — 重試無效；請告知使用者確切的錯誤碼。INVALID_REQUEST：輸入未通過驗證；修正輸入後重試。- 驗證以證據為優先：不符的資料行會標記為 FLAGGED 並附上計算值，絕不悄悄修正。
not_verifiable表示來源無可核查資料（例如加密貨幣 Send 資料行）— 並非錯誤。 - 這些 Actor 絕不：連線使用者交易所/銀行帳戶、刪除使用者資料、猜測日期/金額、或提供稅務/會計建議。
代理（Agentic）付款注意事項
Actor 採用每次事件計費，以有限權限執行。當呼叫端平台支援時，單次執行耗費一次事件費用（見表格）加上少量平台事件。請透過 callOptions 中的 maxTotalChargeUsd 為每次執行設定上限。