Cloudwiki

Claude 보고서/외부 서비스 연동

연동·활용을 검토할 만한 외부 서비스와 API 입니다. **Cloudflare 에서 즉시 바인딩 가능한 것을 우선**하고, 외부 서비스도 함께 정리합니다. 상위 문서: [[Claude 보고서]].

노트: 이미 사용 중인 Cloudflare 리소스
D1(`DB`) · R2(`MEDIA`) · KV · Analytics Engine(`ANALYTICS`) · ASSETS · cron 트리거 · Web Push(VAPID) · Turnstile(편집 페이지) · Discord 웹훅. → 아래는 **추가 도입** 후보입니다.


## Cloudflare 네이티브 (우선 검토)


AI · 검색
| 서비스 | 용도 | 즉시성 |
| --- | --- | :---: |
| **Workers AI** | 임베딩 생성, 요약, 번역, 콘텐츠 모더레이션, "위키에 질문하기"(RAG) |  바인딩 |
| **Vectorize** | 벡터 DB — 시맨틱 검색·관련 문서·RAG. 임베딩과 페어 |  바인딩 |
| **AI Gateway** | LLM 호출 캐싱·레이트리밋·로깅·비용 제어(MCP/AI 기능 앞단) |  즉시 |

> **검색 랭킹 한계([[Claude 보고서/개선점]])** 의 핵심 해법: 기존 D1 FTS5 키워드 검색 + Vectorize 시맨틱 검색의 **하이브리드**.

실시간 · 비동기
| 서비스 | 용도 | 즉시성 |
| --- | --- | :---: |
| **Durable Objects** | 실시간 공동 편집(Yjs/CRDT)·접속 표시·동시편집 조율(현재 KV 감지의 상위 호환) |  바인딩 |
| **Queues** | 비동기 작업: 미디어 GC, 웹훅 팬아웃, 푸시 배치, 검색 재색인, 이메일 발송 |  바인딩 |
| **Workflows** | 내구성 다단계 오케스트레이션: 가입 승인 파이프라인, 예약 발행, 대량 임포트, 리비전 정리 |  바인딩 |

미디어 · 출력
| 서비스 | 용도 | 즉시성 |
| --- | --- | :---: |
| **Browser Rendering** | PDF/인쇄 내보내기, 페이지별 OG 소셜 카드 생성, 썸네일 스크린샷 |  바인딩 |
| **Cloudflare Images** | 서버사이드 리사이즈/포맷 변환(AVIF/WebP)·반응형 변형(현재 CSS 힌트만 존재) |  유료 |
| **Stream** | 자체 동영상 호스팅(현재는 YouTube/니코니코 임베드) |  유료 |
| **R2 Event Notifications** | 업로드 시 GC/후처리 트리거 |  즉시 |

알림 · 보안 · 관측
| 서비스 | 용도 | 즉시성 |
| --- | --- | :---: |
| **Email Routing + Email Workers** | 인바운드 이메일→티켓/문서, (발송기 결합 시) **이메일 알림 채널** |  바인딩 |
| **Turnstile (확대)** | 가입·티켓·토론까지 캡차리스 봇 차단 |  즉시 |
| **Rate Limiting / WAF** | API·MCP 남용 방어 |  대시보드 |
| **Logpush / Tail Workers** | 구조화 로그·에러 경보 |  즉시 |
| **Web Analytics** | 프라이버시 친화 페이지뷰(Analytics Engine 보완) |  즉시 |



노트: 해당 없음
**Hyperdrive** 는 외부 Postgres 가속용이라 D1 네이티브인 본 프로젝트엔 불필요. **Pages** 도 Workers+ASSETS 구조라 불필요.


## 외부 서비스 (보완 옵션)

| 서비스 | 용도 | 비고 |
| --- | --- | --- |
| **Anthropic Claude API** | 요약·Q&A·문서 정리(AI Gateway 경유) | MCP 가 이미 Claude 협업 전제 |
| **Resend / Postmark / MailChannels** | 트랜잭션 이메일 발송 | Email Workers 와 결합 |
| **Sentry** | 에러 모니터링 | Logpush 대안/보완 |
| **GitHub API** | Git 식 콘텐츠 백업/내보내기 | Wiki.js 의 Git 동기화 흉내 |
| **DeepL / Crowdin** | 번역 API / 번역 관리 | i18n 도입 시 |
| **Meilisearch / Typesense / Algolia** | 외부 검색 엔진 | 단, Vectorize+D1 온플랫폼 우선 권장 |

팁: 추천 1순위
**Workers AI + Vectorize**(시맨틱 검색·RAG) 와 **Durable Objects**(실시간 공동 편집), 그리고 **Email Workers**(이메일 알림) 가 사용자 체감 가치와 플랫폼 적합성 모두에서 최우선입니다.