YaparAI MCP 服务器

一体化 AI 内容创作 + 企业社交媒体、CRM 和竞争对手情报 — 直接从 Claude Desktop、Cursor、Windsurf 以及其他兼容 MCP 的 AI 助手中使用。

什么是 YaparAI？

YaparAI 是一个一体化 AI 平台，拥有 43 种工具，涵盖内容生成、电子商务和企业运营：

• 图像生成 — Flux、SDXL、Imagen 4（文生图、图生图）

• 视频生成 — Veo 3.1、Kling（文生视频、图生视频）

• 音乐生成 — Suno v4（包含人声和伴奏的完整歌曲）

• 图像编辑 — 背景移除、换脸、风格迁移

• 电子商务 — 虚拟试穿、产品照片 AI 模特

• 448+ 模板 — 预构建的 ComfyUI 工作流（Logo、广告、产品照片等）

• 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 Key

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 次 (1s → 2s → 4s + 抖动)，感知速率限制 (429 → 5s/10s/15s)

• 字面类型注解 — platform、model、style、output_format 具有字面类型注解，IDE 自动补全可提前捕获错误值

• 结构化日志 — 使用 logging.getLogger("yaparai") 进行调试追踪

• 32 个单元测试 — 涵盖 HTTP 客户端、生成、编辑、社交、CRM、组织解析

• CI 支持 Python 3.10 / 3.11 / 3.12 + ruff lint

定价

• 注册赠送 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