pinterest-mcp

Pinterest UI에 머물지 않고 원본 Pinterest Pin을 게시하기 위한 보호된 원격 MCP 브리지입니다.

현재 상태

v0.1은 Pinterest API + MCP 안전 코어를 구현합니다. Amy/LabDojo 자체 Pinterest 비즈니스 계정을 위해 설계되었으며 기본값은 dry-run입니다.

MCP 도구

• pinterest_status — 안전/구성 상태 읽기

• list_boards — 보드 읽기

• get_pin — Pin 직접 읽기

• preview_pin — 검증 및 중복 확인, 쓰기 없음

• publish_pin — live 모드에서 이미지 Pin 하나만 생성

• publish_batch — 순차 제한 배치, 최대 10개 Pin

• create_board — live 모드에서 보드 하나만 생성

v0.1에는 의도적으로 업데이트 또는 삭제 도구가 없습니다.

Related MCP server: SavePinner MCP

안전 계약

1. PINTEREST_WRITE_MODE=dry-run이 기본값입니다.

2. 원격 MCP 엔드포인트는 MCP_BRIDGE_TOKEN 베어러 인증을 요구합니다.

3. Pin 대상은 PINTEREST_ALLOWED_LINK_HOSTS로 제한됩니다(기본값은 Etsy).

4. Pin 이미지는 HTTPS를 사용해야 합니다.

5. Pinterest 필드 제한이 API 호출 전에 적용됩니다: 제목 100, 설명 800, 대체 텍스트 500, 링크 2048자.

6. 생성 전에 브리지는 대상 보드에서 정규화된 제목 + 대상 링크가 동일한 기존 Pin을 확인합니다.

7. 생성 후 브리지는 반환된 Pin ID를 다시 읽어 보드, 제목, 대상을 검증합니다.

8. 배치 쓰기는 순차적이며 최대 10개로 제한됩니다.

9. 비밀은 Git, Notion, Figma, Drive 문서 또는 채팅 기록에 있어서는 안 됩니다.

인증

MVP는 앱 소유자의 자체 계정을 자동화하므로 Pinterest Client Credentials를 사용합니다. 배포 환경 변수에는 앱 ID와 앱 시크릿만 저장하세요. Pinterest는 이 권한 부여 유형에 대해 2단계 인증을 요구합니다.

요청된 범위:

• boards:read

• boards:write

• pins:read

• pins:write

서버는 필요에 따라 액세스 토큰을 발급하고 캐시합니다. 장기 액세스 토큰은 커밋되지 않습니다.

Pinterest 개발자 사전 요구 사항

1. Pinterest 비즈니스 계정을 사용하고 이메일을 인증하세요.

2. 계정/앱 소유자에 대해 2FA를 활성화하세요.

3. Pinterest 개발자 앱을 등록하고 API 액세스를 요청하세요.

4. 평가판 액세스는 Pin 생성을 시험할 수 있지만 생성된 Pin은 생성자에게만 표시됩니다. 표준 액세스는 공개 자동화를 위한 프로덕션 목표입니다.

5. 앱 ID와 앱 시크릿은 배포 시크릿에만 복사하세요.

환경

.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

• MCP: /mcp

MCP 엔드포인트는 상태 없는(stateless) Streamable HTTP를 사용하므로 서버리스 인프라에서도 깔끔하게 작동합니다.

이미지 전달

Pinterest는 공개 HTTPS image_url에서 이미지 Pin을 생성할 수 있습니다. 비공개 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에는 처음 네 개의 오브젝트 Pin이 수동으로 게시된 후 계속 보류되어 있는 네 개의 증거 Pin이 포함되어 있습니다. 제어된 공개 미디어 계층이 연결될 때까지 해당 이미지 URL은 의도적으로 비어 있습니다.

로컬 점검

npm install
npm run check

프로덕션 규칙

다음 조건이 모두 충족될 때까지 PINTEREST_WRITE_MODE=live로 전환하지 마세요:

• Pinterest 앱 액세스가 승인되었을 것

• API 읽기로 보드 ID가 검증되었을 것

• 미디어 URL이 승인된 최종 파생물일 것

• preview_pin에 충돌이 없을 것

• 제목/설명/대체 텍스트/링크가 표준(canon)과 일치할 것

그런 다음 좁은 범위로 쓰고, Pin ID를 검증하고, 일회성 유지보수 시 브리지를 다시 dry-run으로 돌려놓으세요.