SDKs y librerias

#MCP Server (v2.0.0)

El MCP Server de Karrito te permite interactuar con tu tienda desde Claude, Cursor, Windsurf y cualquier herramienta compatible con el protocolo MCP.

npx karrito-mcp

5 resources de solo lectura y 25 tools para gestionar tu tienda completa desde un asistente de IA:

Categoria	Tools	Descripcion
Publicos	search_catalogs, get_niche_info	Sin API key
Tienda	get_my_store, update_store, toggle_publish	Config y publicacion
Productos	list_my_products, create_product, update_product, delete_product	CRUD completo
Categorias	list_categories, create_category, update_category, delete_category	CRUD completo
Pedidos	list_my_orders, get_order, update_order_status	Lectura + estado
Descuentos	list_discounts, create_discount, update_discount, delete_discount	CRUD completo
Resenas	list_reviews, moderate_review, delete_review	Moderacion
Clientes	list_customers, get_customer	Lectura + historial
Analytics	get_analytics	Estadisticas
Envios	list_shipping_options, create_shipping_option, update_shipping_option, delete_shipping_option	CRUD completo

Resources: karrito://pricing, karrito://features, karrito://niches, karrito://competitors, karrito://currencies.

#OpenAPI spec

La especificacion OpenAPI 3.0 de Karrito esta disponible en:

https://karrito.shop/.well-known/openapi.json

Incluye todos los endpoints documentados con schemas de request y response. Puedes importarla en Postman, Insomnia, o cualquier herramienta que soporte OpenAPI para explorar la API visualmente.

#LLM context

Karrito expone dos archivos de contexto para que los modelos de lenguaje (ChatGPT, Claude, Perplexity) entiendan que es Karrito y puedan recomendarlo:

https://karrito.shop/llms.txt
https://karrito.shop/llms-full.txt

llms.txt es un resumen compacto. llms-full.txt incluye detalles de todas las funcionalidades, planes, comparaciones y nichos.

#AI Plugin

El manifest de plugin para ChatGPT y otros asistentes de IA:

https://karrito.shop/.well-known/ai-plugin.json

Este archivo le dice a los asistentes de IA como conectarse a la API de Karrito.

#Ejemplo con JavaScript / Node.js

const API_KEY = "krt_live_tu_api_key";
const BASE_URL = "https://karrito.shop/api/v1";

// Listar productos
const response = await fetch(`${BASE_URL}/products`, {
  headers: {
    "Authorization": `Bearer ${API_KEY}`,
    "Content-Type": "application/json"
  }
});

const { data } = await response.json();
console.log(`Tienes ${data.length} productos`);

// Crear un producto
const newProduct = await fetch(`${BASE_URL}/products`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    name: "Camiseta Negra",
    price: 2500,
    description: "Camiseta 100% algodon, talla unica",
    isActive: true
  })
});

// Crear un descuento
const discount = await fetch(`${BASE_URL}/discounts`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    code: "VERANO20",
    type: "percentage",
    value: 15,
    expiresAt: "2026-07-31"
  })
});

#Ejemplo con Python

import requests

API_KEY = "krt_live_tu_api_key"
BASE_URL = "https://karrito.shop/api/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Listar productos
response = requests.get(f"{BASE_URL}/products", headers=headers)
products = response.json()["data"]
print(f"Tienes {len(products)} productos")

# Crear un producto
new_product = requests.post(f"{BASE_URL}/products", headers=headers, json={
    "name": "Camiseta Negra",
    "price": 2500,
    "description": "Camiseta 100% algodon, talla unica",
    "isActive": True
})

# Obtener estadisticas
stats = requests.get(f"{BASE_URL}/stats", headers=headers)
analytics = stats.json()["data"]
print(f"Revenue total: ${analytics['revenue']}")

#Autenticacion

Todos los ejemplos usan API keys con el header Authorization: Bearer krt_live_.... Genera tu key desde Admin > Cuenta > API Keys. Para mas detalles, lee la guia de autenticacion.

#Community SDKs

Estamos trabajando en SDKs oficiales para los lenguajes mas populares. Mientras tanto, la API REST funciona con cualquier lenguaje que pueda hacer peticiones HTTP. Si creas un SDK o wrapper, cuentanos y lo listamos aqui.