pinterest-mcp

Claude(또는 모든 MCP 클라이언트)가 Pinterest를 검색하고 이미지를 컴퓨터에 직접 다운로드할 수 있게 해주는 MCP 서버입니다. 수동으로 탐색하거나 저장할 필요가 없습니다.

이 서버는 Pinterest의 내부 웹 API(브라우저에서 로그인했을 때 브라우저가 보내는 것과 동일한 요청)를 사용하며, 개인 세션 쿠키로 인증합니다. 공식 공개 Pinterest API는 없으므로 이 프로젝트는 내부 API를 리버스 엔지니어링한 것입니다.

기능

• 검색 및 다운로드 — 키워드를 입력하면 N개의 전체 해상도 이미지를 로컬에 저장합니다.

• 보드 다운로드 — 보드 링크(pin.it 단축 링크도 가능)를 입력하면 해당 보드에서 N개의 이미지를 가져옵니다.

• 보드 목록 — 직접 링크 없이 사용자의 보드와 핀 수를 확인합니다.

• 보드 정보 — 보드의 이름과 핀 수를 조회합니다.

• 재실행 시 중복 제거 — 동일한 쿼리나 보드를 다시 가져오면 이미 다운로드한 이미지는 건너뛰고, 다시 가져오거나 오래된 파일을 남기지 않습니다.

• 메타데이터 사이드카 — 각 이미지의 제목, 설명, 소스 링크가 숨겨진 .meta 폴더의 해당 .json 파일에 저장되어 이미지 폴더 자체는 깔끔하게 유지됩니다.

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

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 참조.