Apify에 앱 연결하기
웹 스크래핑 및 자동화 플랫폼인 Apify에 앱을 연결하여 Lovable 앱에서 Actor를 실행하고 데이터셋을 읽으세요.
Apify는 Actor 실행, Actor run 관리, 데이터셋과 스토리지의 구조화된 결과 읽기를 위한 웹 스크래핑 및 자동화 플랫폼입니다. Apify 커넥터를 사용하면 Lovable 앱이 관리형 워크스페이스 연결을 통해 Apify API를 호출하여 사이트를 스크래핑하고, 브라우저 워크플로를 자동화하고, 크롤링 결과를 제품에 표시할 수 있습니다.
Apify를 사용하면 앱에서 다음을 할 수 있습니다.
- Actor를 실행하여 웹사이트를 스크래핑하고 브라우저 워크플로 자동화
- Actor run 상태를 폴링하고 작업 완료 시 로그 가져오기
- 데이터셋과 key-value store에서 구조화된 결과 읽기
- Apify 계정의 Actor, run, 스토리지 목록 조회 및 관리
이미 Apify에서 실행하는 Actor를 기반으로 스크래퍼, 예약 크롤링 또는 데이터셋 기반 뷰가 필요한 앱에 Apify가 적합합니다.
일반적인 사용 사례 및 예시 앱
| 예시 앱 | 예시 프롬프트 | 설명 |
|---|---|---|
| 경쟁사 가격 트래커 | Apify를 사용해 가격 스크래핑 Actor를 실행하고 최신 결과를 보여주는 대시보드를 만들어 주세요. | 경쟁사 가격을 한곳에서 확인합니다. 앱이 Actor run을 시작하고 완료를 기다린 뒤 데이터셋 항목을 표로 표시합니다. |
| 리드 목록 빌더 | Apify를 사용해 회사 디렉터리 페이지를 스크래핑하고 연락처를 목록에 저장하는 도구를 만들어 주세요. | 공개 디렉터리 페이지를 구조화된 리드로 변환합니다. 앱이 대상 URL로 Actor를 실행하고 반환된 데이터셋 행을 후속 작업을 위해 저장합니다. |
| 콘텐츠 모니터링 피드 | Apify를 사용해 뉴스 스크래핑 Actor를 일정에 따라 다시 실행하고 새 기사를 보여주는 피드를 만들어 주세요. | 수동 실행 없이 최신 스크래핑 콘텐츠를 표시합니다. 앱이 일정에 따라 Actor run을 트리거하고 데이터셋을 읽어 새 항목을 강조합니다. |
| 이커머스 제품 카탈로그 동기화 | Apify를 사용해 카탈로그 스크래핑 후 Apify 데이터셋의 제품을 나열하는 관리자 페이지를 만들어 주세요. | 스크래핑한 카탈로그 데이터를 앱 안에서 탐색합니다. 앱이 페이지네이션으로 데이터셋 항목을 읽고 운영자가 검토할 수 있는 제품 필드를 보여줍니다. |
| Actor run 상태 콘솔 | Apify를 사용해 최근 Actor run을 상태, 실행 시간, 데이터셋 링크와 함께 나열하는 콘솔을 만들어 주세요. | Lovable을 벗어나지 않고 스크래핑 작업을 모니터링합니다. 앱이 Apify 계정의 run을 나열하고 성공한 각 run을 해당 데이터셋에 연결합니다. |
| 리서치 어시스턴트 | Apify를 사용해 웹사이트 크롤링 Actor를 실행하고 스크래핑한 페이지를 요약하는 리서치 페이지를 만들어 주세요. | 크롤링 결과와 앱 내 분석을 결합합니다. 앱이 Actor를 실행하고 데이터셋을 읽어 스크래핑한 콘텐츠의 요약 뷰를 제공합니다. |
Apify 연결 방법
Apify 연결을 만들 수 있는 사용자는 플랜과 워크스페이스 설정에 따라 달라집니다. 연결을 만들 수 있는 사람을 참고하세요.
앱 커넥터는 Free, Pro, Business 플랜에서 기본적으로 활성화됩니다. Enterprise 플랜에서는 워크스페이스 admin 또는 owner가 Connectors → Admin settings → App connectors에서 활성화할 때까지 기본적으로 비활성화됩니다.
서로 다른 API token으로 여러 Apify 연결을 만들 수 있습니다. 이는 환경을 분리하거나(예: development와 production) 사용량 제한을 관리할 때 유용합니다.
연결을 만들 때 사용할 프로젝트에 연결할 수 있습니다. 프로젝트에서 빌드하는 누구나 채팅에서 Lovable에게 프로젝트를 해당 연결에 연결하도록 요청할 수 있습니다.
전제 조건
Apify를 연결하기 전에 다음을 준비하세요.
- Apify 계정
- Apify API token
- Lovable 워크스페이스에서 연결 만들기 권한(연결을 만들 수 있는 사람 참고)
이 커넥터를 통한 모든 Actor run과 API 사용량은 Apify 플랜에 포함됩니다. 청구와 할당량은 Lovable이 아닌 Apify에서 직접 처리합니다.
단계 1: Apify API token 가져오기
Apify API token을 사용하면 Lovable 앱이 Apify API에 인증할 수 있습니다.
Apify API token을 만들려면 다음 단계를 따르세요.
Apify 계정 열기
Apify Console에 로그인합니다.
API and Integrations 열기
Settings → API & Integrations로 이동합니다.
Token 만들기
새 API token을 만들고 Lovable integration과 같이 알아보기 쉬운 이름을 지정합니다.
Token 복사하기
Token을 복사해 안전하게 보관합니다. 최신 token은 대개 apify_api_로 시작하며 이전 token은 형식이 다를 수 있습니다.
API token은 비밀번호처럼 작동합니다. 안전하게 보관하고 절대 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.
자세한 내용은 Apify 문서의 Apify API 시작하기를 참고하세요.
단계 2: Apify를 Lovable에 연결하기
서로 다른 API token을 사용해 여러 연결을 만들 수 있습니다.
Connectors에서 Apify 열기
Connectors를 열고 Apify를 선택합니다.
연결 추가하기
Add connection을 클릭합니다.
연결 구성하기
- Display name:
Apify Prod처럼 연결 이름을 지정합니다. 이 이름은 Lovable 안에서 연결을 식별할 때만 사용됩니다. - API token: Apify API token을 붙여 넣습니다.
이 연결을 사용할 사람 선택하기
Who can use this connection에서 워크스페이스의 누가 연결을 사용할 수 있는지 정합니다. 처음에는 본인만 접근할 수 있습니다.
- Only you(기본값): 접근 목록을 그대로 두면 본인만 연결과 관련 데이터에 접근할 수 있습니다.
- Invite specific people: 이메일로 워크스페이스 멤버를 추가하면 본인과 추가한 사용자만 연결과 관련 데이터에 접근할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭하면 Lovable 워크스페이스의 모든 사용자가 연결을 사용할 수 있습니다.
자세한 내용은 연결을 관리할 수 있는 사람을 참고하세요.
연결하기
Connect를 클릭합니다.
연결되면 프로젝트에서 빌드하는 누구나 구성된 연결 수준 접근 권한에 따라 채팅에서 Lovable에게 프로젝트를 Apify에 연결하도록 요청할 수 있습니다. 그러면 Lovable 앱이 Apify를 통해 Actor를 실행하고 데이터셋을 읽을 수 있습니다.
제한 사항
Apify 커넥터는 다음을 지원하지 않습니다.
- 클라이언트 측 브라우저 코드에서 Apify API 호출. 호출은 서버 측 endpoint에서 Lovable을 통해 이루어집니다.
- API token 자동 갱신 또는 교체. 교체하려면 Apify에서 새 token을 만들고 Lovable 연결을 업데이트하세요.
- 최종 사용자별 Apify 로그인. 각 연결은 연결된 모든 프로젝트가 공유하는 단일 Apify 계정을 나타냅니다.
Apify는 API에 rate limit을 적용합니다. Actor run을 자주 폴링하거나 데이터셋을 반복해서 가져오면 간헐적으로 429 응답이 발생할 수 있으므로 서버 코드에 backoff를 적용한 재시도를 추가하세요.
Apify에서 API token이 폐기되거나 교체되어 요청이 실패하면 새 token을 생성하고 Lovable 연결을 업데이트하세요.
Apify 연결에서 프로젝트 연결 해제 방법
Editor 이상의 역할은 연결 전체를 삭제하지 않고 특정 프로젝트를 연결에서 제거할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용할 수 있습니다.
프로젝트 연결을 해제하려면 다음 단계를 따르세요.
Connectors 열기
Connectors를 열고 **Apify**을 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택하기
Linked projects에서 연결을 해제할 프로젝트를 선택합니다.
확인하기
Unlink projects를 클릭하고 확인합니다.
연결이 해제된 프로젝트는 이 연결을 통해 더 이상 Apify에 접근할 수 없습니다. 프로젝트에 Apify이 다시 필요하면 사용 가능한 연결에 연결할 수 있습니다.
Apify 연결 삭제 방법
Workspace admin과 owner는 Apify 연결을 삭제할 수 있습니다. 다른 멤버도 자신이 만들었거나 명시적으로 접근 권한을 받은 연결을 삭제할 수 있습니다.
연결 삭제는 영구적이며 실행 취소할 수 없습니다. 연결된 모든 프로젝트에서 자격 증명이 제거되며, 이 연결을 사용하는 앱은 새 연결을 추가할 때까지 작동하지 않습니다.
삭제하기 전에 Linked projects 섹션을 검토해 현재 연결을 사용하는 프로젝트를 확인하세요.
연결을 삭제하려면 다음 단계를 따르세요.
Connectors 열기
Connectors를 열고 **Apify**을 선택합니다.
연결 열기
제거할 연결을 엽니다.
연결된 프로젝트 검토하기
Linked projects 섹션을 검토합니다.
삭제하기
Delete this connection에서 Delete를 클릭하고 확인합니다.