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 の種類には、Pinterest の各国ドメインにおける Pin、pin.it、プロフィール、ボード、Ideas の URL が含まれます。

実行

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 Pin URL が提供するメディアを調べるブラウザーツール、Pinterest image downloader の開発チームが保守しています。

Pinterest は Pinterest, Inc. の商標です。このプロジェクトは独立したものであり、Pinterest との提携や承認を受けていません。

開発

npm install
npm test
npm run worker:check

ライセンス

MIT

接続の診断

メディアの利用可否を調査する前に、接続診断ガイドを使用して、トランスポート、ツールの検出、正規化、偽装ホストの拒否を確認してください。