Servidor MCP de YaparAI

Plataforma integral de creación de contenido con IA + redes sociales empresariales, CRM e inteligencia competitiva, directamente desde Claude Desktop, Cursor, Windsurf y otros asistentes de IA compatibles con MCP.

¿Qué es YaparAI?

YaparAI es una plataforma de IA integral con 43 herramientas que abarcan la generación de contenido, el comercio electrónico y las operaciones empresariales:

• Generación de imágenes — Flux, SDXL, Imagen 4 (texto a imagen, imagen a imagen)

• Generación de vídeo — Veo 3.1, Kling (texto a vídeo, imagen a vídeo)

• Generación de música — Suno v4 (canciones completas con voz, instrumentales)

• Edición de imágenes — Eliminación de fondo, intercambio de rostros, transferencia de estilo

• Comercio electrónico — Probador virtual, maniquí con IA para fotos de productos

• Más de 448 plantillas — Flujos de trabajo de ComfyUI preconfigurados (logotipos, anuncios, fotos de productos...)

• Texto y visión con IA — Generación de texto y análisis de imágenes impulsados por Gemini

• Chatbots — Interactúa con chatbots de IA a través de API

• Redes sociales — Publicación, subtítulos, hashtags, bandeja de entrada, respuesta automática con IA, cuota (Empresarial)

• CRM — Gestión de clientes, extracción de información con IA, envíos, mensajería masiva (Empresarial)

• Análisis de la competencia — Seguimiento de competidores, comparación de KPI, instantáneas DAFO (Empresarial, v0.5.0)

• Catálogo de productos — CRUD de productos de la organización, gestión de stock (Empresarial, v0.5.0)

Related MCP server: SEO Content Autopilot by Citedy

Inicio rápido

1. Instalación

pip install yaparai

2. Obtén tu clave API

1. Regístrate en yaparai.com (100 créditos gratuitos)

2. Ve a Settings > API Anahtarları

3. Elige el alcance:

   • Personal — tus créditos, tus datos (predeterminado)

   • Empresarial — si eres miembro de una organización, selecciónala para habilitar las herramientas de competidores/productos/bandeja de entrada/CRM vinculadas a esa organización

4. Crea la clave y cópiala (¡solo se muestra una vez!)

3. Configura Claude Desktop

Edita tu configuración de Claude Desktop (Settings > Developer > Edit Config):

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

Claves vinculadas a la organización (v0.5.0+) — si tu clave está vinculada a una organización durante la creación, las herramientas empresariales (competidores, productos, bandeja de entrada, CRM) utilizan automáticamente esa organización. La antigua variable de entorno YAPARAI_ORG_ID es opcional; solo es necesaria si deseas anular la organización vinculada o usar una clave personal para acciones empresariales.

4. ¡Úsalo!

> "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"

Herramientas disponibles (43)

Generación de contenido (4)

Edición de imágenes (3)

Comercio electrónico (2)

Avatar (1)

Plantillas (3)

Herramientas de IA (2)

Chatbot (2)

Empresarial: Redes sociales (10)

Requiere una clave API empresarial (vinculada a la organización) o YAPARAI_ORG_ID.

Empresarial: CRM (6)

Empresarial: Análisis de la competencia — v0.5.0 (3)

Empresarial: Catálogo de productos — v0.5.0 (3)

Utilidad (4)

Configuración

¿Qué clave debo crear?

Cursor / Windsurf / Claude Code

Mismo formato de configuración en los ajustes de MCP:

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

Uso del SDK de Python

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())

Fiabilidad (v0.4.0+)

• Reintento con retroceso exponencial — 3 reintentos en errores de red (1s → 2s → 4s + fluctuación), consciente de los límites de tasa (429 → 5s/10s/15s)

• Anotaciones de tipo literal en platform, model, style, output_format — el autocompletado del IDE detecta valores incorrectos rápidamente

• Registro estructurado — logging.getLogger("yaparai") para trazabilidad de depuración

• 32 pruebas unitarias en cliente HTTP, generación, edición, redes sociales, CRM, resolución de organización

• CI en Python 3.10 / 3.11 / 3.12 + linter ruff

Precios

• 100 créditos gratuitos al registrarse (no se requiere tarjeta de crédito)

• Imagen: ~6 créditos (~0,50 $)

• Vídeo: ~350 créditos (~3–5 $)

• Música: ~14 créditos (~1 $)

• Funciones empresariales: incluidas con la suscripción

• Los créditos nunca caducan

Ver precios

Enlaces

• Sitio web: yaparai.com

• Portal empresarial: kurumsal.yaparai.com

• Galería: yaparai.com/gallery

• Claves API: yaparai.com/settings (personal) · kurumsal.yaparai.com/settings?tab=api-keys (vinculada a organización)

• Soporte: destek@yaparai.com

Notas de la versión

• v0.5.0 (2026-04-21) — 6 nuevas herramientas empresariales (análisis de la competencia + catálogo de productos), claves API vinculadas a la organización

• v0.4.0 (2026-04-21) — 2 nuevas herramientas, reintento + registro, tipos literales, suite de pruebas completa. Contribución de la comunidad por @enis1998

• v0.3.1 — Compatibilidad con FastMCP 3.x

• v0.3.0 — 30 herramientas, cobertura total de la plataforma

• v0.2.0 — 13 herramientas, listo para PyPI

Historial completo: CHANGELOG.md

Colaboradores

¡Gracias a todos los que han contribuido a YaparAI MCP!

• @ilhankilic — Creador y mantenedor

• @enis1998 — v0.4.0: 2 nuevas herramientas, mecanismo de reintento, seguridad de tipos, suite de pruebas

¿Quieres contribuir? Echa un vistazo a CONTRIBUTING.md.

Licencia

Apache 2.0 — ver LICENSE