가장 쉬운 길 — Google Colab

설치 없이 브라우저에서: 시세 받기 → 전략으로 비중 만들기 → 규칙 검사 → 제출까지 7개 셀. 전략 셀만 자기 코드로 바꾸면 됩니다. 클라이언트 패키지(공개, 표준 라이브러리만): github.com/juho127/faip-client

!pip -q install git+https://github.com/juho127/faip-client.git
from faip_client import FAIP, equal_weight
api = FAIP()                                   # 토큰 없이 조회·검사
w = equal_weight(["AAPL","MSFT","NVDA","GOOGL"], gross=0.8)
api.validate(w)                                # 테스트 제출 (저장·채점 없음)
FAIP(token="faip-...").submit(w)               # 실제 제출 — 계정 페이지의 개인 토큰

https://faip-gateway.juho-2b6.workers.dev/mcp?token=<개인 토큰>      # Claude/ChatGPT 커스텀 커넥터 URL
claude mcp add --transport http faip https://faip-gateway.juho-2b6.workers.dev/mcp --header "Authorization: Bearer <개인 토큰>"

1. 로컬 개발·검증 (각자 시스템)

cp -r strategies/_template strategies/<내전략>   # Strategy 상속 구현
pip install -e ".[dev]" && pytest strategies/<내전략> -q
faip backtest strategies/<내전략> --mode walkforward   # 로컬 참고용

2. 다음 주 비중 미리보기

faip portfolio strategies/<내전략> --name 내이름
# → {"participant":"내이름","weights":{"AAPL":0.05,...},"gross":0.25}

3. 테스트 제출 — 규칙 검사만 (토큰 불필요)

# CLI — --test 만 붙이면 됨 (토큰 불필요)
faip submit strategies/<내전략> --name 내이름 --test \
     --gateway https://faip-gateway.juho-2b6.workers.dev

# 직접 JSON POST — /validate 붙은 경로, Authorization 헤더 불필요
curl -X POST .../api/portfolio/validate \
     -d '{"participant":"내이름","weights":{"AAPL":0.125,"MSFT":0.125}}'
curl -X POST .../api/forecast/validate \
     -d '{"participant":"내이름","probs":{"AAPL":[0.1,0.2,0.4,0.2,0.1]}}'

# 파이썬만으로 — SDK 설치 불필요 (표준 라이브러리) · 그대로 복사해 실행
import json, urllib.request
GW = "https://faip-gateway.juho-2b6.workers.dev"

def post(path, payload, token=None):
    # User-Agent 필수: urllib 기본값("Python-urllib/…")은 Cloudflare 봇 차단에 걸려 403
    hdr = {"Content-Type": "application/json", "User-Agent": "faip-student/1.0"}
    if token: hdr["Authorization"] = "Bearer " + token
    req = urllib.request.Request(GW + path, data=json.dumps(payload).encode(), headers=hdr)
    return json.load(urllib.request.urlopen(req))

w = {"AAPL": 0.125, "MSFT": 0.125}      # 내 전략이 계산한 다음 주 목표비중 (종목: 비중)
r = post("/api/portfolio/validate", {"participant": "내이름", "weights": w})
print(r["valid"], [c for c in r["checks"] if not c["ok"]])   # True [] 면 통과

4. 대회 제출 (매주 월요일 00:00 UTC = 한국시간 월요일 09:00 마감 · 개인 토큰 필수)

# 투자 트랙(필수) — --forecast 붙이면 예측 트랙도 함께
faip submit strategies/<내전략> --name 내이름 --forecast \
     --gateway https://faip-gateway.juho-2b6.workers.dev --token $FAIP_TOKEN

# 직접 JSON POST — 투자 트랙
curl -X POST .../api/portfolio -H "Authorization: Bearer $FAIP_TOKEN" \
     -d '{"participant":"내이름","weights":{"AAPL":0.125,"MSFT":0.125}}'
# 예측 트랙(선택): 종목별 주간수익률 5분위 확률
curl -X POST .../api/forecast -H "Authorization: Bearer $FAIP_TOKEN" \
     -d '{"participant":"내이름","probs":{"AAPL":[0.1,0.2,0.4,0.2,0.1]}}'

# 파이썬 — 3단계의 post() 그대로, 경로에서 /validate 만 빼고 토큰을 붙인다
TOKEN = "faip-..."                       # 계정 페이지에서 복사
print(post("/api/portfolio", {"participant": "내이름", "weights": w}, TOKEN))

5. 평가·규칙 (M6 방식 그대로)