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 espectáculos, análisis y reportes de espectáculos. Token de acceso personal.
Configuración guiada
Conecta Whatnot a Microsoft 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 Microsoft Copilot. 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 + Microsoft Copilot
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 espectáculos, análisis y reportes de espectáculos. Token de acceso personal.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda dentro de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
WHATNOT_API_TOKEN
Paso 1 — Obtener credenciales
La configuración 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 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 espectáculos, lectura y escritura para reportes, 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 sigue 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.
Listando 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 fresca (un UUID) para que un reintento se aplique solo una vez.
Espectáculos 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 espectáculo utiliza ids de espectáculo (UUID) en whatnot_update_product_merchandising con estrategia ADD, REMOVE o REPLACE.
Reportes: whatnot_generate_report inicia un reporte financiero, de análisis general o de transmisiones en vivo; consulta whatnot_get_report o whatnot_list_reports hasta que el estado esté completado.
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, espectáculo y reporte 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.
Paso 2 — Instalar el adaptador
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
Paso 3 — Agregar el conector en Microsoft Copilot
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Whatnot. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
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, los más recientes primero por defecto: id, estado (pendiente, pendiente_de_cumplimiento, 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, los más recientes 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, external id, 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… |
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 espectáculos próximos o en vivo… |
whatnot_update_product_merchandising | Establece el formato de venta de un producto, resérvalo para espectáculos en vivo, o agrégalo o quítalo de espectáculos, en una sola llamada; los campos omitidos permanecen sin cambios.… |
whatnot_list_product_shows | Espectáculos próximos o en vivo a los que un producto está asignado, por inicio programado (el más reciente primero por defecto). Los espectáculos finalizados y cancelados se omiten.… |
whatnot_list_shipments | Lista los envíos del vendedor, los más recientes primero por defecto: id, estado (creado, etiqueta_generada, entregado, en_transito, 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 espectáculos 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 espectáculo por id (UUID): título, estado, visibilidad, inicio programado y URL |
whatnot_get_show_analytics | Análisis de un espectáculo (ventas, espectadores y otras métricas). Un espectáculo sin números finales responde con métricas nulas y calculation_status… |
whatnot_generate_report | Solicita la ejecución de un reporte: seller_financial_report (transacciones entre start_date y end_date, por defecto una semana), analytics_overview_report… |
whatnot_list_reports | Las ejecuciones de reportes del vendedor, las más recientemente solicitadas primero: id, report_type, estado (pendiente, en_progreso, completado, fallido, cancelado)… |
whatnot_get_report | Una ejecución de reporte por id (UUID): estado y, cuando esté completado, el enlace para descargar el archivo |
Ejemplos de indicaciones
- "¿Qué pedidos de Whatnot del espectáculo 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 espectáculo: espectadores, ventas e ingresos?"
- "Genera un reporte de ventas para octubre."
Preguntas frecuentes
¿De dónde proviene el token? Panel de desarrollador de Whatnot, pestaña Tokens de acceso personal, creado por el propietario de la cuenta con los permisos que necesitan las herramientas. Se muestra una vez. La API de vendedor sigue marcada como beta por Whatnot.
¿Qué cubre? Pedidos, artículos de pedido, envíos y códigos de seguimiento, productos y variantes, inventario, merchandising para compra inmediata, subastas y espectáculos, análisis y reportes de espectáculos.
¿Qué herramientas están instaladas apagadas? whatnot_cancel_order, whatnot_delete_product y whatnot_generate_shipping_label. Actívalas en la página del conector solo si la IA debe usarlas.
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Próximos pasos
¿Te ha sido útil esta guía?