RebundleRebundle Stack
Claude Code Hub

ShopMy

Tus ventas de ShopMy, desde Claude Code

ShopMy da a las marcas una clave oficial para leer los pedidos que traen sus creadores. Los creadores no tienen clave, así que Claude lee su panel con el navegador. Pega un prompt y Claude elige la vía que te toca, en solo lectura.

Funciona en Mac, Windows o Linux. Si eres marca, necesitas acceso a los Ajustes de la cuenta de tu marca en ShopMy (ahí está la clave). Si eres creador, ShopMy no tiene clave para ti: Claude usa tu navegador, con tu sesión ya abierta. En los dos casos, Claude solo lee.
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/shopmy-claude
2

Pega este prompt

Claude Code

Claude te preguntará si eres marca o creador, te llevará a la pantalla exacta, leerá la clave de tu portapapeles si la hay y te enseñará tus últimos pedidos o ganancias. Solo tienes que seguirle.

dile esto a claude
Quiero conectar ShopMy a Claude Code para consultar ventas, comisiones y creadores sin entrar en la web cada vez. 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 - ShopMy es una plataforma de afiliación entre marcas y creadores. Docs oficiales: https://docs.shopmy.us (índice para agentes en https://docs.shopmy.us/llms.txt). No hay MCP oficial ni conector; la vía depende de quién soy. - Si soy MARCA: hay API oficial (Brand Partners API). La clave está en la cuenta de la marca, en Account Settings > Tokens > Developer Key, y va en la cabecera Authorization: Bearer <clave>. La ruta útil es POST https://api.shopmy.us/v1/Partners/OrderReport: devuelve los pedidos que han traído los creadores (fecha, importe, comisión, creador, código de descuento), del más reciente al más antiguo. Todos los parámetros van en el cuerpo JSON (los de la URL se ignoran): domain (el dominio de mi marca tal como está registrado en ShopMy; pídemelo), limit (máximo 500), page (empieza en 0), transactionStartDate y transactionEndDate (formato 'YYYY-MM-DD HH:mm:ss' en UTC), reportBySKU, y source ('shopmyshelf' para quedarte solo con lo que viene de ShopMy; da 401 si pides una fuente con la que no tengo historial). Límite: 200 peticiones al día contando cada página, así que no hagas bucles de prueba. - Si soy CREADOR: la doc dice literalmente que no hay API key para creadores. No inventes una ni uses la API interna de la web con mi cookie. Las vías son: (a) el navegador, con mi sesión de ShopMy ya abierta, para leer mi panel (ganancias, links, colecciones) y pasarlo a una tabla o una hoja; (b) los emails que me manda ShopMy (pagos, comisiones, propuestas de marcas), si tienes acceso a mi correo. - Si quiero CONSTRUIR una app para que otros conecten su cuenta: es la API para partners con OAuth (links, colecciones, perfil, buscar en el catálogo). No es autoservicio: hay que pedir alta en partners@shopmyshelf.us. Solo explícamelo si lo elijo. QUÉ QUIERO QUE HAGAS 1. ENTENDER: pregúntame, de una en una y con opciones para elegir: si soy marca, creador o quiero construir una app; qué quiero ver (pedidos y comisiones, qué creadores venden más, mis ganancias, mis links); y si es algo puntual o recurrente. 2. RECOMENDAR: dime en dos frases qué vía encaja. Marca: la Developer Key. Creador: el navegador (y el correo si lo tienes). App: escribir a ShopMy. 3. REVISAR: comprueba tú mismo lo que hace falta. Para la vía de marca, que hay curl y python3 o node; para la de creador, que tienes un navegador que puedas usar. Instala lo que falte pidiéndome permiso antes. 4. CLAVE (solo si soy marca): guíame en ShopMy menú a menú; si algo no coincide con lo que veo, pídeme una captura. Nunca me pidas que te escriba la clave en el chat: dime exactamente qué copiar; cuando te diga «OK», léela tú del portapapeles (pbpaste en Mac; Get-Clipboard de PowerShell en Windows) y guárdala directamente en un sitio privado de mi usuario (mira CÓMO TRABAJAR CONMIGO), sin mostrarla, repetirla ni escribirla en el chat. Comprueba solo que no está vacía y después vacía el portapapeles. 5. PROBAR (solo lectura): si soy marca, una sola llamada a OrderReport con limit 20 y los últimos 30 días, y enséñame en una tabla corta fecha, creador, importe y comisión. Si soy creador, abre mi panel y resúmeme las ganancias del último mes y mis 5 links que más venden. 6. RECORDAR: crea una skill personal con quién soy en ShopMy (marca o creador), la vía que usamos, el dominio de mi marca si aplica, el límite de 200 peticiones al día y la regla de solo lectura. Así la próxima vez me basta con preguntarte. Reglas: solo lectura. En la web no cambies nada (ni links, ni colecciones, ni ajustes, ni aceptes propuestas de marcas) salvo que yo lo pida de forma explícita, y en ese caso enséñame antes exactamente qué vas a hacer y espera mi OK. Con la API, guarda cada informe que bajes en un fichero para no gastar peticiones repitiéndolo. 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:

¿Qué creadores me han traído más ventas este mes y con qué comisión?

Compara los pedidos de ShopMy de este trimestre con los del anterior

¿Qué códigos de descuento de creadores se están usando más?

Soy creador: ¿cuánto he ganado este mes y qué links venden más?

ShopMy en detalle

Quién tiene clave, qué cubre cada API y a qué prestar atención.

ShopMy une a marcas con creadores que recomiendan sus productos y cobran una comisión. Tiene API oficial, pero solo las marcas tienen clave: la Brand Partners API devuelve los pedidos que han traído los creadores. URL base https://api.shopmy.us/v1/Partners.

La doc de ShopMy lo dice claro: no hay API key para creadores. Un creador conecta Claude Code por el navegador, con la sesión ya abierta, o por los emails que manda ShopMy. No hay MCP oficial: para una marca, la vía es un script propio sobre la API, y el prompt de arriba lo escribe.

EnlacesDocs de la APIInforme de pedidosOAuth para desarrolladoresRevisado: octubre 2026

Por qué con Claude Code

Qué creadores venden de verdad

«Los 10 creadores que más venden este trimestre», «qué códigos de descuento convierten», «comisión pagada por creador»: Claude baja el informe y te lo resume.

La afiliación junto al resto

Claude cruza los pedidos de ShopMy con tu tienda o tus hojas en la misma conversación, y ves lo que aportan los creadores frente al resto de canales.

También para creadores, sin API

Si eres creador, Claude lee tu panel con el navegador y convierte ganancias y links en una tabla que te puedes quedar.

Ejemplos

El informe de pedidos

POST /OrderReport con todos los parámetros en el cuerpo JSON (los de la URL se ignoran). domain es el dominio de tu marca tal como está registrado en ShopMy; las fechas van como 'YYYY-MM-DD HH:mm:ss' en UTC; hasta 500 pedidos por página, del más reciente al más antiguo. Cada pedido trae fecha, importe y comisión en USD, creador, código de descuento y, según el programa, SKU, país y si el cliente es nuevo.

# Last 30 days, 20 orders: one request out of the 200 a day
curl -s -X POST https://api.shopmy.us/v1/Partners/OrderReport \
-H "Authorization: Bearer $SHOPMY_KEY" -H "Content-Type: application/json" \
-d '{"domain": "yourbrand.com", "limit": 20, "transactionStartDate": "2026-09-13 00:00:00"}'

Solo lo que viene de ShopMy

El informe cubre todas las fuentes de afiliación de tu programa. source: "shopmyshelf" deja solo los pedidos de ShopMy; pedir una fuente con la que no tienes historial devuelve 401, no una lista vacía.

El panel de un creador

Sin API: con Claude in Chrome o el navegador de la app de Claude, Claude abre tu panel de ShopMy con tu sesión y lee ganancias, links y colecciones. Tú inicias sesión; Claude solo lee.

Cómo añadirlo

Marcas

Developer Key

Una clave de la cuenta de marca, un script pequeño que escribe Claude. De solo lectura por naturaleza.

  1. 1En la cuenta de marca de ShopMy, ve a Account Settings > Tokens > Developer Key. Las dudas de acceso, a brandsupport@shopmy.us.
  2. 2Guarda la clave en un fichero con permisos 600, fuera de cualquier repo, y pruébala con un POST /OrderReport con un limit pequeño.
Creadores

Navegador

Para creadores no hay clave: Claude lee tu panel con tu sesión abierta.

  1. 1Inicia sesión en ShopMy en el navegador que usa Claude (Claude in Chrome o el de la app de Claude). La sesión la abres tú; Claude no escribe tu contraseña.
  2. 2Pide en lenguaje natural («mis ganancias de este mes», «mis 5 links que más venden»). Si Claude también lee tu correo, los emails de ShopMy sobre pagos y propuestas son otra fuente.
Construir una app

OAuth para partners

Para un producto en el que otros usuarios de ShopMy conectan su cuenta. Requiere el alta de ShopMy.

  1. 1Pide el alta en partners@shopmyshelf.us. ShopMy te da un Developer_id y una developer key, y registra tus redirect URLs.
  2. 2Manda al usuario a https://shopmy.us/oauth con tu Developer_id, los scopes y la redirect_url; canjea el shopmy_code en POST /oauth-exchange-token (solo una vez por usuario: guarda el token) y envía Authorization: Bearer <developer key> más X-ACCESS-TOKEN: Bearer <token del usuario> en cada llamada. Rutas: GET /Links, GET y POST /Collections, GET /Profile, GET /Catalog/search.

Qué cuesta

La APIParte de la cuenta de marca: la clave está en Account Settings y ShopMy no publica un precio aparte por ella.
El límite real200 peticiones al día al informe de pedidos, contando cada página. A 500 pedidos por página sobra, siempre que Claude guarde cada informe en vez de volver a bajarlo.

Bueno saber

  • ShopMy dice que su API aún no es pública: la clave de marca funciona hoy, pero la doc puede cambiar. Revísala antes de construir encima.
  • Hay un sandbox con pedidos sintéticos (https://api.shopmy.us/v1/sandbox/Partners, 1.000 peticiones al día), pero su token no es autoservicio: se pide al account manager o a partners@shopmyshelf.us.
  • Las rutas de la Tracking API (confirmación, actualización y cancelación de pedidos) son para conectar tu tienda a la atribución de ShopMy, no para consultar desde Claude Code. No las llames a mano.
  • Para investigar a otros creadores, sus perfiles públicos de ShopMy se pueden scrapear con Apify. Las comisiones son privadas y no salen, y el scraping puede chocar con los términos de ShopMy: léelos antes.

Rebundle · 2026