Resumen
API de Vendedor de Whatnot para vendedores en el mercado de compras en vivo: pedidos, artículos de pedido, envíos y códigos de seguimiento, productos y variantes, inventario, merchandising para compra inmediata, subastas y shows, análisis de shows e informes. Token de acceso personal.
Configuración guiada
Conecta Whatnot a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Whatnot con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Whatnot
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Whatnot, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Whatnot
API de Vendedor de Whatnot para vendedores en el mercado de compras en vivo: pedidos, artículos de pedido, envíos y códigos de seguimiento, productos y variantes, inventario, merchandising para compra inmediata, subastas y shows, análisis de shows e informes. Token de acceso personal.
Configuración
Configurar toma aproximadamente 2 minutos.
- Inicia sesión en Whatnot con la cuenta del propietario del vendedor y abre el panel de desarrollador, pestaña Tokens de acceso personal (https://www.whatnot.com/dashboard/developer?tab=tokens). Solo el propietario de la cuenta puede crear tokens.
- Haz clic en Generar nuevo token, dale un nombre, elige una fecha de expiración (de 7 a 90 días, una fecha personalizada o sin expiración) y los permisos: lectura y escritura para inventario, merchandising, pedidos y envíos, lectura para shows, lectura y escritura para informes, y lectura de clientes si el agente debe ver los nombres de los compradores. El acceso de escritura incluye el acceso de lectura.
- Copia el token (comienza con
wn_pat_tk_y se muestra solo una vez) enWHATNOT_API_TOKEN.
La API de Vendedor aún está marcada como beta por Whatnot: los campos pueden cambiar.
Por dónde empezar: whatnot_get_current_user verifica el token. whatnot_list_orders muestra los pedidos recientes; cumple con aquellos con estado pending_fulfillment. whatnot_list_products lista el catálogo.
Pedidos y envíos: whatnot_list_orders, whatnot_get_order, whatnot_list_order_items, whatnot_get_order_item. Cada artículo de pedido pertenece a un envío: whatnot_list_shipments, whatnot_get_shipment, whatnot_list_shipment_items. Envía con tu propia etiqueta a través de whatnot_add_tracking_code (ids de artículos de pedido, transportista, código de seguimiento). whatnot_generate_shipping_label (etiqueta de Whatnot, puede costar dinero) y whatnot_cancel_order (reembolsa al comprador) están instalados apagados.
Listar un producto: 1) whatnot_list_dimension_profiles para un id de perfil de paquete, 2) whatnot_create_product con título, id de categoría hoja de la taxonomía pública de Whatnot (https://github.com/Whatnot-Inc/product-taxonomy) y el perfil, 3) whatnot_list_product_variants para los ids de variante, 4) whatnot_update_product_variants para precios, 5) whatnot_set_inventory para stock, 6) whatnot_update_product_merchandising para elegir compra_inmediata o subasta y publicar. Cambia productos con whatnot_update_product, léelos con whatnot_get_product y whatnot_get_product_variant. whatnot_delete_product está instalado apagado.
Inventario: whatnot_set_inventory (absoluto) y whatnot_adjust_inventory (delta) aceptan hasta 10 variantes por llamada; asigna a cada artículo una clave de idempotencia nueva (un UUID) para que un reintento se aplique solo una vez.
Shows y merchandising: whatnot_list_shows (estado programado por defecto), whatnot_get_show, whatnot_get_show_analytics, whatnot_get_product_merchandising, whatnot_list_product_shows. Agregar un producto a un show utiliza ids de show (UUID) en whatnot_update_product_merchandising con estrategia ADD, REMOVE o REPLACE.
Informes: whatnot_generate_report inicia un informe financiero, de análisis general o de transmisiones en vivo; consulta whatnot_get_report o whatnot_list_reports hasta que el estado esté completo.
Paginación: las listas toman limit (de 1 a 50, por defecto 10) y devuelven data más next_cursor; pásalo como cursor hasta que sea nulo.
Ids y formatos: los ids de pedido, producto, envío y artículo de pedido son dígitos (envíalos como texto); los ids de variante, show e informe son UUIDs. El dinero es un objeto con amount como texto en unidades enteras (19.99) y currency. Los tiempos son ISO 8601 en UTC con milisegundos (2026-11-01T00:00:00.000Z).
Errores y límites: los errores son problem+json con type, title, detail (un error missing-scope lista required_scopes: edita los permisos del token); un 422 por una solicitud mal formada lista cada campo bajo detail con loc y msg. El límite es de 10 solicitudes por segundo por vendedor y aplicación; un 429 lleva Retry-After en segundos.
Requisitos previos: WHATNOT_API_TOKEN
Instalar el conector localmente
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Abre http://localhost:3000/connectors/store, elige Whatnot y pega las variables de entorno listadas bajo Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
whatnot_get_current_user | El vendedor detrás del token API: id de usuario, nombre de usuario y nombre para mostrar. Úsalo para verificar la conexión |
whatnot_list_orders | Lista los pedidos vendidos por el vendedor, el más nuevo primero por defecto: id, estado (pendiente, pending_fulfillment, completado, cancelado, fallido)… |
whatnot_get_order | Un pedido por id con estado, comprador, montos y marcas de tiempo. Cumple con los pedidos cuyo estado es pending_fulfillment; los pedidos pendientes no están listos… |
whatnot_list_order_items | Artículos de un pedido: id de artículo, producto, variante, cantidad, precio y el envío al que pertenece cada artículo. Paginación por cursor, hasta 50 por página |
whatnot_get_order_item | Un artículo de un pedido: producto, variante, cantidad, precio y envío |
whatnot_cancel_order | Cancela un pedido que no ha sido enviado y devuelve el pedido actualizado. El comprador es reembolsado y la cancelación cuenta en contra del vendedor.… |
whatnot_list_products | Lista los productos del vendedor, el más nuevo primero por defecto: id, título, descripción, external_id, categoría, atributos, opciones, medios… |
whatnot_get_product | Un producto con su categoría, atributos, opciones, imágenes, perfil de dimensión y variantes (id, sku, precio, inventario) |
whatnot_create_product | Crea un producto en el catálogo del vendedor. Whatnot crea una variante por combinación de valores de opción (una variante sin opciones).… |
whatnot_update_product | Actualiza parcialmente un producto: título, descripción, id externo, categoría, atributos, opciones, imágenes o perfil de dimensión. Los campos omitidos permanecen… |
whatnot_delete_product | Elimina un producto del catálogo del vendedor. No se puede deshacer. Instalado apagado |
whatnot_list_product_variants | Variantes de un producto: id de variante (UUID), sku, external_id, valores de opción seleccionados, precio, inventario e imagen. Paginación por cursor, hasta 50 por… |
whatnot_get_product_variant | Una variante de un producto por su UUID: sku, opciones, precio, inventario e imagen |
whatnot_update_product_variants | Actualiza hasta 10 variantes de un producto: precio (bajo el formato de venta del producto), sku, id externo, país de origen o imagen. Los campos omitidos… |
whatnot_set_inventory | Establece la cantidad disponible de hasta 10 variantes a un valor absoluto. Cada artículo necesita una clave de idempotencia única (un nuevo UUID por cambio); un… |
whatnot_adjust_inventory | Cambia la cantidad disponible de hasta 10 variantes por un delta (negativo para reducir; un resultado por debajo de cero se convierte en 0). Cada artículo necesita una única… |
whatnot_get_product_merchandising | Cómo y dónde se vende un producto: transaction_type (compra_inmediata o subasta), reserve_for_live y si está asignado a shows próximos o en vivo… |
whatnot_update_product_merchandising | Establece el formato de venta de un producto, resérvalo para shows en vivo, o agrégalo o quítalo de shows, en una sola llamada; los campos omitidos permanecen sin cambios.… |
whatnot_list_product_shows | Shows próximos o en vivo a los que un producto está asignado, por inicio programado (el más reciente primero por defecto). Shows finalizados y cancelados se omiten.… |
whatnot_list_shipments | Lista los envíos del vendedor, el más nuevo primero por defecto: id, estado (creado, etiqueta_generada, entregado, en_tránsito, entregado, cancelado… |
whatnot_get_shipment | Un envío: estado, seguimiento, documentos (etiqueta), acciones requeridas y la dirección del comprador |
whatnot_list_shipment_items | Artículos activos de un envío: ids de artículos de pedido, productos, cantidades y perfil de dimensión. Paginación por cursor, hasta 50 por página |
whatnot_add_tracking_code | Envía artículos de pedido bajo un código de seguimiento de la propia etiqueta del vendedor. Los artículos deben ir al mismo comprador y dirección y no deben haber sido… |
whatnot_generate_shipping_label | Coloca una etiqueta de envío de Whatnot para un envío con sus configuraciones guardadas. 200 significa en cola, no creada; la etiqueta llega a través de Whatnot… |
whatnot_list_dimension_profiles | Los perfiles de dimensión activos del vendedor (preajustes de peso y tamaño del paquete): id, nombre, peso, dimensiones. Usa un id al crear un producto.… |
whatnot_list_shows | Lista los shows del vendedor con un estado (programado por defecto), por hora de inicio programada, el más reciente primero por defecto: id (UUID), título, estado… |
whatnot_get_show | Un show por id (UUID): título, estado, visibilidad, inicio programado y URL |
whatnot_get_show_analytics | Análisis de un show (ventas, espectadores y otras métricas). Un show sin números finales responde con métricas nulas y calculation_status… |
whatnot_generate_report | Solicita la ejecución de un informe: seller_financial_report (transacciones entre start_date y end_date, por defecto una semana), analytics_overview_report… |
whatnot_list_reports | Las ejecuciones de informes del vendedor, solicitadas más recientemente primero: id, report_type, estado (pendiente, en_progreso, completado, fallido, cancelado)… |
whatnot_get_report | Una ejecución de informe por id (UUID): estado y, cuando se completa, el enlace para descargar el archivo |
Ejemplos de solicitudes
- "¿Qué pedidos de Whatnot del show de anoche aún necesitan envío?"
- "Agrega el seguimiento de UPS 1Z999AA10123456784 al envío 778899."
- "Establece el inventario de la variante SKU WN-CARD-PK1 en 50."
- "¿Cómo le fue a mi último show: espectadores, ventas e ingresos?"
- "Genera un informe de ventas para octubre."
Próximos pasos
¿Te ha sido útil esta guía?