Pinterest MCP服务

一个为Pinterest API v5提供MCP(模型上下文协议)服务器的开源项目,支持创建图钉、管理看板及跟踪分析。

  • by clugtu
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 clugtu/pinterest-mcp

使用说明

Pinterest-MCP

一 MCP(模型上下文协议) 服务器 Pinterest API v5.

创建引脚、管理电路板和跟踪分析——所有这些都来自AI代理。

第一个开源Pinterest MCP服务器。


特性

工具 说明
create_pin 创建带有图像、标题、描述和链接的新Pin
update_pin 编辑现有pin的元数据
delete_pin 取下一个销钉
get_pin_analytics 印象、保存、链接点击、参与率
list_boards 列出您的董事会
create_board 创建新板
get_board_pins 列出电路板上的所有引脚
search_pins 按关键字搜索公共密码
get_account_analytics 客户级指标:印象、节省、参与度
bulk_create_pins 在一次呼叫中创建多个引脚(速率受限)
get_trending 细分市场中的搜索和兴趣趋势

安装

pip install pinterest-mcp

或者直接与 uvx:

uvx pinterest-mcp

认证

Pinterest使用OAuth 2.0。你需要一个 Pinterest商业账户 以及一个已注册的应用程序。

  1. 在以下位置创建应用程序 developers.pinterest.com
  2. 添加重定向URI: http://localhost:8089/callback
  3. 将客户端ID+客户端密码复制到 .env (参见 .env.template)
  4. 运行身份验证流以生成您的访问令牌:
pinterest-mcp-auth

这将打开一个浏览器,要求您授权,并将您的令牌保存到 .pinterest_token.json.


MCP客户端设置

{
  "mcpServers": {
    "pinterest": {
      "command": "uvx",
      "args": ["pinterest-mcp"],
      "env": {
        "PINTEREST_CLIENT_ID": "your_client_id",
        "PINTEREST_CLIENT_SECRET": "your_client_secret",
        "PINTEREST_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}

速率限制

Pinterest API v5有机发布费率限制:

  • 每分钟10针 每个账户
  • 每天250针 每个账户

bulk_create_pins 自动遵守每分钟限制。


发展

git clone https://github.com/clugtu/pinterest-mcp
cd pinterest-mcp
pip install -e ".[dev]"
pre-commit install
pytest

此仓库使用 预承诺 随着 颈毛 用于裁剪和格式化。安装 pre-commit 如果你没有:

pip install pre-commit

然后运行 pre-commit install 一旦注册了钩子,它们将在每个钩子上自动运行 git commit.


许可证

麻省理工学院——见 许可证


相关