웹 스크래핑 및 자동화 플랫폼인 Apify에 앱을 연결하여 Lovable 앱에서 Actor를 실행하고 데이터셋을 읽습니다.
Apify에 앱 연결하기
웹 스크래핑 및 자동화 플랫폼인 Apify에 앱을 연결하여 Lovable 앱에서 Actor를 실행하고 데이터셋을 읽으세요.
Apify는 Actor 실행, Actor run 관리, 데이터셋과 스토리지의 구조화된 결과 읽기를 위한 웹 스크래핑 및 자동화 플랫폼입니다. Apify 커넥터를 사용하면 Lovable 앱이 공유 연결을 통해 Apify API를 호출하여 사이트를 스크래핑하고, 브라우저 워크플로를 자동화하고, 크롤링 결과를 제품에 표시할 수 있습니다. 이미 Apify에서 실행하는 Actor를 기반으로 스크래퍼, 예약 크롤링 또는 데이터셋 기반 뷰가 필요한 앱에 적합합니다.
이 통합은 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 프로젝트 채팅과 게시된 앱 모두에서 작동합니다.
Apify를 사용하면 앱에서 다음을 할 수 있습니다.
- Actor를 실행하여 웹사이트를 스크래핑하고 브라우저 워크플로 자동화
- Actor run이 끝날 때까지 상태 추적
- Apify 데이터셋과 key-value store에서 스크래핑한 결과 읽기
- 최근 Actor run과 해당 데이터셋 나열
일반적인 사용 사례 및 예시 앱
다음 예시는 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이 Connectors → Admin settings → App + chat connectors에서 변경하기 전까지 연결 및 클라이언트를 만들 수 있는 사용자가 No one으로 기본 설정됩니다.
서로 다른 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에 로그인합니다.
Integrations 열기
Settings → API & Integrations로 이동하거나 Integrations page를 직접 엽니다. API token 목록은 이곳에 표시됩니다.
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을 붙여 넣습니다. 필드 옆의 Get value를 누르면 Apify Integrations 페이지가 열립니다.
이 연결을 사용할 사람 선택하기
Sharing에서 연결은 기본적으로 본인만 사용할 수 있으며 Private 라벨이 표시됩니다. 연결을 공유하려면 Share with others를 클릭합니다. 그런 다음 이메일로 워크스페이스 멤버를 추가하거나, Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사용자가 연결을 사용할 수 있게 합니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
연결하기
Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 Apify API로 token을 확인합니다.
연결되면 프로젝트에서 빌드하는 누구나 구성된 연결 수준 접근 권한에 따라 프로젝트 채팅에서 Lovable에게 프로젝트를 Apify에 연결하도록 요청할 수 있습니다. 그러면 Lovable 앱이 Apify를 통해 Actor를 실행하고 데이터셋을 읽을 수 있습니다.
오래 실행되는 Actor 다루기
Actor run은 완료까지 몇 분이 걸릴 수 있으며, Apify는 run과 데이터셋 읽기에 모두 rate limit을 적용합니다. 이 기능을 중심으로 Lovable에게 빌드해 달라고 요청할 때는 run을 시작하고, 완료될 때까지 느린 간격으로 run 상태를 폴링한 다음 데이터셋을 읽게 하세요. 짧은 작업의 경우 Apify가 한 번의 호출로 Actor를 실행하고 데이터셋 항목을 반환할 수 있습니다.
run이나 데이터셋 요청이 429를 반환하면 Apify가 계정에 rate limit을 적용한 것입니다. 고정 간격으로 다시 보내는 대신 backoff 후 재시도하도록 Lovable에게 요청하세요.
제한 사항
Apify 커넥터는 다음을 지원하지 않습니다.
- API token 자동 갱신 또는 교체. 교체하려면 Apify에서 새 token을 만들고 Lovable 연결을 업데이트하세요.
- 최종 사용자별 Apify 로그인. 각 연결은 연결된 모든 프로젝트가 공유하는 단일 Apify 계정을 나타냅니다.
Apify에서 API token이 폐기되거나 교체되어 요청이 실패하면 새 token을 생성하고 Lovable 연결을 업데이트하세요.
Apify 연결 관리
연결은 Connectors에서 관리합니다. **Apify**을 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서 연결을 계속 사용할 수 있도록 유지하면서 특정 프로젝트의 Apify 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 연결 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거할 수 있습니다. 삭제는 영구적이며 연결된 모든 프로젝트에서 자격 증명이 제거되고, Apify을 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.