결정론적 데이터 API (Apify Store의 punctual_alghoza)
파일 및 데이터셋 변환을 위한 소규모의 결정론적이고 '실패 시 종료(fail-closed)' 방식의 액터 제품군입니다. 변환 경로에 LLM이 없습니다. 정확한 Decimal 금액 처리; 모든 액터는 작업을 검증하거나 거부합니다. 확률적 생성이 아닌 검증 가능하고 반복 가능한 결과가 필요할 때 사용하세요.
어떤 액터를 사용할지
| 필요 사항 | 액터 (스토어 슬러그) | 이벤트 가격 |
|---|---|---|
| 지저분한 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실행 — 목표 문구는 사용하지 마십시오. - 입력 스키마 + README + 가격 정보를 위해
fetch-actor-details실행. - 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"}
실패 의미론 (실패 시 종료, fail-closed)
SCHEMA_DRIFT/UNKNOWN_COLUMN/UNSUPPORTED_EXCHANGE: 파일의 레이아웃이 지원되지 않습니다 — 재시도해도 도움이 되지 않습니다; 대신 사용자에게 정확한 코드를 알려주십시오.INVALID_REQUEST: 입력이 유효성 검사를 통과하지 못했습니다; 입력을 수정하고 재시도하십시오.- 검증은 증거 우선(evidence-first) 방식입니다: 일치하지 않는 행은 계산된 값으로 FLAGGED 처리되며 절대 자동으로 수정되지 않습니다.
not_verifiable은 소스에 확인 가능한 데이터가 없음을 의미합니다(예: 암호화폐 전송 행) — 오류가 아닙니다. - 이 액터들은 절대: 사용자의 거래소/은행 계정에 연결하지 않으며, 사용자 데이터를 삭제하지 않으며, 날짜/금액을 추측하지 않으며, 세금/회계 조언을 제공하지 않습니다.
에이전트 결제 참고 사항
액터는 이벤트당 과금(pay-per-event)되며 제한된 권한으로 실행됩니다. 호출자의 플랫폼이 이를 지원하는 경우, 단일 실행은 (표 참조) 이벤트 요금 한 번과 소량의 플랫폼 이벤트 비용이 발생합니다. 모든 실행에 대해 callOptions에 maxTotalChargeUsd로 비용 상한을 설정하십시오.