SavePinner Pinterest URL Tools

SavePinner MCP

一个用于解析、验证、分类和规范化 Pinterest URL 的 MCP 服务。支持本地 stdio 和公共 Streamable HTTP。工具不会发出任何出站网络请求，也不会下载媒体。

工具

工具	用途
parse_pinterest_url	返回 URL 类型、规范 URL、主机和特定类型的标识符。
normalize_pinterest_url	将受支持的 URL 转换为规范格式并移除跟踪参数。
is_pinterest_url	检查一个值是否为受支持的 Pinterest URL。

受支持的 URL 类型包括 Pin、pin.it、个人资料、看板和 Ideas URL，涵盖 Pinterest 各国家/地区域名。

运行

需要 Node.js 18 或更高版本。

npx -y savepinner-mcp

客户端配置

将此服务添加到支持本地 stdio 服务的 MCP 客户端：

{
  "mcpServers": {
    "savepinner": {
      "command": "npx",
      "args": ["-y", "savepinner-mcp"]
    }
  }
}

远程 MCP

将任意 Streamable HTTP 客户端连接到公共端点：

https://savepinner-pinterest-url-mcp.chenxuanshimo.workers.dev/mcp

该端点为只读，无需身份验证。

公共的 Pinterest URL 验证指南介绍了工具所采用的验证和规范化边界。

Docker

将服务构建并作为本地 stdio 容器运行：

docker build -t savepinner-mcp .
docker run --rm -i savepinner-mcp

运行时镜像以非特权 node 用户身份运行，无需机密信息、卷或网络访问权限。

示例

使用以下内容调用 parse_pinterest_url：

https://de.pinterest.com/pin/987654321/?utm_source=share

返回：

{
  "kind": "pin",
  "originalUrl": "https://de.pinterest.com/pin/987654321/?utm_source=share",
  "normalizedUrl": "https://www.pinterest.com/pin/987654321/",
  "host": "de.pinterest.com",
  "pinId": "987654321"
}

隐私与安全

• URL 处理在正在运行的服务本地进行。
• 工具不会发出任何出站网络请求。
• 服务不会下载媒体。
• 主机名会根据精确的 Pinterest 域名允许列表进行检查。
• 仿冒域名和非 HTTPS URL 会被拒绝。

URL 解析器由 pinterest-url-normalizer 提供。

本项目由 Pinterest 图片下载器背后的团队维护；这是一款用于检查公共 Pinterest Pin URL 所公开媒体的浏览器工具。

Pinterest 是 Pinterest, Inc. 的商标。本项目独立运营，与 Pinterest 无关联，也未获其认可。

开发

npm install
npm test
npm run worker:check

许可证

MIT

连接诊断

使用连接诊断指南检查传输、工具发现、规范化和欺骗性主机拒绝情况，然后再调查媒体是否可用。