본문으로 건너뛰기
cccskills
무료GitHub에 공개

apify-common-errors

Troubleshoot common Apify Actor and API failures by matching the exact error signature to a catalog entry. Get likely causes, copyable fixes, and commands to verify recovery for authentication, rate limits, builds, proxies, payloads, and anti-bot blocks.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

원문원문 설명 보기

Diagnose and fix common Apify Actor and API errors. Use when an Apify run fails, an API call returns 401/403/404/413/429, a proxy connection drops, an Actor build breaks, or a scrape hits an anti-bot block, and you need the cause plus a copy-paste fix. Trigger with "apify error", "fix apify", "actor failed", "apify not working", "debug apify", "apify 429".

연동 도구X (Twitter)

실행 점수 미검증

설치 방법 보기

이럴 때 유용합니다

  • Diagnosing a failed or timed-out Actor run
  • Understanding an Apify API status code
  • Investigating proxy or anti-bot failures
  • Verifying that a fix restored a run

포함된 파일(2)

  • SKILL.md5.1 KB
  • references/error-reference.md6.2 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Apify Common Errors

Overview

Quick diagnostic reference for the most common Apify errors. Covers Actor run failures, API errors, proxy problems, anti-bot blocks, and platform-specific issues. The full per-error catalog — raw signature, cause, diagnosis, and copy-paste fix for all ten errors — lives in references/error-reference.md; this file is the lean triage path that points you there.

Prerequisites

  • An Apify API token exported as APIFY_TOKEN (Console > Settings > Integrations).
  • Access to the Apify Console for reading run and build logs.
  • curl and jq on PATH for the diagnostic commands below; apify CLI optional for build inspection.

Instructions

Work the failure from signal to fix:

  1. Capture the exact error. Grab the Status / StatusMessage from the run, or the ApifyApiError message and HTTP code from the API response. The raw string is the key you match on.
  2. Match the signature. Find the matching entry in the table below, then open references/error-reference.md at that number for the cause, diagnosis, and fix.
  3. Diagnose before changing code. For run failures, pull the log via the API or Console (see the FAILED entry). For auth/rate/payload errors, the HTTP code already tells you the class — see Error Handling.
  4. Apply the fix from the reference, re-run, and confirm with the diagnostic commands.

Error signature → reference

#ErrorSignature to match
1Actor run FAILEDStatus: FAILED / exited with code 1
2Actor run TIMED-OUTActor timed out after N seconds
3Rate limitedRate limit exceeded (429)
4UnauthorizedAuthentication required (401)
5Build failedBuild failed: npm ERR!
6Proxy connection failed502 Bad Gateway / Could not connect to proxy
7Anti-bot blockstatus 403 / Captcha detected
8Out of memoryJavaScript heap out of memory
9Dataset push too largePayload too large (413)
10Actor not foundActor '…' not found (404)

Full detail for every row: references/error-reference.md.

Output

Working through this skill yields:

  • The identified error class (matched signature + the one of ten catalog entries).
  • The root cause and a copy-paste fix (config change, code edit, or token/proxy action).
  • A verification command whose output confirms the run recovered (status SUCCEEDED, valid username, etc.).

Error Handling

HTTP CodeMeaningRetryableAction
400Bad requestNoFix input/params
401UnauthorizedNoCheck token
403ForbiddenNoCheck permissions
404Not foundNoVerify resource ID
408TimeoutYesRetry with backoff
413Payload too largeNoReduce batch size
429Rate limitedYesAuto-retried by client
500+Server errorYesAuto-retried by client

Examples

Diagnostic commands for the most common triage steps:

# Check Apify platform status
curl -s https://api.apify.com/v2/health | jq '.'

# Verify your auth (fixes 401 diagnosis)
curl -s -H "Authorization: Bearer $APIFY_TOKEN" \
  https://api.apify.com/v2/users/me | jq '.data.username'

# Check installed package versions
npm list apify-client apify crawlee 2>/dev/null

# Get last run status (find why a run FAILED / TIMED-OUT)
curl -s -H "Authorization: Bearer $APIFY_TOKEN" \
  "https://api.apify.com/v2/acts/USER~ACTOR/runs?limit=1&desc=true" | \
  jq '.data.items[0] | {status, statusMessage, startedAt, finishedAt}'

For the worked fix behind each error — e.g. reading a run log to find a stack trace, batching dataset pushes under 9MB, or switching to residential proxies to clear a 403 — see the matching entry in references/error-reference.md.

Resources

Next Steps

For comprehensive multi-error debugging across a whole Actor project — log correlation, proxy rotation strategy, and build-cache issues — see the apify-debug-bundle skill in this pack. </content>

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Add a synthetic-data CI gate for customer-owned Abridge integration code. Test consent handling, note-review handoffs, redaction, and rollback behavior with mocked vendor boundaries, without connecting CI to a live Abridge or EHR tenant.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Adding regression checks to an Abridge integration repository
  • Testing consent and note-release handling
  • Checking logs for sensitive data exposure
jeremylongshore/tons-of-skills-marketplace2.9천2026년 10월 23일 업데이트

Triage Abridge recording, note review, Epic handoff, and access problems using observed symptoms and approved guidance. Identify the affected workflow stage, organize a minimal timeline, and prepare a redacted escalation record for the responsible team.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Separate recording problems from upload failures
  • Investigate note creation delays and editor issues
  • Identify the responsible team for Epic handoff failures
jeremylongshore/tons-of-skills-marketplace2.9천2026년 10월 23일 업데이트

Map and review an Abridge clinical documentation workflow from consent and recording through draft review, evidence checks, edits, and final disposition. Keep clinician approval explicit, identify failure exits, and separate verified facts from tenant-specific details and pending approvals.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Map a clinical note workflow for a care setting
  • Check where consent and patient identity are verified
  • Review draft notes against linked evidence before sign-off
jeremylongshore/tons-of-skills-marketplace2.9천2026년 10월 23일 업데이트

Audit how clinician-reviewed Abridge note sections map into Epic templates and downstream workflows. Use approved test records to document destinations, exceptions, evidence, rollback steps, and a go or no-go decision for a specific environment.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Checking Abridge note section mappings to Epic templates
  • Auditing a department’s approved documentation handoff
  • Preparing test evidence and a go or no-go decision
jeremylongshore/tons-of-skills-marketplace2.9천2026년 10월 23일 업데이트

Review Abridge adoption and workflow value using local usage records, clinician feedback, and verified contract costs. Build an evidence based decision table covering adoption, quality, support burden, and options to expand, hold, or improve the rollout.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Reviewing adoption after an Abridge rollout
  • Preparing evidence for a renewal decision
  • Comparing workflow outcomes across care settings
jeremylongshore/tons-of-skills-marketplace2.9천2026년 10월 23일 업데이트

Prepare a bounded support bundle for an Abridge issue using allowlisted operational details such as versions, coarse timestamps, and correlation references. Exclude recordings, transcripts, patient identifiers, credentials, and unrestricted logs, then document redactions and review details.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Preparing reviewed evidence for an Abridge support case
  • Documenting redactions and excluded data
  • Collecting approved operational details for an incident
jeremylongshore/tons-of-skills-marketplace2.9천2026년 10월 23일 업데이트

jeremylongshore의 스킬 모두 보기

이 스킬의 문제 신고