pinterest-mcp

Claude（または任意のMCPクライアント）がPinterestを検索し、画像を直接あなたのマシンにダウンロードできるようにするMCPサーバーです。手動でのブラウジングも手動保存も不要です。

これはPinterest独自の内部Web API（ログイン時にブラウザが行うのと同じリクエスト）と通信し、個人のセッションCookieで認証します。これに対する公式の公開Pinterest APIは存在しないため、このプロジェクトは内部APIをリバースエンジニアリングしています。

機能

• 検索とダウンロード — キーワードを指定すると、N枚のフル解像度画像がローカルに保存されます。

• ボードのダウンロード — ボードのリンク（pin.it ショートリンクも可）を指定すると、そこからN枚の画像を取得します。

• ボード一覧 — 直接リンクなしで、ユーザーのボードとピン数を確認できます。

• ボード情報 — ボードの名前とピン数を調べます。

• 再実行時の重複排除 — 同じクエリやボードを再取得する際、既にダウンロードした画像はスキップされ、再取得や古いファイルの残置は行われません。

• メタデータのサイドカー — 各画像のタイトル、説明、ソースリンクは、隠しフォルダ .meta 内の対応する .json ファイルに保存されるため、画像フォルダ自体はきれいなままです。

Related MCP server: pinterest-mcp

要件

• Python 3.14+

• uv

• ブラウザでログインしたPinterestアカウント

インストール

git clone https://github.com/Nuu-maan/pinterest-mcp.git
cd pinterest-mcp
uv sync

Pinterestクッキーの取得

これはあなたとして、あなた自身のログインセッションを使用して実行されます。別途APIキーを作成したり必要としたりしません。

1. pinterest.com をブラウザで開き、ログインしていることを確認します。

2. DevTools（F12）を開き、Network タブを選択します。

3. ページを再読み込みし、pinterest.com への任意のリクエストをクリックします。

4. リクエストヘッダーで Cookie: を見つけ、その値全体をコピーします。

この値はログインセッションと同等なので、秘密にしてください。

設定

claude mcp add pinterest --scope user \
  -e PINTEREST_COOKIE="<paste your cookie here>" \
  -e PINTEREST_DOMAIN="www.pinterest.com" \
  -- uv --directory /path/to/pinterest-mcp run server.py

PINTEREST_DOMAIN はデフォルトで www.pinterest.com です。ログイン時にPinterestが国別ドメイン（例：in.pinterest.com）にリダイレクトする場合は、そちらを使用してください。

画像はデフォルトで ~/Pictures/pinterest-downloads/<name>/ に保存されます。または、ツールに渡すカスタム out_dir に保存されます。

使い方

設定が完了したら、次のように依頼するだけです：

• "Pinterestでミニマリストなロゴデザインを検索して、10枚ダウンロードして"

• "私のPinterestボードを一覧表示して"

• "このボードから5つのピンを取得して：https://pin.it/xxxxxxx"

ツール

開発

uv run -- python -m tests.test_pins
uv run -- python -m tests.test_downloader

免責事項

これはPinterestの内部の非公式APIを使用しており、公開開発者APIではありません。Pinterestがエンドポイントを変更すると動作しなくなる可能性があり、過度な使用はボット検出の対象になる可能性があります。自己責任で自分のアカウントに対して使用してください。

ライセンス

MIT — LICENSE を参照してください。

コントリビューション

CONTRIBUTING.md を参照してください。