Algolia를 Lovable 앱에 연결하여 전문 검색(full-text search), 패싯 필터링, 인덱싱을 추가합니다.
Algolia에 앱 연결하기
Algolia를 Lovable 앱에 연결하여 전문 검색(full-text search), 패싯 필터링, 인덱싱을 추가합니다.
Algolia는 호스팅형 검색 및 인덱싱 엔진으로, Lovable 앱이 상품 카탈로그, 콘텐츠 라이브러리, 마켓플레이스, 디렉토리 전반에 걸쳐 빠르고 오타에 강한 검색을 추가할 수 있게 해줍니다. 데이터베이스 쿼리만으로 부족할 때, 즉 패싯 필터링, 랭킹, 추천, 검색 분석이 필요한 앱을 위해 설계되었습니다.
Algolia를 사용하면 앱에서 다음과 같은 작업이 가능합니다:
- Algolia API를 사용하여 레코드 인덱싱
- 오타 허용과 랭킹이 적용된 전문 검색 실행
- 인덱싱된 데이터 위에 패싯 필터링, 정렬, 카테고리 내비게이션 구축
- Algolia의 추천 및 AI 기능으로 연관된 결과 노출
- 프론트엔드가 Algolia를 직접 쿼리할 수 있도록 제한된 public search key 노출
Algolia는 데이터베이스가 아닌 검색 엔진입니다. 기본 데이터 저장소를 대체하는 것이 아니라 함께 사용하며, 레코드가 변경되면 다시 인덱싱하세요.
단순한 검색(작은 목록 필터링, 기본 텍스트 매칭)은 데이터베이스나 프론트엔드에서 처리하세요. 더 큰 레코드 집합에 걸쳐 오타 허용, 패싯 필터, 랭킹, 검색 분석이 필요할 때 Algolia 커넥터를 사용하세요.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 이커머스 상품 검색 | Algolia를 사용해서 가격, 카테고리, 재고 상태에 대한 인스턴트 검색과 패싯 필터가 있는 상품 카탈로그를 만들어줘. | 인스턴트 검색으로 상품 발견을 강화합니다. 앱이 상품을 인덱싱하고 패싯과 관련성에 맞춰 튜닝된 랭킹을 적용한 검색 경험을 렌더링합니다. |
| 문서 사이트 검색 | Algolia를 사용해서 자동완성과 키보드 단축키가 있는 검색 바를 내 문서 사이트에 추가해줘. | 문서 사이트에 빠른 페이지 내 검색을 추가합니다. 앱이 페이지와 헤딩을 인덱싱하여 독자가 자동완성과 오타 허용으로 콘텐츠를 찾을 수 있게 합니다. |
| 마켓플레이스 리스팅 | Algolia를 사용해서 구매자가 위치, 가격, 상태로 리스팅을 필터링할 수 있는 마켓플레이스를 만들어줘. | 마켓플레이스 리스팅 전반에 걸쳐 패싯 검색을 실행합니다. 앱이 리스팅을 인덱싱하고 사용자가 결과를 빠르게 좁힐 수 있도록 필터와 정렬을 노출합니다. |
| 블로그 또는 에디토리얼 검색 | Algolia를 사용해서 태그와 작성자 필터가 있는 검색을 내 블로그에 추가해줘. | 검색과 필터링으로 관련 글을 노출합니다. 앱이 게시물과 메타데이터를 인덱싱한 다음 태그, 작성자, 날짜로 필터링된 랭킹 결과를 렌더링합니다. |
| 사내 디렉토리 | Algolia를 사용해서 사람들이 이름, 팀, 스킬로 검색할 수 있는 직원 디렉토리를 만들어줘. | 사내 디렉토리에서 사람을 빠르게 찾습니다. 앱이 직원 레코드를 인덱싱하고 팀과 스킬 필터가 있는 오타 허용 검색을 렌더링합니다. |
| 위치 파인더 | Algolia를 사용해서 지오 검색과 요리 필터가 있는 레스토랑 파인더를 만들어줘. | 지오 및 카테고리 필터로 주변 장소를 검색합니다. 앱이 Algolia의 지오 검색과 필터를 사용해 지도 결과가 포함된 파인더 UI를 렌더링합니다. |
| 검색 분석 대시보드 | Algolia를 사용해서 인기 검색어, 결과 없음 쿼리, 클릭률 데이터를 보여주는 대시보드를 만들어줘. | 사용자가 무엇을 검색하고 어디서 결과가 부족한지 모니터링합니다. 앱이 Algolia 검색 분석을 읽어 팀이 인덱스를 튜닝하고 관련성을 개선할 수 있게 합니다. |
Algolia 연결 방법
워크스페이스 admin과 owner가 Algolia를 연결할 수 있습니다.
다른 application ID와 키를 사용하여 여러 Algolia 연결을 만들 수 있습니다. 이는 환경 분리(예: 개발과 프로덕션), 다른 Algolia 애플리케이션을 대상으로 지정, 또는 특정 인덱스로 키 범위를 좁히는 데 유용합니다.
연결이 만들어지면 Algolia는 워크스페이스의 모든 프로젝트에서 사용 가능해집니다. 프로젝트에서 빌드하는 누구나 채팅에서 Lovable에게 자신의 프로젝트를 연결해 달라고 요청할 수 있습니다.
사전 요구사항
Algolia를 연결하기 전에 다음을 준비하세요:
- Algolia 계정과 애플리케이션
- Algolia Application ID
- 앱에 필요한 ACL이 부여된 백엔드 API 키 (예:
search,addObject,deleteObject,settings) - (선택 사항) 프론트엔드가 Algolia를 직접 쿼리하길 원한다면
searchACL로만 제한된 public API 키 - Lovable 워크스페이스 owner 또는 admin 역할
이 커넥터를 통해 이루어지는 모든 검색 및 인덱싱 작업은 Algolia 플랜 한도에 포함됩니다. 청구와 쿼터는 Lovable이 아닌 Algolia에서 직접 처리합니다.
1단계: Algolia application ID 및 API 키 가져오기
Lovable 앱은 Application ID와 백엔드 API 키로 Algolia에 인증합니다. 프론트엔드 검색에 사용할 public API 키를 선택적으로 제공할 수도 있습니다.
Algolia 대시보드 열기
Algolia 대시보드에 로그인하여 연결할 애플리케이션을 선택합니다.
API keys 열기
Settings → API Keys로 이동합니다. Application ID는 이 페이지 상단에 표시됩니다.
백엔드 API 키 만들기
New API key를 클릭하여 백엔드 용도의 키를 만듭니다. 설명적인 이름(예: Lovable backend)을 부여하고, 앱이 사용하는 인덱스로 제한하며, 앱에 필요한 ACL만 부여합니다(인덱싱과 검색을 수행하는 앱은 일반적으로 search, addObject, deleteObject, settings).
Algolia admin API 키는 사용하지 마세요. 필요한 최소한의 ACL만 가진 전용 키를 만들어, 다른 통합에 영향을 주지 않고 자격증명을 회전하거나 취소할 수 있게 하세요.
(선택 사항) 검색 전용 public API 키 만들기
프론트엔드가 Algolia를 직접 호출하길 원한다면, search ACL만 가진 두 번째 키를 만들고 프론트엔드가 쿼리할 수 있는 인덱스로 제한합니다.
Lovable은 저장 시 이 키를 검증하며 search 이외의 ACL이 있는 경우 거부합니다. 방어 심층화를 위해 Algolia에서 키를 특정 인덱스로(그리고 가능하다면 도메인으로도) 제한하세요.
비밀 백엔드 API 키는 비밀번호와 같이 동작합니다. 안전하게 보관하고 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.
자세한 내용은 Algolia 문서를 참고하세요: API keys 가이드.
2단계: Algolia를 Lovable에 연결하기
다른 application ID와 키를 사용하여 여러 연결을 만들 수 있습니다.
Connectors에서 Algolia 열기
Connectors → App connectors로 이동하여 Algolia를 선택합니다.
연결 추가
Add connection을 클릭합니다.
연결 구성
- Display name: 연결의 이름을 지정합니다(예:
Algolia Prod). 이 이름은 Lovable 내부에서 연결을 식별하는 데만 사용됩니다. - Application ID: 10자리 Algolia application ID를 붙여넣습니다. 이 값은 게시된 앱에서 공개적으로 보입니다.
- Secret API key: 백엔드 API 키를 붙여넣습니다. 이 키는 서버에 머무르며 Lovable 게이트웨이를 통해 프록시됩니다.
- Public API key (선택 사항): 프론트엔드가 Algolia를 직접 쿼리하길 원한다면 public
search전용 API 키를 붙여넣습니다. 이 값은 게시된 앱에서 공개적으로 보입니다.
이 연결에 접근할 수 있는 사람 선택
Who can access this connection에서 워크스페이스의 누가 연결을 사용할 수 있는지 결정합니다:
- Only you (기본값): 연결을 만든 사람만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite specific people: 본인과 명시적으로 추가된 워크스페이스 멤버만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭하여 Lovable 워크스페이스의 모든 사람이 연결을 사용할 수 있게 합니다.
자세한 내용은 Connection-level access를 참고하세요.
연결
Connect를 클릭합니다. Lovable이 연결을 저장하기 전에 두 키를 Algolia에 대해 검증합니다.
연결되면, 프로젝트에서 빌드하는 누구나(설정된 연결 수준 접근에 따라) 채팅에서 Lovable에게 프로젝트를 Algolia에 연결해 달라고 요청할 수 있습니다. 이후 Lovable 앱은 커넥터를 통해 레코드를 인덱싱하고 검색을 실행할 수 있습니다.
Public 및 secret API 키
커넥터는 서로 다른 역할을 하는 두 키를 받습니다:
- secret 백엔드 API 키는 서버 측 호출(인덱싱, 설정, 검색)에 사용됩니다. Lovable의 커넥터 게이트웨이를 통해 프록시되므로 원본 키는 게시된 앱에 도달하지 않습니다.
- public API 키는 선택 사항입니다. 제공되는 경우 프론트엔드에 노출되어 앱이 Algolia의 검색 엔드포인트를 직접 호출할 수 있습니다. Lovable은 이 키에 엄격하게
search전용 ACL을 강제하며 더 넓은 권한을 가진 키는 거부합니다.
public 키를 생략하면, 프론트엔드는 여전히 백엔드를 통해(백엔드가 게이트웨이를 거쳐 Algolia를 호출함으로써) 검색할 수 있습니다. 프론트엔드 직접 검색이 더 빠르고 백엔드 부하가 적지만, 검색 전용 public 키가 필요합니다.
제한 사항
Algolia 커넥터는 다음을 할 수 없습니다:
- 기본 데이터베이스를 대체. Algolia는 검색 엔진이므로 레코드는 진실의 원천(source of truth)에서 인덱싱되어야 하며 변경 시 동기화되어야 합니다.
- Lovable 프로젝트, 워크스페이스, 또는 연결이 제거될 때 Algolia 인덱스를 자동으로 삭제. 사용하지 않는 인덱스는 Algolia 대시보드에서 직접 삭제해야 합니다.
- API 키를 새로 고치거나 회전. 회전하려면 Algolia에서 새 키를 만들고 Lovable 연결을 업데이트하세요.
- 최종 사용자별 Algolia 인증 지원. 각 연결은 그것에 연결된 모든 프로젝트에서 공유되는 단일 Algolia 애플리케이션을 나타냅니다.
search이외의 ACL이 있는 public API 키 수락. 더 넓은 권한을 가진 키는 저장 시 거부됩니다.
Algolia 연결에서 프로젝트 연결 해제하는 방법
Editor 이상은 연결을 완전히 삭제하지 않고 특정 프로젝트를 연결에서 제거할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용 가능합니다.
프로젝트 연결을 해제하려면:
Connectors 열기
Connectors를 열고 App connectors로 이동한 다음 **Algolia**을 선택합니다.
연결 열기
관리하려는 연결을 엽니다.
프로젝트 선택
Linked projects에서 연결 해제하려는 프로젝트를 체크합니다.
확인
Unlink projects를 클릭하고 확인합니다.
연결이 해제되면 해당 프로젝트는 이 연결을 통해 더 이상 Algolia에 접근할 수 없습니다. 프로젝트가 다시 Algolia이 필요하면 사용 가능한 연결에 연결할 수 있습니다.
Algolia 연결 삭제 방법
워크스페이스 admin과 owner는 Algolia 연결을 삭제할 수 있습니다.
연결 삭제는 영구적이며 취소할 수 없습니다. 연결된 모든 프로젝트에서 자격증명이 제거되며 이 연결을 사용하는 앱은 새 연결이 추가될 때까지 작동을 멈춥니다.
삭제하기 전에 Linked projects 섹션을 검토하여 현재 어떤 프로젝트가 연결을 사용하고 있는지 확인하세요.
연결을 삭제하려면:
Connectors 열기
Connectors를 열고 App connectors로 이동한 다음 **Algolia**을 선택합니다.
연결 열기
제거할 연결을 엽니다.
연결된 프로젝트 검토
Linked projects 섹션을 검토합니다.
삭제
Delete this connection에서 Delete를 클릭하고 확인합니다.