app-only Bearer 토큰으로 X에 앱을 연결해 사용자를 조회하고, 최근 공개 게시물을 검색하고, Lovable 앱에 소셜 통합을 구축합니다.
X (Twitter) 연결
app-only Bearer 토큰으로 X에 앱을 연결해 사용자를 조회하고, 최근 공개 게시물을 검색하고, Lovable 앱에서 소셜 통합을 구축하세요.
X는 공개 게시물과 대화를 위한 소셜 플랫폼입니다. X (Twitter) 커넥터를 사용하면 Lovable 앱이 X Developer 계정의 app-only Bearer 토큰으로 X API v2를 호출할 수 있습니다. 프로필을 조회하거나, 최근 공개 게시물을 검색하거나, 읽기 전용 소셜 대시보드를 만드는 앱을 위해 설계되었습니다.
X를 사용하면 앱에서 다음을 할 수 있습니다.
- 사용자명이나 ID로 사용자 조회
- 최근 공개 게시물 검색
- ID로 공개 게시물 메타데이터 읽기
- X API v2 데이터 기반의 대시보드와 통합 구축
이 커넥터는 app-only Bearer 토큰을 사용하므로 공개 데이터에 대한 읽기 전용 접근을 지원합니다. 사용자 계정을 대신해 게시·좋아요·팔로우하거나 DM을 보낼 수는 없습니다. 프로필 조회, 키워드 모니터링, 공개 콘텐츠 피드에 적합합니다.
일반적인 사용 사례 및 예시 앱
| 예시 앱 | 예시 프롬프트 | 설명 |
|---|---|---|
| 프로필 조회 페이지 | X를 사용해 X 사용자명의 프로필 정보를 보여주는 페이지를 만들어 줘. | X의 공개 프로필 세부 정보 표시. 앱이 사용자명으로 사용자 메타데이터를 가져와 이름, 핸들, 기타 공개 필드를 렌더링합니다. |
| 키워드 모니터링 대시보드 | X를 사용해 X에서 키워드로 최근 게시물을 검색하는 대시보드를 만들어 줘. | 주제를 둘러싼 공개 대화 추적. 앱이 최근 게시물 검색 결과를 조회해 필터링 가능한 피드로 보여줍니다. |
| 소셜 증명 위젯 | X를 사용해 계정 목록의 최근 게시물을 보여주는 위젯을 만들어 줘. | 앱에 선별된 공개 게시물 노출. 앱이 ID나 사용자명으로 게시물을 조회해 타임라인 형태의 뷰로 렌더링합니다. |
| 인플루언서 디렉터리 | X를 사용해 사용자명을 입력하면 팔로워 수와 약력을 보여주는 디렉터리를 만들어 줘. | 여러 계정의 공개 프로필 통계 집계. 앱이 사용자 조회를 일괄 처리해 약력과 지표를 표로 표시합니다. |
| 이벤트 해시태그 트래커 | X를 사용해 이벤트 해시태그와 일치하는 게시물의 라이브 피드를 만들어 줘. | 캠페인이나 이벤트의 공개 게시물 모니터링. 앱이 해시태그로 최근 게시물을 검색해 일정에 따라 결과를 새로 고칩니다. |
| 경쟁사 멘션 보드 | X를 사용해 우리 브랜드 이름을 언급하는 최근 게시물을 추적하는 보드를 만들어 줘. | 공개 게시물 전반의 브랜드 멘션 감시. 앱이 예약 검색을 실행해 팀을 위해 새 일치 항목을 강조합니다. |
| 리서치·리포팅 도구 | X를 사용해 특정 주제에 대한 최근 게시물을 JSON으로 내보내는 내부 도구를 만들어 줘. | 분석·리포팅용 공개 게시물 데이터 수집. 앱이 gateway를 통해 게시물 메타데이터를 검색·조회해 후속 활용에 사용합니다. |
X 연결 방법
워크스페이스 admin과 owner가 X를 연결할 수 있습니다.
서로 다른 Bearer 토큰으로 여러 X 연결을 만들 수 있습니다. 환경(예를 들어 개발과 운영)을 분리하거나 서로 다른 X 앱의 토큰을 사용할 때 유용합니다.
연결이 생성되면 X는 워크스페이스의 모든 프로젝트에서 사용할 수 있게 됩니다. 프로젝트에서 빌드하는 누구나 채팅으로 Lovable에게 프로젝트를 X에 연결해 달라고 요청할 수 있습니다.
사전 준비
X를 연결하기 전에 다음을 준비하세요.
- X Developer 계정
- app-only Bearer 토큰이 있는 X 앱
- Lovable 워크스페이스 owner 또는 admin 역할
이 커넥터를 통한 모든 API 요청은 X API 접근 등급과 rate limit에 포함됩니다. 청구와 할당량은 Lovable이 아니라 X가 직접 처리합니다.
1단계: X app-only Bearer 토큰 받기
app-only Bearer 토큰을 사용하면 Lovable 앱이 읽기 전용 공개 데이터에 대해 X API v2로 인증할 수 있습니다. 토큰은 X Developer Portal에서 특정 앱에 대해 생성합니다.
X Bearer 토큰을 만들려면:
X Developer Portal 열기
X Developer Portal에 로그인하세요.
프로젝트와 앱 생성 또는 열기
아직 없다면 Project와 App을 만들거나, 사용할 앱을 여세요.
keys and tokens 열기
앱 설정에서 Keys and tokens(또는 portal 레이아웃에 따라 User authentication settings → Keys and tokens)로 이동하세요.
Bearer 토큰 생성
Authentication Tokens 아래에서 Bearer Token을 찾아 Generate(또는 Regenerate)를 클릭하세요. 토큰을 복사해 안전하게 저장하세요.
Bearer 토큰은 비밀번호처럼 동작합니다. 안전하게 보관하고 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.
접근 등급, 엔드포인트, rate limit에 대한 자세한 내용은 X 문서를 참고하세요. X API introduction
2단계: X를 Lovable에 연결
서로 다른 Bearer 토큰으로 여러 연결을 만들 수 있습니다.
Connectors에서 X 열기
Connectors → App connectors로 이동해 **X (Twitter)**를 선택하세요.
연결 추가
Add connection을 클릭하세요.
연결 구성
- Display name: 연결 이름을 지정합니다(예:
X Prod). 이 이름은 Lovable 내부에서 연결을 식별하는 데만 사용됩니다. - Bearer token: X Developer Portal에서 받은 app-only Bearer 토큰을 붙여넣습니다.
이 연결에 접근할 수 있는 사람 선택
Who can access this connection 아래에서 워크스페이스의 누가 이 연결을 사용할 수 있는지 결정하세요.
- Only you(기본값): 연결을 만든 사람만 해당 연결과 관련 데이터를 사용할 수 있습니다.
- Invite specific people: 본인과 명시적으로 추가된 워크스페이스 멤버만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사람이 연결을 사용할 수 있게 합니다.
자세한 내용은 연결 수준 접근을 참고하세요.
연결
Connect를 클릭하세요. Lovable은 연결을 저장하기 전에 X API에 대해 토큰을 검증합니다.
연결되면 프로젝트에서 빌드하는 누구나(구성된 연결 수준 접근에 따라) 채팅으로 Lovable에게 프로젝트를 X에 연결해 달라고 요청할 수 있습니다. 그러면 Lovable 앱이 커넥터를 통해 사용자를 조회하고 최근 공개 게시물을 검색할 수 있습니다.
제한 사항
X 커넥터는 app-only Bearer 토큰을 사용하는 읽기 전용입니다. 다음은 할 수 없습니다.
- 사용자를 대신해 게시, 답글, 좋아요, 리포스트, 팔로우
- 다이렉트 메시지 전송 또는 읽기
- 보호된 계정이나 사용자의 비공개 타임라인 접근
- end-user별 X 로그인 지원. 각 연결은 연결된 모든 프로젝트에서 하나의 공유 Bearer 토큰을 사용합니다
- X API rate limit 우회. 결과를 캐싱하고,
429응답에 backoff하고, 촘촘한 폴링 루프를 피하세요
X Developer Portal에서 Bearer 토큰을 취소하거나 재생성하면 API 호출이 다시 성공하기 전에 Lovable의 연결을 새 토큰으로 업데이트하세요.
X (Twitter) 연결에서 프로젝트 연결 해제 방법
Editor 이상은 연결 전체를 삭제하지 않고 특정 프로젝트를 연결에서 제거할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용할 수 있습니다.
프로젝트 연결을 해제하려면:
Connectors 열기
Connectors를 열고 App connectors로 이동한 다음 **X (Twitter)**를 선택하세요.
연결 열기
관리할 연결을 여세요.
프로젝트 선택
Linked projects 아래에서 연결을 해제할 프로젝트를 체크하세요.
확인
Unlink projects를 클릭하고 확인하세요.
연결이 해제되면 해당 프로젝트는 이 연결을 통해 X (Twitter)에 더 이상 접근할 수 없습니다. 프로젝트에 다시 X (Twitter)가 필요하면 사용 가능한 연결에 연결할 수 있습니다.
X (Twitter) 연결 삭제 방법
워크스페이스 admin과 owner는 X (Twitter) 연결을 삭제할 수 있습니다. 다른 멤버는 자신이 만든 연결이거나 명시적으로 접근 권한을 부여받은 경우 연결을 삭제할 수 있습니다.
연결 삭제는 영구적이며 취소할 수 없습니다. 연결된 모든 프로젝트에서 자격증명이 제거되며, 이 연결을 사용하는 앱은 새 연결이 추가될 때까지 동작을 멈춥니다.
삭제하기 전에 Linked projects 섹션을 검토해 현재 어떤 프로젝트가 연결을 사용하고 있는지 확인하세요.
연결을 삭제하려면:
Connectors 열기
Connectors를 열고 App connectors로 이동한 다음 **X (Twitter)**를 선택하세요.
연결 열기
제거할 연결을 여세요.
연결된 프로젝트 검토
Linked projects 섹션을 검토하세요.
삭제
Delete this connection 아래에서 Delete를 클릭하고 확인하세요.