PigBun Pinterest MCP

English | 简体中文

基于 Model Context Protocol 的 Pinterest 设计灵感研究工具 — 为设计师和创意工作者提供原子级别的 Pinterest 数据操作能力。

免责声明

本项目为开源技术研究项目，仅供学习 MCP 协议和浏览器自动化技术之用。

• 本项目与 Pinterest 没有任何关联，非官方产品，未获得任何形式的授权或认可
• 使用者应自行遵守 Pinterest 平台的使用条款和相关服务条款
• 本软件按"原样"（AS IS）提供，不提供任何明示或暗示的保证
• 使用者需自行承担使用本工具的全部风险和法律责任
• 请勿将本工具用于任何违反法律法规或平台规则的用途

快速开始

1. 获取 API Key

前往 pigbunai.com 注册账号，在 Dashboard 中创建 API Key。

免费配额：每日 50 次调用。

2. 安装浏览器（通常自动完成）

首次使用时，MCP Server 会自动检测并安装所需的浏览器。如果自动安装失败，可手动运行：

npx playwright install chromium

3. 配置 MCP 客户端

适用于 Claude Desktop、Cursor、Windsurf、Claude Code 等支持 MCP 的客户端：

{
  "mcpServers": {
    "pinterest": {
      "command": "npx",
      "args": ["@pigbun-ai/pigbun-pinterest-mcp@latest"],
      "env": {
        "PIGBUN_API_KEY": "pb_live_your_key_here"
      }
    }
  }
}

将 pb_live_your_key_here 替换为你在 Dashboard 中获取的 API Key。

功能一览

搜索与发现

| 工具 | 说明 | |------|------| | search_pins | 关键词搜索 Pin（设计灵感发现） | | search_boards | 关键词搜索画板（主题参考集合） | | get_trending_pins | 获取热门趋势 Pin（可选分类过滤） | | get_related_pins | 获取相关推荐 Pin（Pinterest "More like this"） |

详情获取

| 工具 | 说明 | |------|------| | get_pin_detail | 获取单个 Pin 详情（高清图、描述、来源、互动数据） | | get_board_pins | 提取画板内所有 Pin（分析策展集合） | | get_user_boards | 获取用户/品牌所有画板 | | get_user_profile | 获取用户主页信息（粉丝数、Pin 数等） |

视觉分析与下载

| 工具 | 说明 | |------|------| | inspect_image_visually | 获取图片 Base64（供 AI 视觉分析颜色、材质、构图） | | download_images_to_local | 批量下载图片到本地（灵感板素材库） |

典型使用场景

设计灵感研究

请用 Pinterest 搜索 "minimal scandinavian interior" 的灵感图，
然后视觉分析前 3 张图的色彩搭配和构图特点。

品牌视觉分析

请获取 Nike 的 Pinterest 画板列表，
然后分析其 "Running" 画板的视觉风格和色调规律。

趋势报告

请获取 Pinterest 上 fashion 类别的热门趋势 Pin，
分析当前的流行元素和配色趋势。

素材收集

请搜索 "Y2K typography design" 相关的 Pin，
下载前 10 张到本地 ~/Downloads/y2k-inspo/ 文件夹。

数据提取策略

工具采用三层优先级提取数据：

1. SPA Hydration State — 优先从 window.__PWS_DATA__ / __REDUX_STATE__ 获取结构化数据
2. DOM 选择器 — 回退到 data-test-id 属性选择器提取
3. 无限滚动收集 — 自动滚动 + 去重 + 限量控制

调试

使用 MCP Inspector：

PIGBUN_API_KEY=pb_live_xxx npx @modelcontextprotocol/inspector npx @pigbun-ai/pigbun-pinterest-mcp

注意事项

• 当前为访客模式，无需登录即可使用所有工具
• Pinterest 有反爬机制，工具内置 Stealth 浏览器绕过检测
• 图片视觉分析使用 sharp 自动缩放至 768px 以内，节省 AI context window
• 所有操作从本地 IP 发起，不经过中心化代理
• 请合理使用，遵守平台相关规则

API 配额

API Key 用于接口调用频率管理和滥用防护：

| 配额 | 说明 | |------|------| | 免费 | 每日 50 次调用 | | 进阶 | 了解更多 |

前往 pigbunai.com 了解详情。

License

ISC — 详见 LICENSE