App Manager

Qué necesitas

Tres cosas antes de empezar.

1. 01

   Paso 1: Crea la app en el Dev Dashboard

   3 min

   1. Entra en dev.shopify.com con la misma cuenta de tu tienda (o desde el admin: Configuración → Apps → Desarrollar apps).
   2. Crear app → ponle un nombre que reconozcas, por ejemplo App Manager.
   3. En la versión de la app: en URL de la app escribe la dirección de tu tienda (https://tutienda.com; la app no tiene pantalla, Shopify solo pide una dirección válida) y desmarca «Incrustar la app en el admin».
2. 02

   Paso 2: Pega los alcances

   2 min

   En la misma versión, en Alcances, pega esta línea entera. Son los permisos para productos, stock, fotos, publicación, menús, páginas, metaobjetos y traducciones:

   Alcances (una sola línea)Copiar

   write_products,read_products,write_inventory,read_inventory,read_locations,write_publications,read_publications,write_files,read_files,write_metaobjects,read_metaobjects,write_metaobject_definitions,read_metaobject_definitions,write_online_store_navigation,read_online_store_navigation,write_online_store_pages,read_online_store_pages,write_content,read_content,write_translations,read_translations,read_locales,write_locales

   Guarda y publica la versión: tiene que quedar como Activa.

3. 03

   Paso 3: Instala la app en tu tienda

   2 min

   1. En la página de la app: Instalar app → elige tu tienda → Instalar.
   2. Si no te sale el botón: Distribución → Personalizada → tu dominio .myshopify.com → abre el enlace que genera y pulsa Instalar.

   Si cambias los permisos: nueva versión, publícala y acepta la actualización en tu tienda. Hasta entonces, la app sigue con los de antes.

4. 04

   Paso 4: Guarda el Client ID y el secret en el .env

   3 min

   1. En la app: Configuración → Credenciales. Copia el Client ID y el Client secret (shpss_…).
   2. Descomprime el kit en la carpeta de tu proyecto, copia .env.example como .env y rellénalo:

   .envCopiar

   SHOPIFY_STORE=tu-tienda.myshopify.com
   SHOPIFY_CLIENT_ID=
   SHOPIFY_CLIENT_SECRET=

   SHOPIFY_STORE es tu dominio .myshopify.com (lo ves en la dirección del admin: admin.shopify.com/store/<este>), no el .com de tu tienda. Compruébalo: node herramientas/shopify.mjs comprobar.

5. 05

   Paso 5: Claude crea un producto de prueba en borrador

   2 min

   1. Abre la carpeta con Claude Code y dile: «Comprueba la conexión con Shopify y crea en borrador el producto de prueba productos/_ejemplo-camiseta-raw».
   2. Claude te da el enlace del producto en tu admin. Ábrelo y mira la foto, el precio, el stock y la descripción.
   3. Si está bien, pídele que lo borre: «borra el producto de ejemplo».
6. 06

   Paso 6: El resto, en masa

   lo que tarde Claude

   1. Pon tus productos en productos/ (una carpeta por producto) o dale a Claude tus fotos y tu Excel para que prepare las fichas.
   2. Rellena marca.md y pídele las descripciones que falten.
   3. Prueba con uno de los tuyos y, si está bien: «Valida todas las fichas y crea en borrador el resto de productos, con sus colecciones».
   4. Revísalos en Shopify y publica cuando quieras: «pon como activos los que te diga y vuelve a subirlos».

   Repetir es seguro: si una carpeta ya se subió, se actualiza el mismo producto (precio, stock, texto…). No se duplica.

La ficha

Una carpeta por producto.

mi-tienda/
├── CLAUDE.md                 las instrucciones para Claude
├── .env                      tus credenciales (no se comparte)
├── marca.md                  tu tono de marca
├── herramientas/shopify.mjs  el conector con Shopify
└── productos/
    ├── _plantilla/           para copiar
    ├── sudadera-negra/
    │   ├── producto.md
    │   ├── 01-frente.jpg
    │   └── 02-espalda.jpg
    └── camiseta-blanca/
        ├── producto.md
        └── 01.jpg

---
titulo: Sudadera negra
precio: 79,00
precio_antes: 99,00
sku: SUD-NEG
proveedor: Mi marca
tipo: Sudaderas
etiquetas: algodón, unisex
colecciones: Novedades, Sudaderas
estado: borrador
opciones: Talla
variantes:
  S: 10
  M: 12
  L: 8 | 84,00
---
Sudadera de felpa gruesa con capucha. **Corte amplio**.

## Composición
- 80 % algodón, 20 % poliéster

Qué decirle a Claude

Frases para copiar y pegar.

En material/ tienes las fotos de todos los productos y en precios.xlsx los precios, tallas y stock. Prepara una carpeta por producto en productos/ con su ficha. Si falta un precio o una talla, pregúntame.

Escribe las descripciones que faltan mirando las fotos y siguiendo marca.md. No inventes composición, medidas ni materiales, y dime cuáles has escrito tú.

Crea en borrador productos/sudadera-negra y pásame el enlace del admin.

Valida todas las fichas y crea en borrador el resto de productos, con sus colecciones. Al acabar, dame un resumen con los enlaces.

Seguridad

El secret es la llave de tu tienda.

Problemas frecuentes

Si algo no sale como esperabas.

Preguntas frecuentes

Lo que más me preguntan.