실습 사전 준비 — 계정·키·툴

0. 발급 체크리스트 한 장

1. n8n 설치 (둘 중 하나)

옵션 A — Docker Self-host (권장)

docker run -it --rm --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  n8nio/n8n

브라우저에서 http://localhost:5678 → 초기 계정 생성. 데이터는 docker volume에 영속 저장.

옵션 B — n8n Cloud

n8n.io 가입 → 14일 무료 트라이얼 → https://your-workspace.app.n8n.cloud

2. Google OAuth (W1, W2, W3 — Sheets 트리거)

1. Google Cloud Console → 새 프로젝트
2. API Library에서 Google Sheets API · Gmail API · Drive API 활성화
3. OAuth consent screen → External → 앱 이름 입력 → Test users에 본인 Gmail 추가
4. Credentials → Create OAuth client ID → Web application
   • Cloud: https://oauth.n8n.cloud/oauth2/callback
   • Self-host: http://localhost:5678/rest/oauth2-credential/callback
5. Client ID/Secret을 n8n credential에 등록 → "Sign in with Google" 클릭 인증

3. Anthropic Claude (W3 분류 / W4 Vision / W7 에이전트)

1. console.anthropic.com 가입 → $5 free credit
2. API Keys → Create Key → 발급 즉시 복사 (이후 마스킹)
3. n8n에 HTTP Request 노드로 호출 (Anthropic SDK 노드 미내장이면 HTTP로 직접):
   • URL: https://api.anthropic.com/v1/messages
   • Header: x-api-key: $key · anthropic-version: 2023-06-01
4. 모델 권장: 분류는 claude-haiku-4-5-20251001 (저비용), Vision은 claude-sonnet-4-5-20250929

4. Supabase pgvector (W5 첫 RAG)

1. supabase.com 가입 → 새 Project (region 가까운 곳)
2. SQL Editor에서:

   create extension if not exists vector;
   
   create table embeddings (
     id bigserial primary key,
     content text,
     metadata jsonb,
     embedding vector(1536)
   );
   
   create index on embeddings using ivfflat (embedding vector_cosine_ops);

3. Project Settings → API → URL + service_role key 복사
4. n8n에서 HTTP Request 또는 Supabase 노드로 insert/select

5. Cohere Rerank (W6 Hybrid)

1. cohere.com → Trial Key 발급 (무료 1000 req/month)
2. HTTP 호출:

   POST https://api.cohere.com/v1/rerank
   {
     "model": "rerank-multilingual-v3.0",
     "query": "{{질문}}",
     "documents": [{검색결과 5~20개}],
     "top_n": 5
   }

6. Alpha Vantage (W3 뉴스)

alphavantage.co 무료 키 발급. 5 req/min · 500 req/day.

GET https://www.alphavantage.co/query
  ?function=NEWS_SENTIMENT
  &tickers=AAPL,TSLA
  &apikey={key}

응답에 종목별 sentiment_score, relevance_score, ticker_sentiment 배열 포함 → W3 워크플로우가 그대로 사용.

7. Chart-IMG (W4 차트 이미지)

chart-img.com 가입 → API Key. 차트 이미지를 PNG로 받아 Claude Vision에 첨부.

GET https://api.chart-img.com/v2/tradingview/advanced-chart
  ?symbol=NASDAQ:AAPL
  &interval=1D
  &theme=dark
  &studies=RSI,MACD

8. Alpaca Paper (W8)

1. alpaca.markets 가입 → 좌측 메뉴 Paper Trading 전환
2. API Keys → Generate New Key → APCA-API-KEY-ID + APCA-API-SECRET-KEY
3. Base URL https://paper-api.alpaca.markets · 현재가는 https://data.alpaca.markets

9. 한국투자증권 모의투자 (SP)

1. openapi.koreainvestment.com 가입
2. 모의투자 신청 (실 계좌 신청 X) → App Key/Secret 발급
3. 접근 토큰 발급:

   POST https://openapivts.koreainvestment.com:29443/oauth2/tokenP
   {
     "grant_type":"client_credentials",
     "appkey":"...",
     "appsecret":"..."
   }

4. 주문 시 HashKey 서명 별도 — SP 가이드에서 상세 다룸

10. 트러블슈팅 빠른 참조