Pinterest MCP

English · 简体中文

Pinterest MCP 是一个开源 MCP 服务，可让 Claude Code、Codex、Cursor 及其他 MCP 客户端直接访问 Pinterest——搜索 Pin、真正查看图片、追踪“类似内容”、阅读画板并下载原图。它专为设计师和前端开发者打造，适合那些每次开始任务都会先收集参考素材的人。

无需登录 Pinterest。无需 API 密钥。无需无头浏览器。

❌ 不使用 Pinterest MCP

• 你切换到浏览器，搜索、滚动、手动保存图片，再把图片拖回聊天中。
• AI 只能获取你记得粘贴的图片，却没有来源、颜色或上下文信息。

✅ 使用 Pinterest MCP

> Find 20 dark dashboard UIs on Pinterest, look at the first 8,
  pick the 3 with the most restrained palette and download them.

Agent 会搜索、查看缩略图、解释选择理由、将全分辨率文件保存到磁盘，还能直接据此开始构建界面。

功能

• ⚡ 快速 — 使用 pinterest.com 同样的 JSON 接口；20 个 Pin 约需 2–3 秒，无需启动 Chrome。
• 👀 模型可以看见图片 — 可选缩略图会以图片形式返回，因此 Agent 能判断风格、布局和颜色，而不只是查看标题。
• 🧾 丰富的元数据 — 标题、描述、原图 URL 和尺寸（仅有缩略图的 Pin 会标记为 low_res）、主色、来源网站、画板、创作者和日期。广告会被过滤。
• 🔁 深入探索 — 相关 Pin、整个画板、使用书签分页。
• 🛡️ 稳健可靠 — 保持匿名会话，并在 Pinterest 偶尔出现“伪造的信息流末尾”时重试。
• 🪶 节省令牌 — 折叠标签墙，丢弃不可用字段。
• 🎬 也支持视频 — 视频 Pin 会提供 MP4 video_url；可筛选为仅显示视频，用作动态参考。
• 📥 下载 — 支持图片原图（自动回退到 736px 版本）和 MP4 视频，下载来源仅限 *.pinimg.com。

快速开始

需要 Node.js ≥ 20.18。

claude mcp add pinterest --scope user -- npx -y @sunkimkk/pinterest-mcp

[mcp_servers.pinterest]
command = "npx"
args = ["-y", "@sunkimkk/pinterest-mcp"]

{
  "mcpServers": {
    "pinterest": {
      "command": "npx",
      "args": ["-y", "@sunkimkk/pinterest-mcp"]
    }
  }
}

git clone https://github.com/sunkimk/pinterest-mcp.git
cd pinterest-mcp && npm install
claude mcp add pinterest --scope user -- node "$PWD/src/server.js"

search、related_pins 和 board_pins 接受 previews: N，可为前 N 个结果附加缩略图；也接受 media: "video"，仅返回视频 Pin（每个 Pin 都包含一个 MP4 video_url）——很适合用作动态和交互参考。

示例提示词

• “在 Pinterest 上搜索玻璃拟态登录界面，并展示 8 张缩略图。”
• “这些设计有什么共同点——布局、配色、字体？”
• “查找与 https://www.pinterest.com/pin/1128714725389331478/ 类似的 Pin。”
• “列出 https://www.pinterest.com/awsmd_com/app-design/ 上的所有内容。”
• “查找 10 个个人主页动画视频并下载。”
• “将第 2、5 和 7 个下载到 ~/Desktop/refs/login。”

提示：英文关键词能返回更多结果。添加 ui、app、dribbble、poster 或 moodboard 等词，可以引导搜索结果的风格。

配置

使用 Claude Code 的示例：

claude mcp add pinterest --scope user -e MCP_PINTEREST_PROXY=http://127.0.0.1:7890 -- npx -y @sunkimkk/pinterest-mcp

常见问题

为什么无法获取搜索结果的详情？ 未登录时的搜索结果带有匿名 ID，Pinterest 无法解析这些 ID。搜索结果中已经包含了所有可用信息；get_pin 和 related_pins 需要真实的 Pin 链接（pinterest.com/pin/<number>/）。

网络错误？ 如果你所在的地区屏蔽了 pinterest.com，请设置 MCP_PINTEREST_PROXY。

这个工具会失效吗？ 它使用的是 Pinterest 的网页端点，而非官方 API，因此 Pinterest 改版后可能需要更新。请关注代码仓库，或查看更新日志。

开发

npm install
npm test        # spins up the server and calls every tool against live pinterest.com

请参阅 CHANGELOG.md 了解版本发布历史。欢迎提交问题和 PR。

免责声明

本项目与 Pinterest 无关联，也未获得 Pinterest 的认可或赞助。请以合理的请求频率将其用于个人灵感参考，遵守 Pinterest 的服务条款，并尊重创作者的版权——下载的图片仅供参考。

致谢

感谢 terryso/mcp-pinterest 首先探索通过 MCP 使用 Pinterest。

Star 历史

许可证

MIT © sunkimk