pinterest-mcp

Ein MCP-Server, mit dem Claude (oder ein beliebiger MCP-Client) Pinterest durchsuchen und Bilder direkt auf deinen Rechner herunterladen kann – ohne manuelles Browsen, ohne manuelles Speichern.

Er spricht mit Pinterests eigener interner Web-API (denselben Anfragen, die dein Browser macht, wenn du angemeldet bist), authentifiziert mit deinem persönlichen Session-Cookie. Es gibt keine offizielle öffentliche Pinterest-API dafür, daher hat dieses Projekt die interne rekonstruiert.

Features

• Suche und Download – gib ein Stichwort ein, erhalte N Bilder in voller Auflösung, die lokal gespeichert werden.

• Board-Download – gib einen Board-Link ein (Kurzlinks wie pin.it funktionieren), erhalte N Bilder davon.

• Boards auflisten – sieh dir die Boards eines Benutzers mit Pin-Anzahl an, ohne einen direkten Link zu benötigen.

• Board-Informationen – Name und Pin-Anzahl eines Boards nachschlagen.

• Deduplizierung bei erneutem Lauf – beim erneuten Abrufen derselben Abfrage oder desselben Boards werden bereits heruntergeladene Bilder übersprungen, anstatt sie erneut zu laden oder veraltete Dateien zurückzulassen.

• Metadaten-Begleitdateien – Titel, Beschreibung und Quelllink jedes Bildes werden in einer passenden .json-Datei in einem versteckten .meta-Ordner gespeichert, sodass der Bildordner selbst sauber bleibt.

Related MCP server: pinterest-mcp

Requirements

• Python 3.14+

• uv

• Ein Pinterest-Konto, das im Browser angemeldet ist

Install

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

Getting your Pinterest cookie

Dies läuft als du und verwendet deine eigene angemeldete Sitzung – es erstellt oder benötigt keinen separaten API-Schlüssel.

1. Öffne pinterest.com in deinem Browser und stelle sicher, dass du angemeldet bist.

2. Öffne DevTools (F12) → Tab Netzwerk.

3. Lade die Seite neu und klicke auf eine beliebige Anfrage an pinterest.com.

4. Suche in den Anfrage-Headern nach Cookie: und kopiere den gesamten Wert.

Halte diesen Wert geheim – er entspricht deiner Anmeldesitzung.

Configure

Registriere den Server bei 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 ist standardmäßig auf www.pinterest.com gesetzt. Wenn Pinterest dich nach der Anmeldung auf eine länderspezifische Domain umleitet (z. B. in.pinterest.com), verwende stattdessen diese.

Bilder werden standardmäßig unter ~/Pictures/pinterest-downloads/<name>/ gespeichert, oder in einem benutzerdefinierten out_dir, das du an ein Tool übergibst.

Usage

Nach der Konfiguration kannst du einfach fragen:

• „Suche auf Pinterest nach minimalistischen Logo-Designs, lade 10 herunter"

• „Liste meine Pinterest-Boards auf"

• „Hole 5 Pins von diesem Board: https://pin.it/xxxxxxx"

Tools

Development

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

Disclaimer

Dies verwendet Pinterests interne, inoffizielle API, keine öffentliche Entwickler-API. Sie kann brechen, wenn Pinterest seine Endpunkte ändert, und intensive Nutzung könnte die Aufmerksamkeit ihrer Bot-Erkennung erregen. Verwende sie mit deinem eigenen Konto, auf eigenes Risiko.

License

MIT – siehe LICENSE.

Contributing

Siehe CONTRIBUTING.md.