RebundleRebundle Stack
Claude Code Hub

SellerCloud

Tu operación en SellerCloud, desde Claude Code

SellerCloud tiene una API REST oficial: pedidos de todos los canales, catálogo, inventario y envíos. Pega un prompt y Claude la conecta con un usuario dedicado, primero en solo lectura, y solo cambia algo cuando tú lo digas.

Funciona en Mac, Windows o Linux. Necesitas un plan de SellerCloud con acceso a la API y un administrador que pueda crear un usuario (empleado) para la integración. La API entra con el usuario y la contraseña de ese usuario, así que Claude te pide crear un usuario dedicado con los permisos mínimos y nunca te pide la contraseña en el chat.
1

Abre Claude Code

Tú haces esto
  1. 1Abre Claude Desktop
  2. 2Haz clic en la pestaña Claude Code
  3. 3Elige una carpeta vacía, por ejemplo Documentos/sellercloud-claude
2

Pega este prompt

Claude Code

Claude te preguntará qué quieres, sacará la dirección de la API de tu cuenta a partir del nombre de tu equipo, leerá las credenciales del usuario de tu portapapeles y te enseñará tus últimos pedidos. Solo tienes que seguirle.

dile esto a claude
Quiero conectar mi cuenta de SellerCloud a Claude Code para consultar pedidos, catálogo e inventario y, cuando yo lo apruebe, marcar envíos y ajustar stock. No soy técnico: guíame paso a paso, un paso cada vez, y espera a que te confirme antes de seguir. CONTEXTO PARA TI - SellerCloud tiene una API REST oficial, documentada en https://developer.sellercloud.com. No hay MCP oficial: la vía es la API con un script propio. Existen dos MCP de la comunidad (alveyautomation/sellercloud-mcp, solo lectura, y ThynksoLab/sellercloud-mcp, con escritura activada por defecto y un scraper de la web antigua), pero con credenciales de mi cuenta prefiero código que yo pueda leer. - Dirección de mi cuenta: GET https://api.sellercloud.com/api/server-by-team/?team=<nombre de mi equipo> devuelve un JSON; su campo RestApiEndpoint es la base (algo como https://<equipo>.api.sellercloud.com/rest). La doc interactiva de mi cuenta está en esa base + /swagger: úsala para confirmar los paths antes de la primera llamada que escriba algo. - Autenticación: POST <base>/api/token con Content-Type: application/json y cuerpo {"Username": "...", "Password": "..."}. Devuelve access_token (Bearer) y expires_in: la doc dice a la vez 60 minutos y 30 en el ejemplo, así que lee expires_in y renueva antes de que caduque. Cada llamada lleva Authorization: Bearer <token>. - SellerCloud recomienda un usuario (empleado) distinto por integración, con sus propios permisos, para ver qué hace cada una. - Endpoints útiles: GET /api/orders (filtros createdOnFrom, createdOnTo, lastUpdatedFrom, orderStatus, shippingStatus, channel, companyID, sku; paginación con pageNumber y pageSize, máximo 50; fechas en formato mm/dd/yyyy hh:mm), GET /api/Orders/{id}, GET /api/catalog?SKU=..., GET /api/Inventory/Details?productID=..., GET /api/companies. Escritura: PUT /api/Orders/ShippingStatus/SinglePackage (marcar enviado con tracking), PUT /api/Inventory/AdjustPhysicalInventory/ (sumar o restar con motivo obligatorio), PUT /api/Inventory/SetPhysicalInventory/ (fijar stock), PUT /api/Orders/StatusCode (cambiar estado; poner Cancelled NO cancela el pedido en el canal). - Límite: 10.800 llamadas por hora por usuario e IP; al pasarlo devuelve "Too many requests." con RateLimitResetTime. QUÉ QUIERO QUE HAGAS 1. ENTENDER: pregúntame, de una en una y con opciones para elegir: si quiero solo consultar (pedidos, catálogo, inventario) o también marcar envíos o ajustar stock; si trabajo con una o varias companies dentro de SellerCloud; y si es algo puntual o recurrente. 2. DIRECCIÓN: pregúntame el nombre de mi equipo en SellerCloud (no es secreto), consulta server-by-team y enséñame la base que sale. 3. USUARIO: guíame para que un administrador cree un usuario (empleado) solo para esta integración, con los permisos mínimos para lo que elegí en el paso 1; si algo no coincide con lo que veo, pídeme una captura. Nunca me pidas que te escriba la contraseña en el chat: dime exactamente qué copiar, un dato cada vez; cuando te diga «OK», léelo tú del portapapeles (pbpaste en Mac; Get-Clipboard de PowerShell en Windows) y guárdalo directamente en un sitio privado de mi usuario (mira CÓMO TRABAJAR CONMIGO), sin mostrarlo, repetirlo ni escribirlo en el chat. Comprueba solo que no está vacío y después vacía el portapapeles. 4. REVISAR Y CONECTAR: comprueba que hay curl y python3 o node (instala lo que falte pidiéndome permiso) y escribe un script pequeño y legible (un solo fichero) que pida el token, lo renueve según expires_in y haga las llamadas de lectura. Enséñamelo antes de ejecutarlo. 5. PROBAR (solo lectura): los pedidos de los últimos 7 días, y enséñame en una tabla corta fecha, canal, estado e importe. 6. RECORDAR: crea una skill personal con cómo se usa el script, los endpoints de arriba y la regla de solo lectura salvo instrucción mía. Reglas: nada de cambiar pedidos, envíos ni inventario salvo que yo lo pida de forma explícita, y en ese caso enséñame antes exactamente qué vas a mandar y espera mi OK. Antes de un ajuste de stock en bloque, guarda una copia del stock actual. Si algo falla, explícamelo en lenguaje sencillo antes de intentar arreglarlo. CÓMO TRABAJAR CONMIGO - Explícame cada paso como a un niño de 10 años: frases cortas, sin jerga y, si usas una palabra técnica, dime en una línea qué es. Si te digo que soy técnico, ve al grano. - Cuando tengas que preguntarme algo, hazlo de una pregunta en una y con opciones para elegir (usa la herramienta de preguntas con opciones si la tienes), con una línea que explique cada opción. - Si hay que instalar algo, dime en una línea qué es y para qué sirve, y ofrécete a instalarlo tú con mi permiso. Si algo falla, cuéntame en palabras sencillas qué ha pasado y cuál es el siguiente intento, antes de probarlo. - Lo que te cuento arriba puede haberse quedado viejo. Antes de empezar, comprueba en la documentación oficial que sigue vigente; si algo no coincide, manda la documentación y dime qué ha cambiado. - Si tienes navegador (el navegador integrado de la app de Claude o Claude in Chrome), hazlo tú todo lo que puedas en vez de mandarme a una web: ábrela tú, navega hasta la pantalla exacta, rellena lo que no sea secreto y léeme lo que haga falta. Si arriba pone que yo vaya a una página o pulse algo, tómalo como lo que hay que conseguir y hazlo tú con el navegador. Pídeme a mí, de un paso en uno, solo lo que no puedes hacer: iniciar sesión, aprobar permisos, pagar o copiar una clave; tú no escribes contraseñas ni claves en ninguna web. Si no tienes navegador, entonces guíame con instrucciones. - Si hacen falta claves o algo más para conectarte (scripts, configuración), guárdalo en un sitio fijo de mi usuario, fuera de esta carpeta y de cualquier repositorio, que solo yo pueda leer. Nunca en el chat ni dentro de una skill. - La skill de RECORDAR, hazla personal (que funcione desde cualquier carpeta) y apunta en ella: cómo conectarte, con qué cuenta o usuario, dónde están las claves (el sitio, nunca el valor), qué suelo pedirte, las reglas de arriba y la fecha en que comprobaste la documentación. Si algo deja de funcionar porque el servicio cambió, mira la documentación, arréglalo y actualiza la skill. - Mis preferencias y lo que haya fallado van en un LEARNINGS.md aparte, en la misma carpeta de esa skill (una línea por aprendizaje, con fecha y el porqué). El primer paso de la skill es leerlo y aplicarlo. Para que nunca se te olvide proponer aprendizajes nuevos al terminar, añade al frontmatter de su SKILL.md este hook, cambiando <nombre-de-la-skill> por su nombre (inyecta un recordatorio una vez por uso; no lo cambies por un bloqueo, que entra en bucle): hooks: Stop: - hooks: - type: command once: true command: | grep -q '"stop_hook_active":true' && exit 0 echo '{"hookSpecificOutput":{"hookEventName":"Stop","additionalContext":"Antes de terminar: si en este uso de la skill <nombre-de-la-skill> el usuario corrigió algo, algo falló o mostró una preferencia, propón de 0 a 3 aprendizajes para su LEARNINGS.md (fecha, una línea y el porqué), enséñalos y pide OK antes de escribirlos. Si ya propusiste aprendizajes en este turno, no los repitas. Si no hay nada que aprender, termina sin añadir nada."}}'

Después, prueba con estos

Cuando Claude confirme que está conectado, pídele cosas como:

¿Cuántos pedidos enviamos ayer por canal?

¿Qué pedidos llevan más de 2 días sin enviarse?

¿Qué SKUs tienen menos de 10 unidades y se venden cada semana?

Compara el stock de esta hoja con el de SellerCloud y prepárame los ajustes para aprobarlos

La API de SellerCloud en detalle

Qué cubre la API, cómo se autentica, los MCP de la comunidad y a qué prestar atención.

La API REST de SellerCloud es la vía oficial para operar tu cuenta desde código: pedidos de todos los canales, catálogo, inventario, envíos y companies. Cada cuenta tiene su propia URL base, que sale del nombre de tu equipo, y su propio Swagger en esa base + /swagger.

Entra con el usuario y la contraseña de un usuario de SellerCloud y devuelve un token Bearer. No hay MCP oficial; existen dos de la comunidad (mira abajo). La vía del prompt es un script propio con un usuario dedicado, así que cada llamada es código que puedes leer.

EnlacesDocs de la API RESTAutenticaciónRevisado: octubre 2026

Por qué con Claude Code

Todos los canales en una pregunta

«Pedidos enviados ayer por canal», «qué lleva más de 2 días parado», «qué SKUs se están agotando»: Claude lee la API y te contesta en lenguaje natural.

Stock sin teclear dos veces

Claude compara una hoja de recuento o el fichero de un proveedor con SellerCloud y prepara los ajustes, cada uno con su motivo. Tú los revisas antes de que se mande nada.

Junto a tus canales mayoristas

Si también vendes por Faire, NuORDER o Rithum, Claude cruza los datos de todos los sistemas en la misma conversación.

Ejemplos

URL base y token

server-by-team devuelve el RestApiEndpoint de tu cuenta; POST /api/token con un cuerpo JSON devuelve el token. La doc dice 60 minutos en el texto y enseña expires_in: 1800 en el ejemplo: lee expires_in en vez de fijar ninguno de los dos.

curl -s "https://api.sellercloud.com/api/server-by-team/?team=<your_team>" | jq -r .RestApiEndpoint
curl -s -X POST "$SC_BASE/api/token" -H 'Content-Type: application/json' \
-d "{\"Username\":\"$SC_USER\",\"Password\":\"$SC_PASS\"}" | jq -r .access_token

Leer pedidos

GET /api/orders filtra por createdOnFrom/createdOnTo, lastUpdatedFrom, orderStatus, shippingStatus, channel, companyID y sku. Páginas de hasta 50 con pageNumber y pageSize; la respuesta es {Items, TotalResults}. Las fechas van como mm/dd/yyyy hh:mm.

Stock y envíos

GET /api/Inventory/Details?productID= lee el inventario de un SKU. PUT /api/Inventory/AdjustPhysicalInventory/ suma o resta con un motivo obligatorio, y SetPhysicalInventory fija una cifra absoluta. PUT /api/Orders/ShippingStatus/SinglePackage marca un pedido como enviado con su tracking.

Cómo añadirlo

Recomendado

API oficial, script propio

Un usuario dedicado, un token con sus credenciales y un script de un fichero que Claude escribe y tú lees. Empieza en solo lectura.

  1. 1Crea un usuario (empleado) solo para la integración con los permisos mínimos, como recomienda SellerCloud: así ves y revocas lo que hace sin tocar el acceso de nadie.
  2. 2Saca tu base de server-by-team, guarda las credenciales del usuario en un .env con permisos 600, pide el token y renuévalo según expires_in.
Comunidad, con cuidado

Servidores MCP de la comunidad

No son de SellerCloud, son jóvenes y apenas tienen uso. Léelos antes de darles tus credenciales.

  1. 1alveyautomation/sellercloud-mcp (MIT): siete herramientas de solo lectura para catálogo, pedidos, inventario y canales, con el mismo usuario y contraseña. El más prudente de los dos para probar.
  2. 2ThynksoLab/sellercloud-mcp (MIT): más de 70 herramientas con escritura activada por defecto (pon SELLERCLOUD_READ_ONLY=true), más un scraper que entra en la web antigua con otro juego de credenciales y al que ese modo solo lectura no protege.

Qué cuesta

La APIEl acceso a la API aparece desde el plan que empieza en 1.349 $/mes en la página de precios de SellerCloud. Comprueba qué incluye tu plan.
El coste realUn ajuste de stock o un envío marcado por error, que tus canales recogen. Por eso el prompt empieza en solo lectura y escribe solo con tu OK.

Bueno saber

  • Poner un pedido en Cancelled con PUT /api/Orders/StatusCode lo cambia solo en SellerCloud: el pedido no se cancela en el canal donde se hizo.
  • Límite: 10.800 llamadas por hora por usuario e IP. Al pasarlo, la API responde «Too many requests.» con RateLimitResetTime; un motivo más para dar a cada integración su propio usuario.
  • Algunos artículos enseñan los paths sin el prefijo /rest y algunos endpoints están marcados como obsoletos (por ejemplo GET /api/Inventory/{id}). Manda el Swagger de tu cuenta.
  • No hay sandbox documentado: prueba en solo lectura sobre la cuenta real.

Rebundle · 2026