Pinterest MCP

英語 · 简体中文

Pinterest MCP は、Claude Code、Codex、Cursor、その他あらゆる MCP クライアントから Pinterest に直接アクセスできるオープンソースの MCP サーバーです。ピンを検索し、画像を実際に見て、「似たものをもっと見る」をたどり、ボードを読み込み、オリジナルをダウンロードできます。タスクのたびに参考資料を集めるデザイナーやフロントエンド開発者向けに作られています。

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.

エージェントが検索し、サムネイルを見て、選んだ理由を説明し、フル解像度のファイルをディスクに保存します。そのまま画像を使って画面の構築に取りかかることもできます。

機能

• ⚡ 高速 — pinterest.com が使用するものと同じ JSON エンドポイントに接続します。ピン 20 件の取得に約 2～3 秒かかり、Chrome の起動も不要です。
• 👀 モデルが画像を見られる — オプションでサムネイルを画像として返すため、エージェントはタイトルだけでなく、スタイル、レイアウト、色も判断できます。
• 🧾 豊富なメタデータ — タイトル、説明、フルサイズ URL、寸法（サムネイルのみのピンには low_res のフラグが付きます）、代表色、ソースサイト、ボード、作成者、日付を取得します。広告は除外されます。
• 🔁 さらに深く探索 — 関連ピン、ボード全体、ブックマークによるページネーションに対応します。
• 🛡️ 堅牢 — 匿名セッションを維持し、Pinterest でまれに発生する「フィードの偽の終端」に対して再試行します。
• 🪶 トークンに配慮 — ハッシュタグの羅列を折りたたみ、使用できないフィールドを除外します。
• 🎬 動画にも対応 — 動画ピンには 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 は、最初の N 件の結果にサムネイルを添付する previews: N と、動画ピンのみを返す media: "video"（各ピンに MP4 の video_url が含まれます）を受け付けます。動きやインタラクションの参考を探すときに便利です。

プロンプトの例

• 「Pinterest でグラスモーフィズムのログイン画面を検索して、サムネイルを 8 枚表示して」
• 「これらに共通する点は何ですか？ レイアウト、配色、タイポグラフィについて教えて」
• 「https://www.pinterest.com/pin/1128714725389331478/ に似たピンを探して」
• 「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

FAQ

検索結果の詳細を取得できないのはなぜですか？ ログアウト状態の検索結果には、Pinterest が解決できない匿名 ID が付与されています。検索結果に含まれる情報がすべてです。get_pin と related_pins には、実際のピンのリンク（pinterest.com/pin/<number>/）が必要です。

ネットワークエラーが発生しますか？ お使いの環境で pinterest.com がブロックされている場合は、MCP_PINTEREST_PROXY を設定してください。

動作しなくなることはありますか？ 公式 API ではなく Pinterest のウェブエンドポイントを利用しているため、Pinterest のデザイン変更に伴い、更新が必要になる場合があります。リポジトリを確認するか、変更履歴をご覧ください。

開発

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

リリース履歴については、CHANGELOG.mdをご覧ください。Issue や PR は歓迎します。

免責事項

Pinterest との提携、承認、後援は受けていません。個人的なインスピレーションを得る目的で、適切な頻度で利用し、Pinterest の利用規約に従い、クリエイターの著作権を尊重してください。ダウンロードした画像は参考用に限ります。

謝辞

Pinterest を MCP 経由で初めて調査した terryso/mcp-pinterest に感謝します。

スター履歴

ライセンス

MIT © sunkimk