SDK para desarrolladores

SDK de Modiva: un cliente de API para cada lenguaje

SDK oficiales de código abierto para Node.js, Python, Go, Ruby, Java, PHP, .NET y Rust. Un cliente tipado llega a todas las 38 integraciones y 460+ herramientas en social, ads, CRM y e-commerce, con autenticación, reintentos, paginación e idempotencia gestionados por ti.

Consigue tu clave de API Lee la documentación Explora en GitHub

Lenguajes

Integraciones

460+

Herramientas

MIT

Código abierto

Elige tu lenguaje

Cada SDK sigue el mismo contrato, así que la documentación y los ejemplos se trasladan entre lenguajes. Instala un paquete y tienes toda la API.

Node 18+

Node.js / TypeScript

npm i @modiva/node

Guía del SDK de Node.js →

Python 3.9+

Python

pip install modiva

Guía del SDK de Python →

Go 1.21+

go get modiva.ai/go

Guía del SDK de Ruby →

Java 17+

Java

ai.modiva:sdk:0.1.0

Guía del SDK de Java →

PHP 8.1+

PHP

composer require modiva/sdk

Guía del SDK de PHP →

net8.0

.NET / C#

dotnet add package Modiva

Guía del SDK de .NET →

async / Tokio

Rust

cargo add modiva

Guía del SDK de Rust →

Inicio rápido

Instala el SDK, define MODIVA_API_KEY y publicas en pocas líneas. Aquí tienes el mismo flujo en Node.js y Python.

Node.js / TypeScript

import { Modiva } from "@modiva/node";

const modiva = new Modiva(); // reads MODIVA_API_KEY

// List connected accounts
const connections = await modiva.connections.list();

// Publish a post (or schedule with scheduledAt)
await modiva.social.posts.create({
  connectionId: connections[0].id,
  text: "Shipped via the Modiva SDK",
});

Python

import modiva

client = modiva.Modiva()  # reads MODIVA_API_KEY

# List connected accounts
connections = client.connections.list()

# Publish a post (or schedule with scheduled_at)
client.social.posts.create(
    connection_id=connections[0]["id"],
    text="Shipped via the Modiva SDK",
)

Por qué usar un SDK de Modiva

Los SDK envuelven una sola API REST unificada. En lugar de mantener un cliente, un flujo OAuth y la renovación de tokens para cada plataforma, instalas un paquete y dejas que Modiva normalice el resto.

Un cliente, todas las integraciones

Instala un solo paquete y llega a todas las 38 integraciones: social, ads, CRM y e-commerce. Sin una biblioteca separada por plataforma.

Tipado e idiomático

Escrito a mano para cada lenguaje: métodos tipados, errores nativos y las convenciones que tu ecosistema espera, no un wrapper generado.

Autenticación gestionada por ti

Autenticación con clave Bearer desde MODIVA_API_KEY, renovación automática de tokens en el servidor y OAuth como servicio, de modo que tu código nunca toca los secretos del proveedor.

Reintentos y paginación integrados

Los errores 429 y 5xx se reintentan con backoff exponencial respetando Retry-After; las llamadas de creación son idempotentes; los endpoints de listado paginan automáticamente.

Superficie completa de herramientas

Helpers tipados para las acciones comunes, más una vía de escape genérica tools.execute() para cada una de las 460+ herramientas del catálogo.

Con licencia MIT y abierto

Cada SDK, la CLI y el adaptador de chat son de código abierto en GitHub. Lee el código, abre issues, envía PR.

CLI y adaptador de chat

Más allá de los SDK por lenguaje, el kit incluye una interfaz de línea de comandos y un adaptador de chat: la misma API, distinta superficie.

Modiva CLI

npm i -g modiva

Manage connections, posts and the full tool surface from your terminal.

Chat adapter

npm i @modiva/chat-adapter

One bot, every messaging surface — Instagram, Messenger, WhatsApp, Telegram, X and Discord behind one handler.

Preguntas frecuentes

Which languages does Modiva have an SDK for?

Modiva ships official, open-source SDKs for Node.js / TypeScript, Python, Go, Ruby, Java, PHP, .NET / C# and Rust — eight languages, all following the same contract. A command-line interface and a chat adapter round out the toolkit.

Are the SDKs free and open source?

Yes. Every Modiva SDK, the CLI and the chat adapter are MIT-licensed and published on GitHub at github.com/modiva-dev. You can read the source, file issues and contribute.

Do I need a different SDK for each integration?

No — that's the point. One SDK is a single client for all 38 integrations. Instagram, TikTok, Google Ads, HubSpot, Shopify and every other platform are reached through the same typed methods and the generic tool surface.

How do I authenticate?

Create an API key in the dashboard (MCP keys), then set MODIVA_API_KEY in your environment. The SDK reads it automatically, or you can pass it to the client constructor. Provider OAuth and token refresh are handled by Modiva — your code never sees provider credentials.

Can I use the Modiva API without an SDK?

Yes. Everything is available over a plain REST API, and AI agents can call the same capabilities through the hosted MCP server. The SDKs are a typed convenience layer on top of the same endpoints.

What if my language isn't listed?

Any HTTP client works against the REST API — the SDKs simply add types, retries and pagination. The OpenAPI spec and llms.txt in the docs make it straightforward to generate or hand-roll a client.

Sigue explorando

Documentación de la API →Servidores MCP →Todas las integraciones →API de redes sociales →

Lanza tu primera integración hoy

Gratis para empezar · Primeras 3 cuentas conectadas gratis · Clave de API en un clic

Crea una cuenta gratis