pinterest-mcp

Un puente MCP remoto y protegido para publicar Pines originales de Pinterest sin vivir en la interfaz de Pinterest.

Estado actual

v0.1 implementa el núcleo de seguridad de la API de Pinterest + MCP. Está diseñado para la cuenta comercial de Pinterest de Amy/LabDojo y usa dry-run por defecto.

Herramientas MCP

• pinterest_status — leer el estado de seguridad/configuración

• list_boards — leer tableros

• get_pin — lectura directa del Pin

• preview_pin — validar + comprobar duplicados, nunca escribe

• publish_pin — crear solo un Pin de imagen en modo live

• publish_batch — lote secuencial acotado, máximo 10 Pines

• create_board — crear solo un tablero en modo live

Deliberadamente, no hay herramientas de actualización ni de eliminación en v0.1.

Related MCP server: SavePinner MCP

Contrato de seguridad

1. PINTEREST_WRITE_MODE=dry-run es el valor predeterminado.

2. El endpoint MCP remoto requiere autenticación de portador con MCP_BRIDGE_TOKEN.

3. Los destinos de los Pines están restringidos a PINTEREST_ALLOWED_LINK_HOSTS (Etsy por defecto).

4. Las imágenes de los Pines deben usar HTTPS.

5. Los límites de campos de Pinterest se aplican antes de las llamadas a la API: título 100, descripción 800, texto alternativo 500, enlace 2048 caracteres.

6. Antes de la creación, el puente comprueba en el tablero destino si ya existe un Pin con el mismo título normalizado + enlace de destino.

7. Después de la creación, el puente vuelve a leer el ID del Pin devuelto y verifica tablero, título y destino.

8. Las escrituras por lotes son secuenciales y están limitadas a 10.

9. Ningún secreto debe estar en Git, Notion, Figma, documentos de Drive ni transcripciones de chat.

Autenticación

El MVP usa las Credenciales de cliente de Pinterest porque este puente automatiza la cuenta del propio propietario de la aplicación. Guarda solo el App ID y el App Secret en las variables de entorno de despliegue. Pinterest requiere autenticación de dos factores para este tipo de concesión.

Scopes solicitados:

• boards:read

• boards:write

• pins:read

• pins:write

El servidor genera y almacena en caché los tokens de acceso según sea necesario; no se hace commit de ningún token de acceso de larga duración.

Requisitos previos de desarrollador de Pinterest

1. Usa una cuenta comercial de Pinterest y verifica su correo electrónico.

2. Habilita 2FA para el propietario de la cuenta/aplicación.

3. Registra una aplicación de desarrollador de Pinterest y solicita acceso a la API.

4. El acceso de prueba puede ejercitar la creación de Pines, pero los Pines creados son visibles solo para el creador. El acceso estándar es el objetivo de producción para la automatización pública.

5. Copia el App ID y el App Secret solo en los secretos de despliegue.

Entorno

Copia .env.example y configura:

PINTEREST_APP_ID=...
PINTEREST_APP_SECRET=...
PINTEREST_WRITE_MODE=dry-run
PINTEREST_DEFAULT_BOARD_ID=...
PINTEREST_ALLOWED_LINK_HOSTS=etsy.com,www.etsy.com
MCP_BRIDGE_TOKEN=<random 24+ char secret>

Despliegue

El repositorio está listo para Vercel.

• salud: /health

• MCP: /mcp

El endpoint MCP usa HTTP Streamable sin estado, por lo que funciona correctamente en infraestructura serverless.

Entrega de imágenes

Pinterest puede crear Pines de imagen a partir de una image_url pública HTTPS. Los archivos privados de Google Drive deben permanecer privados y no son fuentes de medios directas válidas para Pinterest.

Flujo de trabajo planificado de Remy:

Drive approved master -> posting derivative -> controlled public asset URL -> preview_pin -> publish_pin/publish_batch -> Pinterest readback -> Notion status

La capa de entrega pública está intencionadamente separada de la fuente de verdad. Drive sigue siendo el archivo autoritativo.

Remy Relics

examples/remy-relics-parked-evidence-batch.json contiene los cuatro Pines de evidencia que permanecen aparcados después de que los cuatro primeros Pines de objeto se publicaran manualmente. Sus URL de imagen están intencionadamente en blanco hasta que la capa de medios pública controlada esté conectada.

Comprobaciones locales

npm install
npm run check

Regla de producción

No cambies PINTEREST_WRITE_MODE=live hasta que se cumplan todas las condiciones siguientes:

• El acceso a la aplicación de Pinterest está aprobado

• El ID del tablero se verifica a partir de la lectura de la API

• La URL del medio es el derivado final aprobado

• preview_pin no muestra ninguna colisión

• título/descripción/alt/enlace coinciden con el canon

Luego escribe de forma restringida, verifica el ID del Pin y vuelve a dejar el puente en dry-run cuando realices un mantenimiento puntual.