pinterest-mcp

Un servidor MCP que permite a Claude (o cualquier cliente MCP) buscar en Pinterest y descargar imágenes directamente a tu máquina — sin navegación manual, sin guardado manual.

Habla con la API web interna de Pinterest (las mismas peticiones que hace tu navegador cuando inicias sesión), autenticado con tu cookie de sesión personal. No existe una API pública oficial de Pinterest para esto, así que este proyecto ha hecho ingeniería inversa de la interna.

Características

• Búsqueda y descarga — introduce una palabra clave y obtén N imágenes a resolución completa guardadas localmente.

• Descarga de tablero — introduce un enlace de tablero (los enlaces cortos pin.it funcionan) y obtén N imágenes de él.

• Listar tableros — ve los tableros de un usuario, con el número de pines, sin necesidad de un enlace directo.

• Información del tablero — consulta el nombre y el número de pines de un tablero.

• Deduplicación al re-ejecutar — al volver a buscar la misma consulta o tablero, se omiten las imágenes que ya descargaste en lugar de volver a descargarlas o dejar archivos obsoletos.

• Archivos de metadatos — el título, la descripción y el enlace de origen de cada imagen se guardan en un archivo .json correspondiente dentro de una carpeta oculta .meta, para que la carpeta de imágenes se mantenga limpia.

Related MCP server: pinterest-mcp

Requisitos

• Python 3.14+

• uv

• Una cuenta de Pinterest, con sesión iniciada en el navegador

Instalación

git clone https://github.com/Nuu-maan/pinterest-mcp.git
cd pinterest-mcp
uv sync

Cómo obtener tu cookie de Pinterest

Esto se ejecuta como tú, usando tu propia sesión iniciada — no crea ni necesita una clave de API separada.

1. Abre pinterest.com en tu navegador y asegúrate de haber iniciado sesión.

2. Abre las herramientas de desarrollador (F12) → pestaña Red.

3. Recarga la página y haz clic en cualquier petición a pinterest.com.

4. En las cabeceras de la petición, busca Cookie: y copia el valor completo.

Mantén este valor en secreto: equivale a tu sesión de inicio de sesión.

Configuración

Registra el servidor con Claude Code:

claude mcp add pinterest --scope user \
  -e PINTEREST_COOKIE="<paste your cookie here>" \
  -e PINTEREST_DOMAIN="www.pinterest.com" \
  -- uv --directory /path/to/pinterest-mcp run server.py

PINTEREST_DOMAIN tiene como valor predeterminado www.pinterest.com. Si Pinterest te redirige a un dominio específico de tu país al iniciar sesión (por ejemplo, in.pinterest.com), usa ese en su lugar.

Las imágenes se guardan en ~/Pictures/pinterest-downloads/<nombre>/ por defecto, o en un out_dir personalizado que pases a una herramienta.

Uso

Una vez configurado, solo pregunta:

• "Busca en Pinterest diseño de logotipo minimalista, descarga 10"

• "Lista mis tableros de Pinterest"

• "Obtén 5 pines de este tablero: https://pin.it/xxxxxxx"

Herramientas

Desarrollo

uv run -- python -m tests.test_pins
uv run -- python -m tests.test_downloader

Aviso legal

Esto utiliza la API interna y no oficial de Pinterest, no una API pública para desarrolladores. Puede dejar de funcionar si Pinterest cambia sus endpoints, y un uso intensivo puede llamar la atención de su detección de bots. Úsalo con tu propia cuenta, bajo tu propio riesgo.

Licencia

MIT — consulta LICENSE.

Contribuciones

Consulta CONTRIBUTING.md.