RebundleRebundle Stack
Claude Code Hub

Faire · marcas

Tu mayorista en Faire, desde Claude Code

Faire tiene una API oficial para marcas: productos, pedidos, envíos e inventario. Pega un prompt y Claude conecta tu cuenta de marca, primero en solo lectura, y solo cambia algo cuando tú lo digas.

Funciona en Mac, Windows o Linux. Necesitas una cuenta de marca en Faire con acceso a sus Ajustes (la API es para marcas; si compras en Faire para tu tienda, tu guía es Faire para compradores). Claude empieza en solo lectura y nunca acepta un pedido ni cambia el stock sin enseñarte lo que va a mandar y esperar tu OK.
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/faire-claude
2

Pega este prompt

Claude Code

Claude te preguntará qué quieres, te dirá exactamente dónde generar el token en Faire, lo leerá de tu portapapeles y te enseñará tus últimos pedidos. Solo tienes que seguirle.

dile esto a claude
Quiero conectar mi cuenta de marca en Faire a Claude Code para consultar pedidos y productos y, cuando yo lo apruebe, aceptar pedidos y actualizar inventario. 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 - Faire tiene una API oficial para marcas: External API v2, base https://www.faire.com/external-api/v2, docs en https://developers.faire.com/docs (tiene captcha: si no puedes leerla, dímelo y te pego lo que necesites). No hay MCP oficial; la vía es la API con un script propio. Los paths pueden haber cambiado: confírmalos en la doc antes de la primera llamada que escriba algo. - Autenticación, dos vías: 1. Token de la marca (la que Faire recomienda para una sola marca): se genera en el portal de marca, en Settings > Integrations. La doc v2 lo manda en la cabecera X-FAIRE-ACCESS-TOKEN; la doc actual solo describe OAuth, así que prueba el token con GET /brands/profile antes de nada. 2. OAuth (para quien integra varias marcas): app registrada en el Developer Portal (applicationId y applicationSecret), autorización en https://faire.com/oauth2/authorize (el code dura 10 minutos), canje en POST https://www.faire.com/api/external-api-oauth2/token, y en cada llamada X-FAIRE-APP-CREDENTIALS (base64 de applicationId:applicationSecret) más X-FAIRE-OAUTH-ACCESS-TOKEN. Permisos por scope: READ_ORDERS, WRITE_ORDERS, READ_PRODUCTS, WRITE_PRODUCTS, READ_INVENTORIES, WRITE_INVENTORIES, READ_SHIPMENTS, READ_BRAND, READ_RETAILER. - Endpoints útiles: GET /orders (filtros updated_at_min, created_at_min, excluded_states; no hay filtro de estados incluidos, solo de excluidos; máximo 50 por página), GET /products (máximo 250 por página), PUT /orders/{order_id}/processing (aceptar un pedido), POST /orders/{order_id}/shipments (añadir envío con transportista y tracking), PATCH /product-inventory/by-skus (stock por SKU con on_hand_quantity). - Paginación con page y limit, o con cursor (el cursor no se combina con filtros). Crear objetos exige un idempotency_token. Si devuelve 429, espera y reintenta. QUÉ QUIERO QUE HAGAS 1. ENTENDER: pregúntame, de una en una y con opciones para elegir: si quiero solo consultar (pedidos, productos, retailers) o también aceptar pedidos, marcar envíos o actualizar stock; si es para mi marca o para varias; y si es algo puntual o recurrente. 2. RECOMENDAR: dime en dos frases qué vía encaja. Por defecto, el token de la marca; OAuth solo si integro varias marcas. 3. REVISAR: comprueba tú mismo que hay curl y python3 o node. Instala lo que falte pidiéndome permiso antes. 4. TOKEN: guíame en Faire menú a menú; si algo no coincide con lo que veo, pídeme una captura. Nunca me pidas que te escriba el token en el chat: dime exactamente qué copiar; 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. 5. PROBAR (solo lectura): GET /brands/profile y los 10 pedidos más recientes, y enséñame en una tabla corta fecha, retailer, estado e importe. 6. RECORDAR: crea una skill personal con cómo conectarte, los endpoints de arriba y la regla de solo lectura salvo instrucción mía. Así la próxima vez me basta con preguntarte. Reglas: nada de aceptar o cancelar pedidos, crear envíos ni tocar productos o 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 cambio 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:

¿Qué pedidos nuevos han entrado esta semana y de qué retailers?

¿Qué pedidos aceptados siguen sin envío?

Compara el stock de esta hoja con el de Faire y prepárame los cambios para aprobarlos

¿Cuáles son mis 10 productos más pedidos este trimestre?

La API de Faire en detalle

Qué cubre la API, las dos formas de entrar y a qué prestar atención.

La Faire External API v2 es la vía oficial para que una marca opere su cuenta de Faire desde código: productos y variantes, pedidos, envíos e inventario. URL base https://www.faire.com/external-api/v2. Es para marcas: los retailers no tienen API documentada; si compras en Faire para tu tienda, tu guía es Faire para compradores.

Dos formas de entrar: un token que la marca genera en su portal (lo que Faire recomienda para una sola marca) u OAuth con una app registrada en el Developer Portal (para partners que integran muchas marcas). No hay MCP oficial: la vía para Claude Code es un script propio sobre la API, y el prompt de arriba lo escribe.

EnlacesDocs de la APICómo conseguir una API keyRevisado: octubre 2026

Por qué con Claude Code

Pedidos en lenguaje natural

«Pedidos nuevos desde el lunes», «qué retailers repiten», «qué falta por enviar»: Claude lee la API y te lo resume.

Stock sin teclear dos veces

Claude compara tu hoja de stock o la exportación de tu ERP con Faire y prepara la actualización por SKU. Tú la revisas antes de que se mande nada.

Todos tus canales mayoristas juntos

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

Ejemplos

Leer pedidos

GET /orders filtra por updated_at_min, created_at_min y excluded_states: no hay filtro de los estados que quieres, solo de los que excluyes. Hasta 50 pedidos por página; pagina con page y limit o con cursor (el cursor no se combina con filtros).

# Test the token first: it returns your brand's profile
curl -s -H "X-FAIRE-ACCESS-TOKEN: $FAIRE_TOKEN" https://www.faire.com/external-api/v2/brands/profile
curl -s -H "X-FAIRE-ACCESS-TOKEN: $FAIRE_TOKEN" "https://www.faire.com/external-api/v2/orders?limit=10" | jq '.orders[] | {id, state, created_at}'

Aceptar y enviar

PUT /orders/{order_id}/processing acepta un pedido (con expected_ship_date opcional); POST /orders/{order_id}/shipments añade el envío con transportista y código de seguimiento.

Stock por SKU

PATCH /product-inventory/by-skus con inventories: [{sku, on_hand_quantity}]. Los endpoints antiguos de inventory-levels se retiraron el 1 de junio de 2026: un tutorial que aún los use está desfasado.

Cómo añadirlo

Recomendado

Token de la marca

Una marca, un token del portal, un script pequeño que escribe Claude. Empieza en solo lectura.

  1. 1En el portal de marca de Faire, ve a Settings > Integrations. Para una integración propia, el centro de ayuda de Faire pide registrar antes una app y luego introducirla en Have an unpublished integration?.
  2. 2Guarda el token en un fichero .env con permisos 600, fuera de cualquier repo, y pruébalo con GET /brands/profile.
Varias marcas

App con OAuth

Para agencias o partners que conectan más de una marca.

  1. 1Registra la app en el Developer Portal para obtener applicationId y applicationSecret, y pide solo los scopes que necesites (READ_ORDERS, READ_PRODUCTS… antes que cualquier WRITE_).
  2. 2Manda a la marca a https://faire.com/oauth2/authorize, canjea el code (dura 10 minutos) en POST https://www.faire.com/api/external-api-oauth2/token y envía X-FAIRE-APP-CREDENTIALS más X-FAIRE-OAUTH-ACCESS-TOKEN en cada llamada.

Qué cuesta

La APIParte de la cuenta de marca: el token se genera en el portal y Faire no publica un precio aparte por ella.
El coste realUn pedido aceptado o un stock cambiado por error. Por eso el prompt empieza en solo lectura y escribe solo con tu OK.

Bueno saber

  • La doc actual solo describe OAuth; la cabecera X-FAIRE-ACCESS-TOKEN del token del portal viene de la doc v2 anterior. Pruébala con GET /brands/profile antes de construir encima.
  • La doc solo describe permisos (scopes) para OAuth, no para el token del portal. El solo lectura es, por tanto, una regla que ponen tu script y tu skill, no algo que garantice el token.
  • Crear objetos exige un idempotency_token: derívalo de la operación (pedido y fecha, por ejemplo) para que un reintento no cree un duplicado.
  • No hay sandbox documentado ni límite de peticiones publicado más allá del error 429: prueba en solo lectura sobre la cuenta real y espera antes de reintentar cuando salga un 429.

Rebundle · 2026