pinterest-mcp

MCP-сервер, который позволяет Claude (или любому MCP-клиенту) искать в Pinterest и скачивать изображения прямо на ваш компьютер — без ручного просмотра и ручного сохранения.

Он общается с собственным внутренним веб-API Pinterest (теми же запросами, которые ваш браузер отправляет при входе в систему), аутентифицируясь с помощью вашей личной сессионной cookie. Для этого нет официального публичного API Pinterest, поэтому этот проект реверс-инжинирит внутренний.

Возможности

• Поиск и скачивание — укажите ключевое слово, получите N полноразмерных изображений, сохранённых локально.

• Скачивание с доски — укажите ссылку на доску (работают короткие ссылки pin.it), получите N изображений с неё.

• Список досок — просмотр досок пользователя с количеством пинов, без необходимости прямой ссылки.

• Информация о доске — узнайте название доски и количество пинов.

• Дедупликация при повторном запуске — повторное получение того же запроса или доски пропускает уже скачанные изображения, вместо повторного скачивания или оставления устаревших файлов.

• Метаданные в отдельных файлах — заголовок, описание и ссылка на источник каждого изображения сохраняются в соответствующий файл .json в скрытой папке .meta, чтобы сама папка с изображениями оставалась чистой.

Related MCP server: pinterest-mcp

Требования

• Python 3.14+

• uv

• Аккаунт Pinterest, выполненный вход через браузер.

Установка

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

Получение вашей cookie Pinterest

Это работает от вашего имени, используя вашу собственную сессию входа — он не создаёт и не требует отдельного API-ключа.

1. Откройте pinterest.com в браузере и убедитесь, что вы вошли в систему.

2. Откройте DevTools (F12) → вкладку Network.

3. Перезагрузите страницу, нажмите на любой запрос к pinterest.com.

4. В заголовках запроса найдите Cookie: и скопируйте всё значение.

Держите это значение в секрете — оно эквивалентно вашей сессии входа.

Настройка

Зарегистрируйте сервер в 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 по умолчанию равен www.pinterest.com. Если Pinterest перенаправляет вас на домен, специфичный для страны, при входе (например, in.pinterest.com), используйте его.

Изображения сохраняются в ~/Pictures/pinterest-downloads/<name>/ по умолчанию, или в пользовательский out_dir, который вы передаёте инструменту.

Использование

После настройки просто спросите:

• «Найди на Pinterest минималистичный дизайн логотипа, скачай 10»

• «Покажи мои доски Pinterest»

• «Получи 5 пинов с этой доски: https://pin.it/xxxxxxx»

Инструменты

Разработка

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

Отказ от ответственности

Это использует внутренний, неофициальный API Pinterest, а не публичный API для разработчиков. Он может сломаться, если Pinterest изменит свои конечные точки, а интенсивное использование может привлечь внимание их системы обнаружения ботов. Используйте его с собственным аккаунтом на свой страх и риск.

Лицензия

MIT — см. LICENSE.

Вклад

См. CONTRIBUTING.md.