apify/apify-client-python
Apify REST API의 공식 Python 클라이언트로, Actor 실행, 스토리지 관리, 웹 스크래핑 자동화를 간편하게 제어합니다.
95+1이번 주0 찜
17포크0이슈
중간맛 분석
Python 3.11+ 필수. 동기(ApifyClient)·비동기(ApifyClientAsync) 클라이언트 모두 제공하며, Pydantic 기반 완전 타입 지원으로 IDE 자동완성과 런타임 검증이 가능합니다. 지수 백오프 재시도, 계층화된 타임아웃, 페이지네이션, 스트리밍 등 프로덕션 수준의 기능을 내장하고 있습니다. httpx, requests, aiohttp 등 HTTP 클라이언트를 플러그인처럼 교체할 수 있으며, 구조화된 에러 처리와 디버그 로깅을 제공합니다. 의 예제대로 토큰만 있으면 즉시 Actor를 실행하고 결과를 읽을 수 있습니다.
이런 레포예요
이럴 때 쓰면 좋아요
- 클라우드 기반 웹 스크래핑 작업을 Python 코드에서 제어하고 결과 수집
- 대규모 데이터 수집을 위해 Apify Actor를 원격 실행하고 자동 재시도·타임아웃 관리
- pandas와 통합하여 수집한 데이터를 즉시 분석 파이프라인으로 전송
핵심 기능
동기·비동기 클라이언트 모두 지원완전 타입화된 Pydantic 모델 (OpenAPI spec 기반)지수 백오프 재시도, 계층화 타임아웃, 자동 페이지네이션·스트리밍
대안 대비 차별점
공식 Apify SDK인만큼 OpenAPI 기반 완전 자동 생성 타입 모델과 플랫폼 특화 추상화를 제공하며, 동기·비동기 통일 API로 Python의 다양한 동시성 패턴을 자연스럽게 지원합니다.
준비물
- Python 3.11 이상
- Apify API 토큰
바로 시작하기
-
API 토큰을 Apify Console에서 발급받습니다.
-
apify-client를 설치합니다.
pip install apify-client
- 동기 클라이언트로 Actor를 실행하고 결과를 읽습니다.
from apify_client import ApifyClient
client = ApifyClient('MY-APIFY-TOKEN')
run = client.actor('apify/hello-world').call(
run_input={'message': 'Hello, Apify!'},
)
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
- (선택) 비동기 클라이언트를 사용할 경우:
import asyncio
from apify_client import ApifyClientAsync
async def main() -> None:
client = ApifyClientAsync('MY-APIFY-TOKEN')
run = await client.actor('apify/hello-world').call(
run_input={'message': 'Hello, Apify!'},
)
async for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
asyncio.run(main())
별 추이 · 7일
95+1 / 7일
활용성 · 따라 만들기 좋은가
베스트 샘플샘플 점수 64/100
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2019년 생성
이 레포에 깃밥 배지 달기
[](https://www.gitbap.com/r/apify/apify-client-python)🔌 클로드에서 바로 써보기
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
방법 ① 커넥터 URL
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp방법 ② 플러그인 (체험까지)
플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기