x-paper 프로젝트 리서치

1. 프로젝트 개요

1.1 목표

Slack 채널에서 https://arxiv.org/abs/ URL이 발견되면 해당 논문을 자동으로 분석하여 요약(노벨티, 메소드, 결론 등)을 제공하는 봇

x-paper 수동 설정 가이드

이 문서는 사용자가 직접 수행해야 하는 권한이 필요한 작업들을 안내합니다.

---

1. Anthropic Claude API 설정

1.1 API 키 발급

1. Anthropic Console 접속
2. 로그인 또는 회원가입
3. API Keys 메뉴로 이동
4. Create Key 클릭
5. 키 이름 입력 (예: x-paper)
6. 생성된 키 복사 (sk-ant-api03-...)

1.2 환경변수 설정

# .env 파일에 추가
ANTHROPIC_API_KEY=sk-ant-api03-your-key-here

---

2. Slack 앱 생성 및 설정

2.1 Slack 앱 생성

1. Slack API 접속
2. Create New App 클릭
3. From scratch 선택
4. 앱 이름: x-paper
5. 워크스페이스 선택
6. Create App 클릭

2.2 Bot Token Scopes 설정

1. 좌측 메뉴 OAuth & Permissions 클릭
2. Scopes 섹션에서 Bot Token Scopes 찾기
3. Add an OAuth Scope 클릭하여 다음 권한 추가:

Scope	용도
app_mentions:read	봇 멘션 감지
channels:history	채널 메시지 읽기
channels:read	채널 정보 조회
chat:write	메시지 전송
reactions:write	리액션 추가

2.3 Event Subscriptions 설정

1. 좌측 메뉴 Event Subscriptions 클릭
2. Enable Events 토글 ON
3. Subscribe to bot events 에서 추가:

Event	용도
message.channels	채널 메시지 이벤트
app_mention	앱 멘션 이벤트

4. Save Changes 클릭

2.4 Socket Mode 활성화 (개발용)

1. 좌측 메뉴 Socket Mode 클릭
2. Enable Socket Mode 토글 ON
3. App-Level Token 생성:
   • Token Name: x-paper-socket
   • Scope: connections:write
4. 생성된 토큰 복사 (xapp-...)

2.5 앱 설치 및 토큰 획득

1. 좌측 메뉴 OAuth & Permissions 클릭
2. Install to Workspace 클릭
3. 권한 허용
4. Bot User OAuth Token 복사 (xoxb-...)
5. 좌측 메뉴 Basic Information 클릭
6. Signing Secret 복사

2.6 환경변수 설정

# .env 파일에 추가
SLACK_BOT_TOKEN=xoxb-your-bot-token
SLACK_SIGNING_SECRET=your-signing-secret
SLACK_APP_TOKEN=xapp-your-app-token

2.7 채널에 앱 추가

1. Slack에서 봇을 추가할 채널 열기
2. 채널 이름 클릭 → Integrations 탭
3. Add apps 클릭
4. x-paper 검색 후 추가

---

3. 프로덕션 배포 (HTTP Mode)

Socket Mode 대신 HTTP Mode로 배포할 경우:

3.1 Request URL 설정

1. Event Subscriptions 메뉴
2. Request URL 에 서버 주소 입력:

   https://your-server.com/slack/events
   

3. Slack이 URL 검증 요청을 보내면 봇이 응답해야 함

3.2 서버 요구사항

• HTTPS 필수 (SSL 인증서)
• 공인 IP 또는 도메인
• 포트 개방 (기본 3000)

---

4. 체크리스트

필수 설정

• Anthropic API 키 발급
• Slack 앱 생성
• Bot Token Scopes 설정
• Event Subscriptions 설정
• Socket Mode 활성화 (또는 HTTP URL 설정)
• 워크스페이스에 앱 설치
• 채널에 앱 추가
• .env 파일에 모든 토큰/키 설정

환경변수 확인

# 필수
ANTHROPIC_API_KEY=sk-ant-api03-...

# Slack (봇 사용 시)
SLACK_BOT_TOKEN=xoxb-...
SLACK_SIGNING_SECRET=...
SLACK_APP_TOKEN=xapp-...  # Socket Mode

# 선택
SLACK_CHANNEL=#papers
SLACK_AUTO_ANALYZE=false

---

5. 문제 해결

Slack 연결 실패

• Bot Token이 올바른지 확인
• Socket Mode 사용 시 App Token 확인
• 앱이 채널에 추가되었는지 확인

이벤트가 수신되지 않음

• Event Subscriptions가 활성화되었는지 확인
• 필요한 이벤트가 구독되었는지 확인
• 앱이 해당 채널에 추가되었는지 확인

권한 오류

• Bot Token Scopes에 필요한 권한이 있는지 확인
• 앱 재설치 필요할 수 있음 (권한 추가 후)