YaparAI MCP 서버

올인원 AI 콘텐츠 제작 + 기업용 소셜 미디어, CRM 및 경쟁사 인텔리전스 — Claude Desktop, Cursor, Windsurf 및 기타 MCP 호환 AI 어시스턴트에서 직접 사용 가능.

YaparAI란 무엇인가요?

YaparAI는 콘텐츠 생성, 전자상거래 및 기업 운영 전반에 걸쳐 43가지 도구를 제공하는 올인원 AI 플랫폼입니다:

• 이미지 생성 — Flux, SDXL, Imagen 4 (텍스트-이미지, 이미지-이미지)

• 비디오 생성 — Veo 3.1, Kling (텍스트-비디오, 이미지-비디오)

• 음악 생성 — Suno v4 (보컬 및 연주곡 포함 전체 노래)

• 이미지 편집 — 배경 제거, 얼굴 교체, 스타일 전송

• 전자상거래 — 가상 착용, 제품 사진용 AI 마네킹

• 448개 이상의 템플릿 — 사전 구축된 ComfyUI 워크플로우 (로고, 광고, 제품 사진 등)

• AI 텍스트 및 비전 — Gemini 기반 텍스트 생성 및 이미지 분석

• 챗봇 — API를 통한 AI 챗봇과의 상호작용

• 소셜 미디어 — 게시, 캡션, 해시태그, 받은 편지함, AI 자동 응답, 할당량 (기업용)

• CRM — 고객 관리, AI 정보 추출, 배송, 대량 메시지 발송 (기업용)

• 경쟁사 분석 — 경쟁사 추적, KPI 비교, SWOT 스냅샷 (기업용, v0.5.0)

• 제품 카탈로그 — 조직 제품 CRUD, 재고 관리 (기업용, v0.5.0)

Related MCP server: SEO Content Autopilot by Citedy

빠른 시작

1. 설치

pip install yaparai

2. API 키 받기

1. yaparai.com에서 가입 (100 무료 크레딧 제공)

2. Settings > API Anahtarları로 이동

3. 범위 선택:

   • Personal(개인) — 본인의 크레딧, 본인의 데이터 (기본값)

   • Enterprise(기업) — 조직의 구성원인 경우, 해당 조직으로 범위가 지정된 경쟁사/제품/받은 편지함/CRM 도구를 활성화하려면 선택

4. 키를 생성하고 복사하세요 (한 번만 표시됩니다!)

3. Claude Desktop 구성

Claude Desktop 설정을 편집하세요 (Settings > Developer > Edit Config):

{
  "mcpServers": {
    "yaparai": {
      "command": "yaparai",
      "env": {
        "YAPARAI_API_KEY": "yap_live_your_key_here"
      }
    }
  }
}

조직 연결 키 (v0.5.0 이상) — 생성 시 키가 조직에 연결된 경우, 기업용 도구(경쟁사, 제품, 받은 편지함, CRM)는 자동으로 해당 조직을 사용합니다. 이전의 YAPARAI_ORG_ID 환경 변수는 선택 사항입니다. 연결된 조직을 재정의하거나 기업 작업에 개인 키를 사용하려는 경우에만 필요합니다.

4. 사용하기!

> "Generate an image of a sunset over Istanbul"
> "List available templates for logo design"
> "Which competitors have the lowest PageSpeed score?"
> "Add a new product to our catalog: Summer T-Shirt, 149 TL"
> "Show me unread DMs on Instagram"
> "Send shipping info to customer #123 — Yurtiçi, tracking ABC456"

사용 가능한 도구 (43)

콘텐츠 생성 (4)

이미지 편집 (3)

전자상거래 (2)

아바타 (1)

템플릿 (3)

AI 도구 (2)

챗봇 (2)

기업용: 소셜 미디어 (10)

기업용 API 키(조직 연결) 또는 YAPARAI_ORG_ID가 필요합니다.

기업용: CRM (6)

기업용: 경쟁사 분석 — v0.5.0 (3)

기업용: 제품 카탈로그 — v0.5.0 (3)

유틸리티 (4)

구성

어떤 키를 생성해야 하나요?

Cursor / Windsurf / Claude Code

MCP 설정에서 동일한 구성 형식 사용:

{
  "yaparai": {
    "command": "yaparai",
    "env": {
      "YAPARAI_API_KEY": "yap_live_your_key_here"
    }
  }
}

Python SDK 사용법

import asyncio
from yaparai.client import YaparAIClient

async def main():
    client = YaparAIClient(api_key="yap_live_your_key_here")

    # Generate an image
    job = await client.generate({"type": "image", "prompt": "A futuristic city"})
    result = await client.wait_for_result(job["job_id"])
    print(result["result_url"])

    # Compare competitors (v0.5.0 — org-bound API key)
    comparison = await client.enterprise_compare_competitors(
        ["uuid-1", "uuid-2", "uuid-3"]
    )
    print(comparison)

    # Add a product (v0.5.0)
    product = await client.enterprise_create_org_product({
        "name": "Summer T-Shirt",
        "price": 149,
        "stock_status": "in_stock",
        "category": "apparel",
    })
    print(product)

asyncio.run(main())

신뢰성 (v0.4.0 이상)

• 지수 백오프 재시도 — 네트워크 오류 시 3회 재시도 (1초 → 2초 → 4초 + 지터), 속도 제한 인식 (429 → 5초/10초/15초)

• platform, model, style, output_format에 대한 리터럴 타입 주석 — IDE 자동 완성을 통해 잘못된 값을 조기에 포착

• 구조화된 로깅 — 디버그 추적을 위한 logging.getLogger("yaparai")

• HTTP 클라이언트, 생성, 편집, 소셜, CRM, 조직 확인에 대한 32개의 단위 테스트

• Python 3.10 / 3.11 / 3.12 CI + ruff 린트

가격

• 가입 시 100 무료 크레딧 (신용카드 불필요)

• 이미지: 6 크레딧 ($0.50)

• 비디오: 350 크레딧 ($3–5)

• 음악: 14 크레딧 ($1)

• 기업용 기능: 구독에 포함

• 크레딧은 만료되지 않음

가격 보기

링크

• 웹사이트: yaparai.com

• 기업용 포털: kurumsal.yaparai.com

• 갤러리: yaparai.com/gallery

• API 키: yaparai.com/settings (개인) · kurumsal.yaparai.com/settings?tab=api-keys (조직 연결)

• 지원: destek@yaparai.com

릴리스 노트

• v0.5.0 (2026-04-21) — 6가지 새로운 기업용 도구(경쟁사 분석 + 제품 카탈로그), 조직 연결 API 키

• v0.4.0 (2026-04-21) — 2가지 새로운 도구, 재시도 + 로깅, 리터럴 타입, 전체 테스트 스위트. @enis1998님의 커뮤니티 기여

• v0.3.1 — FastMCP 3.x 호환성

• v0.3.0 — 30가지 도구, 전체 플랫폼 커버리지

• v0.2.0 — 13가지 도구, PyPI 준비 완료

전체 기록: CHANGELOG.md

기여자

YaparAI MCP에 기여해주신 모든 분께 감사드립니다!

• @ilhankilic — 제작자 및 관리자

• @enis1998 — v0.4.0: 2가지 새로운 도구, 재시도 메커니즘, 타입 안전성, 테스트 스위트

기여하고 싶으신가요? CONTRIBUTING.md를 확인하세요.

라이선스

Apache 2.0 — LICENSE 참조