o2o-clinicad-frontend/docs/API_CONNECTORS.md

263 lines
11 KiB
Markdown

# INFINITH — API & MCP Connector Registry
**Version:** 1.0 | **Updated:** 2026-03-24 | **Status:** Backend Development Ready
---
## 1. Currently Connected (이미 연결됨)
| Service | Purpose | Status | Dashboard |
|---------|---------|--------|-----------|
| [Firecrawl](https://docs.firecrawl.dev/introduction) | 웹사이트 스크래핑, 콘텐츠 추출, 스크린샷 | **Credits 소진** | [Recharge](https://www.firecrawl.dev/pricing) |
| [Ahrefs API](https://docs.ahrefs.com/docs/api/reference/introduction) | 키워드 분석, 백링크, 도메인 레이팅 | **Connected** | [Dashboard](https://ahrefs.com/dashboard) |
| [Figma MCP](https://developers.figma.com/) | 디자인 에셋 읽기, 브랜드 변수 추출 | **Connected** | [Developer](https://developers.figma.com/) |
| [Slack MCP](https://api.slack.com/) | 팀 알림, 채널 메시징 | **Connected** | [API](https://api.slack.com/) |
| [Notion MCP](https://developers.notion.com/) | 문서/DB 관리, 리포트 저장 | **Connected** | [Integrations](https://www.notion.so/my-integrations) |
| [Google Drive](https://console.cloud.google.com/) | 파일 저장/공유 | **Connected** | [Console](https://console.cloud.google.com/) |
| [Gemini (nano-banana-pro)](https://aistudio.google.com/) | AI 이미지 생성/편집 | **Connected** | [AI Studio](https://aistudio.google.com/) |
---
## 2. P0 — 즉시 연결 필요 (Phase 1 Backend)
### 2.1 Apify — 소셜미디어 통합 스크래핑
| Item | Link |
|------|------|
| **가입** | https://console.apify.com/sign-up |
| **API 문서** | https://docs.apify.com/api/v2 |
| **가격** | https://apify.com/pricing |
| **MCP 서버 (GitHub)** | https://github.com/apify/apify-mcp-server |
| **MCP 서버 (npm)** | `npx @apify/actors-mcp-server` |
| **MCP 연동 가이드** | https://docs.apify.com/platform/integrations/mcp |
| **용도** | Instagram/Facebook/YouTube/TikTok 프로필 스크래핑, 스크린샷 배치 캡쳐, 에셋 다운로드 |
| **예상 비용** | $49/mo (Starter) — 100 Actor runs/day |
### 2.2 YouTube Data API v3 — 채널 분석
| Item | Link |
|------|------|
| **API 활성화** | https://console.cloud.google.com/apis/library/youtube.googleapis.com |
| **시작 가이드** | https://developers.google.com/youtube/v3/getting-started |
| **API 레퍼런스** | https://developers.google.com/youtube/v3/docs |
| **MCP 서버** | https://github.com/sparfenyuk/mcp-youtube (`npx yt-mcp`) |
| **용도** | 채널 통계, 구독자, 영상 목록, 조회수, 댓글 분석 |
| **예상 비용** | 무료 (일 10,000 units quota) |
### 2.3 Naver Search API — 한국 로컬 검색
| Item | Link |
|------|------|
| **개발자 센터** | https://developers.naver.com/ |
| **API 목록** | https://naver.github.io/naver-openapi-guide/apilist.html |
| **MCP 서버 (GitHub)** | https://github.com/isnow890/naver-search-mcp |
| **MCP 서버 (npm)** | `npx @isnow890/naver-search-mcp` |
| **Naver Shopping Insight MCP** | https://github.com/dataartai/naver-api-mcp |
| **용도** | 블로그/카페/뉴스 검색, 키워드 볼륨 분석 |
| **예상 비용** | 무료 (일 25,000건) |
### 2.4 Supabase — 백엔드 인프라 (Auth + DB + Storage)
| Item | Link |
|------|------|
| **Dashboard** | https://supabase.com/dashboard |
| **문서** | https://supabase.com/docs |
| **MCP 서버 (GitHub)** | https://github.com/supabase-community/supabase-mcp |
| **MCP 서버 (npm)** | `npx @supabase/mcp-server-supabase` |
| **MCP 가이드** | https://supabase.com/docs/guides/getting-started/mcp |
| **용도** | PostgreSQL DB, 인증(OAuth), 파일 스토리지, Realtime |
| **예상 비용** | 무료 (Free tier: 500MB DB, 1GB Storage) |
### 2.5 Claude / Anthropic API — AI 엔진
| Item | Link |
|------|------|
| **Console (API Keys)** | https://console.anthropic.com/ |
| **API 문서** | https://docs.anthropic.com/en/docs/get-started |
| **Platform 문서** | https://platform.claude.com/docs/en/home |
| **용도** | 마케팅 분석 리포트 AI 생성, 콘텐츠 생성, 전략 수립 |
| **예상 비용** | Usage-based (Sonnet: $3/1M input, $15/1M output) |
---
## 3. P1 — Phase 2 연결 (AI Agent + Content Creation)
### 3.1 Perplexity API — AI 검색 + AEO
| Item | Link |
|------|------|
| **가입** | https://www.perplexity.ai/api-platform |
| **API Key 설정** | https://www.perplexity.ai/settings/api |
| **문서** | https://docs.perplexity.ai/ |
| **가격** | https://docs.perplexity.ai/docs/getting-started/pricing |
| **MCP 서버 (공식)** | https://github.com/perplexityai/modelcontextprotocol |
| **MCP 서버 (npm)** | `npx @perplexity-ai/mcp-server` |
| **용도** | AI 기반 웹 검색, AEO(Answer Engine Optimization) 최적화, 트렌드 분석 |
### 3.2 Creatomate API — 영상/이미지 자동 생성
| Item | Link |
|------|------|
| **가입** | https://creatomate.com/ |
| **API 문서** | https://creatomate.com/docs/api/introduction |
| **가격** | https://creatomate.com/pricing |
| **Developer Hub** | https://creatomate.com/developers |
| **용도** | 템플릿 기반 영상/이미지 생성, 숏폼 자동 제작, 소셜 포맷별 리사이즈 |
| **예상 비용** | $49/mo (Pro: 월 100 renders) |
### 3.3 Instagram / Facebook Graph API — 공식 게시/분석
| Item | Link |
|------|------|
| **Meta Developer Portal** | https://developers.facebook.com/ |
| **앱 생성** | https://developers.facebook.com/apps/ |
| **Instagram API 문서** | https://developers.facebook.com/docs/instagram-platform/ |
| **Instagram API Reference** | https://developers.facebook.com/docs/instagram-platform/reference/ |
| **Facebook Graph API 문서** | https://developers.facebook.com/docs/graph-api/ |
| **Graph API Get Started** | https://developers.facebook.com/docs/graph-api/get-started/ |
| **용도** | SNS 자동 게시, Reels 업로드, 인사이트 데이터 수집 |
| **예상 비용** | 무료 |
### 3.4 Google Search Console API — SEO 성과
| Item | Link |
|------|------|
| **API 활성화** | https://console.cloud.google.com/apis/library/searchconsole.googleapis.com |
| **문서** | https://developers.google.com/webmaster-tools |
| **용도** | 검색 노출량, CTR, 키워드 순위 변동 추적 |
| **예상 비용** | 무료 |
### 3.5 Google Analytics 4 API — 웹 트래픽
| Item | Link |
|------|------|
| **API 활성화** | https://console.cloud.google.com/apis/library/analyticsdata.googleapis.com |
| **Quickstart** | https://developers.google.com/analytics/devguides/reporting/data/v1/quickstart |
| **용도** | 웹사이트 유입 경로, 전환 데이터, 세션 분석 |
| **예상 비용** | 무료 |
---
## 4. P2 — 고도화 단계
### 4.1 Naver Place / Map API
| Item | Link |
|------|------|
| **Naver Cloud** | https://www.ncloud.com/ |
| **Map API** | https://www.ncloud.com/v2/product/applicationService/maps |
| **API 문서** | https://api.ncloud-docs.com/docs/common-ncpapi |
| **MCP 서버** | https://github.com/num2k/naver-map-mcp |
| **용도** | 플레이스 정보, 병원 리뷰, 위치 데이터 |
### 4.2 Google Maps Places API
| Item | Link |
|------|------|
| **API 활성화** | https://console.cloud.google.com/google/maps-apis/overview |
| **API Key 발급** | https://developers.google.com/maps/documentation/places/web-service/get-api-key |
| **Places API 문서** | https://developers.google.com/maps/documentation/places/web-service/overview |
| **용도** | 구글 리뷰, 평점, 위치 정보, 경쟁 병원 분석 |
| **예상 비용** | $17/1,000 requests |
### 4.3 Google Vision API
| Item | Link |
|------|------|
| **API 활성화** | https://console.cloud.google.com/apis/library/vision.googleapis.com |
| **문서** | https://docs.cloud.google.com/vision/docs/setup |
| **가격** | https://cloud.google.com/vision/pricing |
| **용도** | 로고 감지, 브랜드 컬러 자동 추출, 이미지 분석 |
| **예상 비용** | $1.50/1,000 images |
### 4.4 Brandfetch API
| Item | Link |
|------|------|
| **가입** | https://developers.brandfetch.com/register |
| **문서** | https://docs.brandfetch.com/ |
| **Brand API** | https://docs.brandfetch.com/brand-api/overview |
| **가격** | https://brandfetch.com/developers/pricing |
| **용도** | 도메인 → 브랜드 로고/컬러/폰트 자동 추출 |
### 4.5 TikTok API
| Item | Link |
|------|------|
| **Developer Portal** | https://developers.tiktok.com/ |
| **문서** | https://developers.tiktok.com/doc/overview |
| **Business API** | https://business-api.tiktok.com/portal |
| **Business API 가입** | https://business-api.tiktok.com/portal/developer/register |
| **용도** | TikTok 영상 게시, 계정 통계, 트렌드 분석 |
### 4.6 Canva Connect API
| Item | Link |
|------|------|
| **Developer Portal** | https://www.canva.dev/ |
| **문서** | https://www.canva.dev/docs/connect/ |
| **Quickstart** | https://www.canva.dev/docs/connect/quickstart/ |
| **용도** | 템플릿 기반 이미지 Autofill (Enterprise 전용) |
### 4.7 Puppeteer (서버사이드 스크린샷)
| Item | Link |
|------|------|
| **npm** | https://www.npmjs.com/package/puppeteer |
| **문서** | https://pptr.dev/ |
| **GitHub** | https://github.com/puppeteer/puppeteer |
| **용도** | 서버사이드 웹페이지 스크린샷 캡쳐 (분석 근거 자료) |
| **예상 비용** | 무료 (OSS) |
---
## 5. MCP 서버 Quick Reference
### 즉시 연결 (P0)
```bash
# Apify — 소셜미디어 스크래핑 통합
npx @apify/actors-mcp-server
# Supabase — Auth + DB + Storage
npx @supabase/mcp-server-supabase
# Naver Search — 한국 로컬 검색
npx @isnow890/naver-search-mcp
# YouTube — 채널 분석
npx yt-mcp
```
### Phase 2 연결 (P1)
```bash
# Perplexity — AI 검색
npx @perplexity-ai/mcp-server
# Stripe — 글로벌 결제 (B2B 계약 전환 후)
npx @stripe/mcp
# Naver Map — 플레이스 분석
# https://github.com/num2k/naver-map-mcp
```
### 이미 연결됨
```
Firecrawl ── 웹 스크래핑 (크레딧 충전 필요)
Ahrefs ───── SEO/키워드 분석
Figma ────── 디자인 에셋
Slack ────── 팀 커뮤니케이션
Notion ───── 문서/DB
Google Drive ── 파일 관리
Gemini ───── AI 이미지 생성
```
---
## 6. 월간 예상 비용 (MVP 기준)
| Service | Plan | 월 비용 | 비고 |
|---------|------|--------|------|
| Supabase | Free | ₩0 | 500MB DB, 1GB Storage |
| YouTube Data API | Free | ₩0 | 일 10K units |
| Naver Search API | Free | ₩0 | 일 25K건 |
| Anthropic (Claude) | Usage | ~₩50,000 | 리포트 100건/월 기준 |
| Apify | Starter | ~₩65,000 | $49/mo |
| Firecrawl | Growth | ~₩26,000 | $19/mo |
| Creatomate | Pro | ~₩65,000 | $49/mo (Phase 2) |
| **Phase 1 합계** | | **~₩141,000/mo** | Supabase+YouTube+Naver+Claude+Apify+Firecrawl |
| **Phase 2 합계** | | **~₩206,000/mo** | + Creatomate |
---
## 7. 결제 시스템
> **현재 전략: B2B 계약 우선**
> Stripe / Toss Payments 결제 시스템은 B2C 전환 시점에 개발 예정.
> 현재는 수동 청구서 발행으로 진행.
---
*Last updated: 2026-03-24*