Skip to main content
Glama

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+

  • 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"

도구

도구

설명

search_pinterest_images(query, count=20, out_dir=...)

이미지 검색 및 다운로드

get_pinterest_boards(username)

사용자의 보드 목록

get_pinterest_board_info(board_url)

보드 이름과 핀 수 조회

fetch_pinterest_board(board_url, count, out_dir=...)

보드에서 이미지 다운로드

개발

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 tools
fetch_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

    A3.5/5.0

    Scored across 4 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Extracts images, gifs, videos, and search results from Pinterest without authentication. Supports search, pin details, board pins, related pins, autocomplete, and media downloads.
      6
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables image search and information retrieval from Pinterest using the Model Context Protocol. Supports searching by keywords, getting similar pins, and downloading images directly.
      5
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      6
      155 npm
      1
      MIT