pinterest-mcp
pinterest-mcp
Claude(또는 모든 MCP 클라이언트)가 Pinterest를 검색하고 이미지를 컴퓨터에 직접 다운로드할 수 있게 해주는 MCP 서버입니다. 수동으로 탐색하거나 저장할 필요가 없습니다.
이 서버는 Pinterest의 내부 웹 API(브라우저에서 로그인했을 때 브라우저가 보내는 것과 동일한 요청)를 사용하며, 개인 세션 쿠키로 인증합니다. 공식 공개 Pinterest API는 없으므로 이 프로젝트는 내부 API를 리버스 엔지니어링한 것입니다.
기능
검색 및 다운로드 — 키워드를 입력하면 N개의 전체 해상도 이미지를 로컬에 저장합니다.
보드 다운로드 — 보드 링크(
pin.it단축 링크도 가능)를 입력하면 해당 보드에서 N개의 이미지를 가져옵니다.보드 목록 — 직접 링크 없이 사용자의 보드와 핀 수를 확인합니다.
보드 정보 — 보드의 이름과 핀 수를 조회합니다.
재실행 시 중복 제거 — 동일한 쿼리나 보드를 다시 가져오면 이미 다운로드한 이미지는 건너뛰고, 다시 가져오거나 오래된 파일을 남기지 않습니다.
메타데이터 사이드카 — 각 이미지의 제목, 설명, 소스 링크가 숨겨진
.meta폴더의 해당.json파일에 저장되어 이미지 폴더 자체는 깔끔하게 유지됩니다.
Related MCP server: Pinterest MCP Server
요구 사항
Python 3.14+
브라우저에서 로그인한 Pinterest 계정
설치
git clone https://github.com/Nuu-maan/pinterest-mcp.git
cd pinterest-mcp
uv syncPinterest 쿠키 가져오기
이 서버는 당신으로 실행되며, 당신의 로그인 세션을 사용합니다. 별도의 API 키를 만들거나 필요로 하지 않습니다.
브라우저에서 pinterest.com을 열고 로그인되어 있는지 확인합니다.
DevTools(F12)를 열고 Network 탭으로 이동합니다.
페이지를 새로고침하고
pinterest.com에 대한 요청을 클릭합니다.요청 헤더에서
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.pyPINTEREST_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 참조.
Available Tools
4 toolsfetch_pinterest_boardB
Download up to count full-resolution images from a Pinterest board (accepts pin.it short links).
Inputs: count (required), board_url (required), out_dir.
get_pinterest_board_infoA
Look up a Pinterest board's name and total pin count from its URL (accepts pin.it short links).
Inputs: board_url (required).
get_pinterest_boardsA
List a Pinterest user's boards with url and pin count.
Inputs: username (required).
search_pinterest_imagesB
Search Pinterest for query and download up to count full-resolution images.
Inputs: query (required), count, out_dir.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clear purpose: search images, list boards, get board info, and fetch board images. The slight overlap between search_pinterest_images and fetch_pinterest_board (both download images) is mitigated by their distinct sources (query vs. board). No two tools are truly confusing.
All names follow a verb_noun pattern (search, get, fetch). However, there is a mix of 'get' and 'fetch' for similar actions, and 'get_pinterest_boards' vs 'get_pinterest_board_info' could be slightly more distinctive. Still, the pattern is consistent enough for an agent to predict behavior.
Four tools is a reasonable scope for a Pinterest-focused server. It covers the core actions of searching and retrieving board content without being overly sparse or bloated. The count fits well within the typical 3-15 range.
The server covers browsing and downloading images from searches and boards, but lacks operations for pin-level details, user profiles, or any create/update/delete actions. For a read-only image-centric tool, it's decent, but there are noticeable gaps for a full Pinterest API surface.
Maintenance
Related MCP Connectors
Pinterest pins, boards, profiles and keyword search to JSON: saves, images, links, creators.
Download and save Pinterest boards, Instagram posts and web pages into a library you own.
Pinterest automation: schedule pins, manage boards, write AI blogs and auto-pin them.
Create Pinterest pins from blog posts and Shopify/Etsy products, and schedule them to your boards.
Related MCP Servers
- AlicenseAqualityDmaintenanceExtracts images, gifs, videos, and search results from Pinterest without authentication. Supports search, pin details, board pins, related pins, autocomplete, and media downloads.61MIT
- AlicenseBqualityDmaintenanceEnables image search and information retrieval from Pinterest using the Model Context Protocol. Supports searching by keywords, getting similar pins, and downloading images directly.5MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to search public Pinterest pins, retrieve pin metadata and media URLs, and download matching images, GIFs, or videos into a local folder, with read-only tools and explicit confirmation for downloads.-
- AlicenseAqualityBmaintenanceEnables AI coding agents to search pins, inspect and preview images, find related pins, read public boards, and download full-resolution originals with no login, API key, or headless browser required.6155 npm1MIT