pinterest-mcp

Защищённый удалённый MCP-мост для публикации оригинальных Pinterest-пинов без необходимости постоянно находиться в интерфейсе Pinterest.

Текущий статус

v0.1 реализует ядро безопасности Pinterest API + MCP. Он предназначен для собственного бизнес-аккаунта Pinterest компании Amy/LabDojo и по умолчанию работает в режиме dry-run.

Инструменты MCP

• pinterest_status — чтение состояния безопасности/конфигурации

• list_boards — чтение досок

• get_pin — прямое чтение пина

• preview_pin — проверка + поиск дубликатов, никогда не записывает

• publish_pin — создать только один пин с изображением в режиме live

• publish_batch — последовательная ограниченная пачка, максимум 10 пинов

• create_board — создать только одну доску в режиме live

В v0.1 намеренно нет инструментов обновления или удаления.

Related MCP server: SavePinner MCP

Контракт безопасности

1. PINTEREST_WRITE_MODE=dry-run используется по умолчанию.

2. Удалённая MCP-конечная точка требует bearer-аутентификации с MCP_BRIDGE_TOKEN.

3. Назначения пинов ограничены PINTEREST_ALLOWED_LINK_HOSTS (по умолчанию Etsy).

4. Изображения пинов должны использовать HTTPS.

5. Лимиты полей Pinterest применяются до вызовов API: заголовок 100, описание 800, альтернативный текст 500, ссылка 2048 символов.

6. Перед созданием мост проверяет целевую доску на наличие существующего пина с тем же нормализованным заголовком + ссылкой назначения.

7. После создания мост считывает возвращённый ID пина и проверяет доску, заголовок и назначение.

8. Пакетные записи выполняются последовательно и ограничены 10.

9. Никакие секреты не должны храниться в Git, Notion, Figma, документах Drive или в переписке чатов.

Аутентификация

MVP использует Pinterest Client Credentials, потому что этот мост автоматизирует собственный аккаунт владельца приложения. В переменных окружения развертывания храните только ID приложения и секрет приложения. Pinterest требует двухфакторную аутентификацию для этого типа гранта.

Запрашиваемые области доступа:

• boards:read

• boards:write

• pins:read

• pins:write

Сервер выпускает и кэширует токены доступа по мере необходимости; долгоживущий токен доступа не фиксируется в репозитории.

Предварительные требования для разработчика Pinterest

1. Используйте бизнес-аккаунт Pinterest и подтвердите его электронную почту.

2. Включите двухфакторную аутентификацию (2FA) для владельца аккаунта/приложения.

3. Зарегистрируйте приложение разработчика Pinterest и запросите доступ к API.

4. Пробный доступ позволяет выполнять создание пинов, но созданные пины видны только создателю. Стандартный доступ является целевым для публичной автоматизации в производстве.

5. Скопируйте App ID и App Secret только в секреты развертывания.

Окружение

Скопируйте .env.example и задайте:

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>

Развертывание

Репозиторий готов к работе с Vercel.

• health: /health

• MCP: /mcp

Конечная точка MCP использует stateless Streamable HTTP, поэтому она отлично работает на serverless-инфраструктуре.

Доставка изображений

Pinterest может создавать пины с изображениями из публичного HTTPS-адреса image_url. Приватные файлы Google Drive должны оставаться приватными и не являются допустимыми прямыми источниками медиа для Pinterest.

Планируемый рабочий процесс Remy:

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

Публичный уровень доставки намеренно отделён от источника истины. Drive остаётся авторитетным архивом.

Remy Relics

examples/remy-relics-parked-evidence-batch.json содержит четыре припаркованных пина с доказательствами, которые остаются после того, как первые четыре объектных пина были вручную размещены. Их URL изображений намеренно пусты, пока не будет подключён управляемый публичный медиаслой.

Локальные проверки

npm install
npm run check

Правило для продакшена

Не переключайте PINTEREST_WRITE_MODE=live, пока не выполнены все следующие условия:

• Доступ приложения Pinterest одобрен

• ID доски подтверждён данными из API

• URL медиа является утверждённым финальным производным файлом

• preview_pin не показывает коллизий

• заголовок/описание/alt/ссылка соответствуют канону

Затем выполняйте запись узконаправленно, проверяйте ID пина и возвращайте мост в режим dry-run при разовом обслуживании.