Glowe Pinterest MCP

Un descargador public de Pinterest, utilizable de dos maineras: una CLI para los humanos y un servidor MCP sdio para los agentes de IA. El núcleo es único: la CLI y el MCP obtienen por lo tanto los mismos resultsados, aplican las mismas validás de URL and descargan únicamente en una carpeta local configurada.

Utilice únicamente los contenidos para los que usted have the rights necessary. This project reads running published data by Pinterest: no official Pinterest API, no security to evacion connexion, a "paywall" or "dispozation restriction".

Qué hace el proyecto

• Resolves the links de Pines de Pinterest and the short links pin.it.

• Búscado público by keywords.

• Extracta título, descripión, URL del Pin y los outputs imagen/GIF/vídeo published.

• Intenta descargar la imagen originals, luego las variants 1200x, 736x, etc., si Pinterest no sirves the best version.

• Descarga de manera atómica: archivo .part, renombrado final, sin sobrescribir un archivo existente.

• Rechaza las redirecciones y URLs de medios out of pinterest.*, pin.it and los CDN *.pinimg.com autorizados.

La búsqueda usa el recurso public structured que Pinterest presenta, with un letter HTML transparent if no is not available. Pinterest puede render only la primera result segment without connection: not a guaranteriza; no use it to extract complete tableros.

Related MCP server: pinterest-mcp

Instalación local

Se requires Node 20 or more recent.

cd tools/pinterest-mcp
npm install

Elija explícitamente la carpeta de salida:

export PINTEREST_MCP_DOWNLOAD_DIR="$PWD/downloads"

Les médios se limitan a 35 MiB por defect. Adjusted only if necessary:

export PINTEREST_MCP_MAX_MEDIA_BYTES=52428800

CLI — para los humanos

Todas las comandos acceptent --json for a output usable with scripties and are still available.

# Rechercher des références, sans écrire de fichier
npm run cli -- search "coiffure bob femme" --limit 8

# Charger la page suivante avec le nextCursor renvoyé par la recherche précédente
npm run cli -- search "coiffure bob femme" --limit 8 --cursor "CURSEUR_RENVOYÉ"

# Inspecter exactement ce qu’un Pin expose avant de télécharger
npm run cli -- inspect "https://pin.it/EXEMPLE" --json

# Télécharger un ou plusieurs Pins dans un dossier local contrôlé
npm run cli -- download "https://www.pinterest.com/pin/99360735500167749/" --output ./downloads

# Éviter les vidéos lorsque seules les images intéressent le workflow
npm run cli -- download "https://www.pinterest.com/pin/99360735500167749/" --no-video

# Recherche suivie d’un téléchargement : à employer seulement après validation du volume
npm run cli -- search-download "hairstyle editorial" --limit 5 --output ./downloads

The download and search-download commands never take an output path from a URL or a remote response. The archive names are normalized and the collisions produce a suffix instead a sobrescritura.

MCP — para los agentes IA

Ejecute el server directment :

PINTEREST_MCP_DOWNLOAD_DIR="$PWD/downloads" npm run mcp

Uses stdio: no head, no disting Pinterest, no application log in stdout. Errors and in step diagnostic remain in stderr, to not corrupt MCP protocol.

Ejemplo de config localuing de Codode_ (~/.codex/config.toml):

[mcp_servers.glowe_pinterest]
command = "node"
args = ["/CHEMIN_ABSOLU/glowe/tools/pinterest-mcp/bin/mcp-server.mjs"]

[mcp_servers.glowe_pinterest.env]
PINTEREST_MCP_DOWNLOAD_DIR = "/CHEMIN_ABSOLU/pinterest-downloads"
PINTEREST_MCP_MAX_MEDIA_BYTES = "36700160"

Después de modificar la configuración, reinicie el cliente MCP/Codex para que secure el proces. For any other clientMCP, uses the same node command, same absolute parameter and same environs products.

Contrat de las herramientas MCP

The read tools carry the MCP readOnlyHint annotation. Herramientas that writes to disk explicant in his descriptions that confirmation from usuario is requerired. Un agent should always "max" this sequence: output, → show selection → selection, → confirm activity → follow-up.

Example of MCP responses

pinterest_get_pin returns a JSON structsent with:

{
  "id": "99360735500167749",
  "pinUrl": "https://www.pinterest.com/pin/99360735500167749/",
  "title": "…",
  "media": [
    {
      "type": "image",
      "url": "https://i.pinimg.com/originals/...jpg",
      "alternatives": ["https://i.pinimg.com/1200x/...jpg"]
    }
  ]
}

The agent should not invent the "disponibility" of a medium; you rely on them. media, then indicate each successful or failed charge separately.

Test and quality control

# Tests déterministes : URLs, parsing SSR, repli qualité, écriture atomique, handshake MCP
npm test

# Vérification réseau explicite : recherche réelle, extraction d’un Pin, téléchargement CDN réel
npm run test:live

The "network test" is deliberately separate: Pinterest may change its public HTML or make one of the Pins unavailable. It should not be masked by single unit tests.

Inspirationes choices

"The design" inspira en los projects MIP intracodes " pinterest-downloader (ordering originals override and quality cascade) and PPinterestDownloader (IP contracts of y And bytes structure /din/order). La interfaz MCP se inends in mcp-pinterest; "but" is implemented ins autonomous, sin, then better, with reverse "opp" beneficial.

For "Pins y" "tabs" to the connected account of "Pinterest", prefer official Pinterest API & OAuth. Las CDPinterest terms and "with" "derechos" apply to "what he" download.