mcpField
P
Pinterest Ads

Pinterest Ads

ローカル
getmcpads.comビジネス・マーケティング03 日前に更新

Pinterest Ads について

Pinterest Ads 向けの MCP サーバーで、キャンペーンレポート、オーディエンスやカタログのデータ、アカウント操作を提供します。30 個の書き込みツールは初期状態で無効で、変更の適用にはプレビュー後の明示的な確認が必要です。

主な機能

  1. 0129 個の読み取りツール
  2. 02レポート、オーディエンス、カタログ
  3. 03オーガニック Pin の分析とトレンド
  4. 0430 個の任意の書き込みツール
  5. 05書き込み前のプレビューと確認
  6. 06メンバー識別子の初期状態でのマスキング

活用シーン

  1. 01Pinterest キャンペーンの成果を確認
  2. 02オーディエンスやカタログのデータを調査
  3. 03予算やキャンペーン変更を準備
  4. 04オーガニック Pin の傾向を分析

MCP 対応

29 個の読み取りツールと 30 個の任意の書き込みツールで、Pinterest Ads のレポートとアカウント操作を提供します。書き込みは初期状態で無効で、プレビューを確認した場合にのみ適用されます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"com-getmcpads-pinterest-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/pinterest-ads-mcp-server"
],
"env": {
"PINTEREST_ACCESS_TOKEN": "<PINTEREST_ACCESS_TOKEN>",
"PINTEREST_REFRESH_TOKEN": "<PINTEREST_REFRESH_TOKEN>",
"PINTEREST_APP_ID": "<PINTEREST_APP_ID>",
"PINTEREST_APP_SECRET": "<PINTEREST_APP_SECRET>",
"PINTEREST_AD_ACCOUNT_IDS": "<PINTEREST_AD_ACCOUNT_IDS>",
"PINTEREST_AD_ACCOUNT_ID": "<PINTEREST_AD_ACCOUNT_ID>",
"PINTEREST_ENABLE_WRITES": "<PINTEREST_ENABLE_WRITES>",
"PINTEREST_ENVIRONMENT": "<PINTEREST_ENVIRONMENT>",
"LOG_LEVEL": "<LOG_LEVEL>"
}
}
}
}
起動コマンドnpx -y @getmcpads/pinterest-ads-mcp-server
設定が必要な環境変数
PINTEREST_ACCESS_TOKENシークレットPinterest access token with the ads:read scope.
PINTEREST_REFRESH_TOKENシークレットRefresh token, so the server can renew the access token.
PINTEREST_APP_IDApp ID, needed for refresh.
PINTEREST_APP_SECRETシークレットApp secret, needed for refresh.
PINTEREST_AD_ACCOUNT_IDSRecommended. Comma-separated ad account IDs this server may use; other accounts are refused. Required from 3.0.0.
PINTEREST_AD_ACCOUNT_IDDefault ad account ID. It must be one of PINTEREST_AD_ACCOUNT_IDS when both are set.
PINTEREST_ENABLE_WRITESSet to true to expose 30 write tools. Default calls preview; confirm:true applies changes.
PINTEREST_ENVIRONMENTAPI environment: production (default) or sandbox. Use credentials issued for that environment.
LOG_LEVELLog level written to stderr: debug, info (default), warn or error.

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@getmcpads/pinterest-ads-mcp-server2.1.1

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Pinterest Ads MCP server

Pinterest キャンペーンの点と点をつなぎましょう。

MCP クライアントから、レポート、オーディエンス、カタログ、ネイティブなキャンペーン操作を利用できます。

リリース CI Smithery ライセンス:Apache 2.0 Node

動画を見る · 新着情報 · インストール · ツールリファレンス · ホスト版 getmcpads を試す

getmcpads の動画を見る:AI アシスタントとの会話で、すべての広告アカウントを利用

45 秒の動画を再生

この動画では、サンプルデータを使ったホスト版 getmcpads を紹介しています。クリエイティブギャラリーやアラートから Google Sheets へのエクスポート、一括ローンチまで、MCP Apps はホスト版製品の機能です。このリポジトリでは、単独で使えるネイティブ API ツールを提供します。

読み取りツール 29 個 · 書き込みツール 30 個(デフォルトでは無効)。

独自のプラットフォーム認証情報と、Claude Desktop、Claude Code、Cursor などの stdio MCP に対応したクライアントを使って、ローカルで実行できます。リクエストはプラットフォームに直接送信されます。対応する ChatGPT の設定など、管理された接続にはホスト版をご利用ください。

新着情報

v2.1.1:Zod 4 のセキュリティ更新 · 2026 年 10 月 26 日

  • zod を 4.6.7 に更新しました。4.6.6 より前のすべての Zod リリースは、高深刻度のアドバイザリ GHSA-mrhx-c7xc-m3w5 の対象です。サイズ制限のあるコレクションが大きすぎる場合、検証によってメモリが枯渇する可能性があります。また、この修正を含む Zod 3 のリリースはありません。npm audit --omit=dev で、再び脆弱性が報告されなくなりました。
  • Zod 3 の検証動作を維持しています。パラメーターのデフォルト値は引き続き使用前に検証・補完されるため、省略されたオブジェクトにも必須フィールドを指定する必要があります。
  • パラメーターが任意、またはデフォルト値を持つ場合も、各パラメーター固有の説明を維持します。Zod 4 ではラップされたスキーマにのみ説明が保存されるため、そうしないと共有のフォールバック説明に置き換わる可能性があります。
  • MCP 経由で公開されるツール名、パラメーター、説明に変更はありません。server-card.json は Zod 4 の JSON Schema 出力で再生成されており、一部の制約の表記が異なります。

以前のリリース

バージョン日付主な変更点
2.1.02026 年 10 月 23 日ツール名の変更とネイティブ動画アップロード
2.0.12026 年 9 月 23 日公開リポジトリを復元
2.0.02026 年 9 月 20 日ゲートウェイの同期とセキュリティ修正
1.1.02026 年 9 月 13 日プラットフォーム機能の同期と品質契約
1.0.22026 年 8 月 30 日MCP 経由でパッケージのバージョンを通知。
1.0.12026 年 8 月 30 日公式 MCP Registry 用に、com.getmcpads/pinterest-ads の server.json と mcpName を追加。
1.0.02026 年 8 月 29 日初のオープンソースリリース

変更履歴の全文 · すべてのリリース

ソースの同期について:SOURCE_SYNC.md。

アップグレードに関する注意事項

Node.js 22.23.4、24.22.1 または 26.12.1、もしくはそれらの系列のより新しいリリースが必要です。古いランタイムでは、サーバーは起動しますが、stderr に警告を書き込みます。CI では Node 22、24、26 を対象にしています。

このリリースに破壊的変更はなく、既存の設定は引き続き動作します。3.0.0 では 2 つの変更を予定しており、設定に該当する場合、サーバーは起動時にそれぞれの変更を stderr に通知します。

  • PINTEREST_AD_ACCOUNT_IDS が必須になります。サーバーがアクセスできる広告アカウントを列挙した値に制限するには、今のうちに設定してください。それまでは、PINTEREST_AD_ACCOUNT_ID はデフォルトのアカウントとして機能し、アクセス制限にはなりません。
  • PINTEREST_ENABLE_WRITES で書き込みを有効にする値は true のみに変更されます。1、yes、on を true に置き換えてください。

pinterest://attribution リソースでは、デフォルトの名前が defaultAttribution になりました。従来の defaults キーは 3.0.0 までエイリアスとして引き続き使用できます。

保存済みの引数を再利用する前に、現在のツールスキーマを確認してください。書き込みは引き続きオプションで、明示的な確認が必要です。ホスト型クリエイティブ連携と MCP Apps UI は今回のリリースの対象外です。

このリリースをインストールする

これは GitHub のソースリリースです。npm と MCP Registry のバージョンは個別に公開されます。以下のコマンドではこのバージョンを正確に指定します。このドキュメントの後半にある、バージョンを固定していない npx の例では、npm で現在入手できるバージョンが選択されます。

git clone --branch v2.1.1 --depth 1 https://github.com/get-mcp-ads/pinterest-ads-mcp-server.git
cd pinterest-ads-mcp-server
npm ci
npm run build

MCP クライアントが、node を使って dist/cli.js の絶対パスを実行するよう設定し、以下に記載するプラットフォームの認証情報を設定してください。

マネージド接続をお求めですか? ホスト型 getmcpads で Pinterest Ads を利用する。アカウントを接続し、アシスタントがアクセスできるデータを選択して、ホスト型 MCP 接続を利用できます。現在の機能とプランについては、サイトをご覧ください。

利用できる機能

29 個の読み取りツールレポート、キャンペーンと広告グループ、オーディエンス、ターゲティング、キーワード、コンバージョン、カタログ、ビジネスアセット、請求、ピン、トレンド、動画処理ステータス
30 個の書き込みツールデフォルトでは無効です。一時停止中のキャンペーン、広告グループ、広告を作成し、ステータス、予算、設定、名前を変更できます。動画をアップロードし、ボード、ピン、カタログを管理できます。どのツールも適用前にプレビューを表示します
7 個のリソースモデルが読み取れる最新のカタログです。レポート列、アトリビューション期間、クリエイティブアセット、カタログレポート、サーフェスマップ、レシピが含まれます
オーガニックデータと有料データの両方広告アカウントだけでなく、ピンの分析とトレンドも利用できます
設計段階から組み込まれたプライバシー保護リードレコードは一切公開されず、メンバー識別子はデフォルトでマスキングされます
生の列名をそのまま使う理由

Pinterest では独自の方法でレポート列に名前が付けられているため、このサーバーでは別名を考案して置き換えるのではなく、その名前をそのまま受け付けます。API に存在する列はここでも使用できます。存在しない列は、別のものに黙って変換されることなく、すぐにエラーになります。

pinterest://reporting-columns で利用可能な項目を確認でき、pinterest_validate_report でリクエストの実行前に検証できます。


ツールの返却内容に組み込まれたプライバシー保護

2 つの保護機能があり、それぞれ動作が異なります。

リードレコードは一切公開されません。 pinterest_get_lead_assets はリードフォームとサブスクリプションの設定を返しますが、リードのエクスポートデータは返しません。これらのレコードには、エンドユーザーが送信した個人情報が含まれるためです。これはマスキングではなく除外です。データがこのサーバーを介して Pinterest の外部に出ることはありません。

ビジネスメンバーの識別子はデフォルトでマスキングされます。 メンバー、アセットのメンバー、招待を読み取る際、メンバー ID、メールアドレス、ユーザー名はモデルに渡される前に置き換えられます。includePersonalIdentifiers: true を指定すると元の値が返されます。デフォルトは false です。これらは同僚の連絡先情報であるため、デフォルト設定のほうが安全です。


トークンの取得

ads:read スコープを持つ Pinterest アクセストークンが必要です。

  1. Pinterest 開発者ポータルでアプリを作成します。
  2. アプリ IDとアプリシークレットを控えます。
  3. 広告アカウントにアクセスできるアカウントにサインインした状態で、OAuth フローを実行します。 ads:read をリクエストします。書き込みを有効にする予定がある場合に限り、ads:write もリクエストします。
  4. アクセストークンを保管します。サーバーにトークンを更新させたい場合は、リフレッシュトークンも保管します。

📖 Pinterest API の認証

PINTEREST_ACCESS_TOKEN だけでも実行できますが、有効期限があります。 PINTEREST_REFRESH_TOKEN、PINTEREST_APP_ID、PINTEREST_APP_SECRET をすべて指定すると、 サーバーがトークンを自動で更新します。日常的に使用する場合は、この方法をおすすめします。

最初の呼び出しとして pinterest_health_check を実行してください。トークンを表示することなく、 トークンを検証し、アクセスできる広告アカウントを一覧表示します。


セットアップ

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) または %APPDATA%\Claude\claude_desktop_config.json(Windows):

{
  "mcpServers": {
    "pinterest-ads": {
      "command": "npx",
      "args": ["-y", "@getmcpads/pinterest-ads-mcp-server"],
      "env": {
        "PINTEREST_ACCESS_TOKEN": "your-token-here",
        "PINTEREST_AD_ACCOUNT_IDS": "your-ad-account-id"
      }
    }
  }
}

PINTEREST_AD_ACCOUNT_IDS は任意ですが、設定をおすすめします。サーバーが使用できる広告アカウントを指定したリストに制限し、バージョン 3.0.0 では必須になります。

Claude Desktop を再起動します。「Pinterest の広告アカウントを一覧表示して」と尋ねてください。

Claude Code
claude mcp add pinterest-ads --env PINTEREST_ACCESS_TOKEN=your-token --env PINTEREST_AD_ACCOUNT_IDS=your-ad-account-id -- npx -y @getmcpads/pinterest-ads-mcp-server
Cursor

プロジェクト内の .cursor/mcp.json に、上記の Claude Desktop 設定と同じ形式で記述します。

ソースから実行
git clone https://github.com/get-mcp-ads/pinterest-ads-mcp-server.git
cd pinterest-ads-mcp-server
npm install && npm run build
cp .env.example .env   # then fill in your credentials
npm start
設定
変数デフォルト説明
PINTEREST_ACCESS_TOKENなしads:read を持つアクセストークン
PINTEREST_REFRESH_TOKENなし下記の 2 つと併用すると、サーバーがトークンを更新できます
PINTEREST_APP_IDなしアプリ ID。更新に必要です
PINTEREST_APP_SECRETなしアプリシークレット。更新に必要です
PINTEREST_AD_ACCOUNT_IDSなし設定をおすすめします。サーバーが使用できる広告アカウント ID をカンマ区切りで指定します。設定すると、別のアカウントを指定するリクエストは拒否されます。バージョン 3.0.0 では必須になります
PINTEREST_AD_ACCOUNT_IDなし任意のデフォルト値です。呼び出しごとに指定する手間を省けます。PINTEREST_AD_ACCOUNT_IDS を設定した場合、この値はそのアカウントのいずれかである必要があります
PINTEREST_ENABLE_WRITES未設定書き込みツール 30 個を登録するには、true に設定します。1、yes、on も使用できますが、非推奨です。認識できない値を指定すると、サーバーは停止します
PINTEREST_ENVIRONMENTproduction認証情報が発行された環境に応じて、production または sandbox を指定します
LOG_LEVELinfodebug、info、warn、error

アクセストークン、またはリフレッシュ用の 3 つの値を指定してください。どちらも指定されていない場合、サーバーは起動を拒否します。 PINTEREST_AD_ACCOUNT_IDS を設定しない場合、トークンでアクセスできるすべての広告アカウントにアクセスできます。サーバーは起動時に、その旨を stderr に出力します。

npm run doctor

書き込みツールと、事前プレビューを行う理由

書き込みツールはデフォルトで無効です。PINTEREST_ENABLE_WRITES=true を設定し、 ads:read に加えて ads:write の権限を付与してください。

有効にすると、すべての書き込みツールはプレビューを返し、変更は行いません。

// pinterest_update_adgroup_budget { adAccountId: "549…", adGroupId: "268…", dailyBudget: 50 }
{
  "applied": false,
  "action": "pinterest_update_adgroup_budget",
  "change": { "adAccount": "549…", "adGroup": "268…",
              "field": "budget_in_micro_currency", "amount": 50,
              "inMicroCurrency": 50000000 },
  "message": "Preview only, nothing was changed. Repeat the same call with confirm: true to apply this change to the live account."
}

confirm: true を含めて2回目の呼び出しを行った場合にのみ、実際のアカウントに変更が反映されます。

これは意図的な設計です。アシスタントがこれらの呼び出しを組み立てる際、誤った広告アカウントやキャンペーンを選んだり、予算の桁を間違えたりする可能性があります。必須のプレビューにより、費用が発生する前に誤りを確認でき、プロトコルだけでは保証されない、人が処理を止める機会を設けられます。

さらに、次の2つの安全策があります。

  • pinterest_create_campaign は、キャンペーンを必ず PAUSED の状態で作成します。 有効な状態で作成するオプションはありません。
  • 金額はマイクロ単位に変換されます。 Pinterest では金額を100万分の1の単位で保持するため、アカウントの通貨で12.50は 12500000 になります。プレビューには両方の値が表示されるため、100万倍の桁間違いは適用前に確認できます。日予算と通算予算を同時に指定すると、どちらかを暗黙に採用するのではなく、リクエストが拒否されます。
ツール変更内容
pinterest_update_campaign_status / pinterest_update_adgroup_status一時停止、再開、またはアーカイブ
pinterest_update_campaign_budget / pinterest_update_adgroup_budget日予算または通算予算
pinterest_create_campaignキャンペーンを作成します。状態は必ず PAUSED です
pinterest_rename_campaign / pinterest_rename_adgroup / pinterest_rename_ad名前のみ
pinterest_prepare_video_upload / pinterest_upload_video動画を登録し、その後 Pinterest が返すアップロード先に送信します

ツール

すべてのツールを以下に記載しています。パラメーターと出力のスキーマ全体については、server-card.json を参照してください。

29 個の読み取りツール | ツール | 目的 | | --- | --- | | `pinterest_health_check` | Pinterest Ads の読み取り専用ヘルスチェックです。 | | `pinterest_list_ad_accounts` | 設定済みの認証情報でアクセスできる Pinterest 広告アカウントの一覧を取得します。 | | `pinterest_get_delivery_metrics` | Pinterest の resources/delivery_metrics を読み取ります。 | | `pinterest_validate_report` | Pinterest レポートの実行方法を検証し、プレビューを表示します。 | | `pinterest_run_report` | 読み取り専用の Pinterest Ads レポートを実行します。 | | `pinterest_get_creative_assets` | Pinterest のクリエイティブアセットと、利用可能な場合は期間別のパフォーマンスを取得します。 | | `pinterest_run_catalog_report` | PRODUCT_GROUP または PRODUCT_ITEM 別に Pinterest カタログレポートを実行します。 | | `pinterest_get_catalog_inventory` | カタログ、商品グループ、商品グループのプロモーション、任意の商品サンプルなど、Pinterest カタログのインベントリを一覧表示します。 | | `pinterest_run_conversion_product_report` | reports/brand_category_sku を介して、ブランド、カテゴリ、ブランド+カテゴリ、SKU、または SKU グループ別に Pinterest の非同期コンバージョン商品レポートを実行します。 | | `pinterest_list_ad_creatives` | すべてのステータスの広告アカウントの広告クリエイティブを一覧表示します(API は指定がない限り ARCHIVED 広告を暗黙的に除外します)。また、ピンのメディアも解決して取得します。これには、最大 1200px の公開 i.pinimg.com 画像 URL、動画カバー、アプリに読み取り権限がある場合の video_url が含まれます。 | | `pinterest_get_write_schema` | 書き込みを作成する前に、公式の Pinterest v5 ネイティブリクエストスキーマと Sandbox の制限を読み取ります。 | | `pinterest_get_account_entities` | Pinterest 広告アカウントのエンティティと設定を読み取ります。 | | `pinterest_run_targeting_report` | 広告アカウント、キャンペーン、広告グループ、または広告のターゲティング分析をライブで実行し、年齢、性別、地域、興味、キーワード、オーディエンス、プレースメント、デバイス、その他の Pinterest ターゲティングタイプ別に分類します。 | | `pinterest_get_targeting_options` | アプリタイプ、性別、ロケール、年齢、地域/ジオ、興味、キーワード、オーディエンスに関する Pinterest の公式ターゲティングオプションカタログを読み取ります。 | | `pinterest_get_keyword_intelligence` | 割り当て済みのターゲティングキーワード、Pinterest の国別キーワード指標、提案キーワード、または関連キーワードを読み取ります。 | | `pinterest_get_audiences` | オーディエンスのアップロードやメンバー構成の変更を行わずに、オーディエンス、顧客リスト、共有、Business が受信したオーディエンスのインベントリを読み取ります。 | | `pinterest_get_audience_insights` | 広告主の全体またはエンゲージメント済みオーディエンス、Pinterest の全体オーディエンス、またはスコープ/タイプのエンドポイントに関する、集計済み Pinterest Audience Insights を読み取ります。 | | `pinterest_estimate_delivery` | 広告グループのオーディエンスサイズ、入札単価の下限、キャンペーンの配信予測など、Pinterest の非変更型プランニング計算を実行します。 | | `pinterest_get_conversion_setup` | Pinterest のコンバージョン計測設定を確認します。コンバージョンタグ、oCPM の対象となるページ訪問タグ、Event Quality Score、広告主定義イベント、コンバージョン削除リクエストのステータスが対象です。 | | `pinterest_get_catalog_diagnostics` | カタログ、フィード、フィード処理結果、商品アイテムの問題、商品グループ、商品数/商品、利用可能なフィルター値、カタログ商品アイテムの検索など、詳細なカタログインベントリと診断情報を読み取ります。 | | `pinterest_run_specialized_export` | Marketing Mix Modeling(MMM)、広告主エンティティの一括ダウンロード、カタログ診断など、Pinterest の非変更型データジョブを開始または確認します。 | | `pinterest_get_lead_assets` | リードフォームの定義とリード登録設定を読み取ります。 | | `pinterest_get_business_assets` | Pinterest Business Access のインベントリを読み取ります。雇用主/リンク済みビジネス、アセット、メンバー、パートナー、割り当て済みアセット、受信済みオーディエンス、招待が対象です。 | | `pinterest_get_billing_and_orders` | 請求先プロファイル/請求書、請求書のダウンロード URL、注文項目、広告クレジットの割引、SSIO アカウント/注文のステータスを読み取ります。 | | `pinterest_get_pin_analytics` | 有料ピン分析、オーガニックの複数/単一ピン分析、ユーザーアカウント分析、上位のピン、または上位の動画ピンを読み取ります。 | | `pinterest_get_organic_inventory` | 広告と併用するオーガニックな Pinterest コンテンツを読み取ります。ピン、ボード、ボード上のピン、ピンの商品タグ、検索結果が対象です。 | | `pinterest_get_trends` | Pinterest Trends を読み取ります。対応地域別の上昇中/月別/年別/季節別キーワード、上昇中の商品カテゴリ、商品カテゴリの詳細、注目トピック、編集記事が対象です。 | | `pinterest_get_platform_resources` | 対応する広告アカウントの国、配信指標の定義、指標の準備状況、リードフォームの質問、メディアアップロードのメタデータ、コマース連携のメタデータ、認証済みユーザーアカウントなど、Pinterest プラットフォームのメタデータと準備状況に関するリソースを読み取ります。 | | `pinterest_get_video_upload` | この広告主に紐づけてアップロードされた動画の処理状況を読み取ります。動画ピンを作成できるのは ready:true の場合のみです。 |
30 個の書き込みツール

デフォルトでは無効です。明示的に確認しない限り、呼び出しはプレビューになります。使用前に、設定と正確なスキーマを確認してください。

ツール目的
pinterest_create_campaign一時停止状態のキャンペーンを作成します。
pinterest_update_campaign_status既存のキャンペーンのステータスを更新します。
pinterest_update_adgroup_status既存の広告グループのステータスを更新します。
pinterest_update_ad_status既存の広告のステータスを更新します。
pinterest_update_campaign_budgetアカウントの主要通貨単位で、日予算または通算予算のいずれか一方を正確に設定します。
pinterest_update_adgroup_budgetアカウントの主要通貨単位で、日予算または通算予算のいずれか一方を正確に設定します。
pinterest_update_campaign_configurationネイティブのキャンペーン設定を更新します。
pinterest_update_adgroup_configurationネイティブの広告グループ設定を更新します。
pinterest_update_adネイティブの広告設定を更新します。
pinterest_rename_campaignキャンペーンの名前を変更します。変更されるのは名前のみです。
pinterest_rename_adgroup広告グループの名前を変更します。変更されるのは名前のみです。
pinterest_rename_ad広告の名前を変更します。変更されるのは名前のみです。
pinterest_create_adgroupネイティブの入札、ターゲティング、予算、スケジュールを明示して、一時停止状態の広告グループを作成します。
pinterest_create_adアクセス可能な Pin から、一時停止状態の広告を作成します。
pinterest_create_product_group_promotionカタログの商品グループから、一時停止状態のショッピングまたはコレクションのプロモーションを作成します。
pinterest_update_product_group_promotionカタログの商品グループのプロモーションを更新します。
pinterest_create_collection_ad画像または動画のヒーロー Pin と、アクセス可能なカタログの商品グループを明示的に選択して、一時停止状態のコレクションを作成します。
pinterest_create_board選択した広告主コンテキストで /boards を作成します。
pinterest_update_board選択した広告主コンテキストで /boards を更新します。
pinterest_create_pin選択した広告主コンテキストで /pins を作成します。
pinterest_update_pinPin を更新します。
pinterest_register_mediaメディアのアップロードを登録します。返された upload_url/parameters は、動画がアップロード済みまたは準備完了であることを示す確認ではありません。
pinterest_prepare_video_uploadローカルファイルまたは HTTPS URL のネイティブ Pinterest 動画アップロードを登録し、不透明なレシートをメモリに保持します。
pinterest_upload_videoPinterest のアクセストークンを使わず、uploadReceipt に保存されたネイティブの送信先へ、登録済みの動画をストリーミングします。
pinterest_create_catalog選択した広告主コンテキストで /catalogs を作成します。
pinterest_create_catalog_feed選択した広告主コンテキストで /catalogs/feeds を作成します。
pinterest_update_catalog_feed選択した広告主コンテキストで /catalogs/feeds を更新します。
pinterest_create_product_group選択した広告主コンテキストで /catalogs/product_groups を作成します。
pinterest_update_product_group選択した広告主コンテキストで /catalogs/product_groups を更新します。
pinterest_batch_catalog_itemsネイティブの CREATE/UPDATE/UPSERT/DELETE カタログ項目操作を送信します。
7 個のリソース
URI内容
pinterest://manifestこのサーバーが公開する内容と現在のモード
pinterest://reporting-columnsAPI が受け付けるすべてのレポート列
pinterest://attributionアトリビューション期間とそのデフォルト値
pinterest://creative-assetsクリエイティブアセットの構成
pinterest://catalog-reportingカタログ固有のレポート列
pinterest://surface-map各ツールが API のどの部分をカバーするか
pinterest://recipes手順ごとのワークフロー

セキュリティ

  • トークンがログに記録されたり、ディスクに書き込まれたりすることはありません。ログレベルを問いません。
  • 認証情報の送信先は Pinterest API のみです。サンドボックスモードでは api.pinterest.com または api-sandbox.pinterest.com に送信されます。ソースに別のホストが現れた場合、テストによってビルドが失敗します。
  • PINTEREST_AD_ACCOUNT_IDS により、アクセス可能な広告アカウントが制限されます。設定されている場合、別のアカウントを指定したリクエストは送信前に拒否され、アカウントの一覧取得でも指定されたアカウントのみが返されます。
  • リダイレクト先へのリクエストは行いません。すべての外部送信呼び出しで redirect: "error" を設定しているため、リダイレクトによってトークンが別のホストに送信されることはありません。いずれかの fetch でこの設定が省略された場合、テストによってビルドが失敗します。
  • 非同期レポートの URL は、取得前に検証されます。Pinterest は任意のホストのダウンロード URL を返しますが、この値は API からのデータであり、信頼できるものではありません。HTTPS のみを許可し、プライベートアドレスやループバックアドレス、リダイレクト、認証情報の付与を禁止します。
  • 動画のアップロード先は、Pinterest が返す宛先です。使用前に検証する Amazon S3 ホストに、署名済みのフォームフィールドを使ってアップロードし、アクセストークンは決して送信しません。指定された動画 URL にも、レポート URL と同じ検証を行います。すべてのリクエストにタイムアウトとレスポンスサイズの上限を設けています。
  • テレメトリーはありません。Pinterest API 以外では、Pinterest が返すレポート URL とアップロード URL、およびアップロードツールに指定された動画 URL にのみ接続します。

個人データの取り扱い方法を含むポリシー全文については、SECURITY.md をご覧ください。


マネージド型のマルチプラットフォーム版をお探しですか?

ローカルサーバーを運用せずにこのソースを使いたい場合は、ホスト型 Pinterest Ads をお試しください。 getmcpads では、広告、Search Console、GA4 にも 1 つの MCP URL から接続できます。 ソースの利用可否とプランの制限はサイトに記載されています。アカウントの接続は引き続き必要です。

  1. Pinterest Ads の接続ガイドに従います。
  2. アシスタントによる読み取りを許可するアカウントまたはプロパティを選択します。
  3. Claude、 ChatGPT または Codex を接続します。
  4. 読み取り専用のレビューを試します:「選択した広告アカウントを使ってキャンペーンのパフォーマンスを確認してください。不足しているデータを明記し、何も変更しないでください。」

有料プランを選ぶ前に、現在のホスト型ツールカタログと 料金をご確認ください。 この Apache 2.0 アダプターは、ご自身の認証情報を使って独立して利用できます。


コントリビューション

イシューやプルリクエストを歓迎します。CONTRIBUTING.mdをご覧ください。 セキュリティ関連の報告を行う前に、SECURITY.mdをお読みください。

ライセンス

Apache License 2.0。NOTICEもご覧ください。

Pinterest は Pinterest, Inc. の商標です。 このプロジェクトは Pinterest, Inc. とは提携しておらず、同社による承認や支援も受けていません。 公開 API を利用する独立したクライアントです。

MCP のコントラクトとデスクトップバンドル

各ツールには、読み取り/書き込みのアノテーション、パラメーターの説明、構造化出力スキーマが定義されています。呼び出しが成功すると、ペイロードは structuredContent.result として公開されます。エラーの場合は isError: true が保持されます。生成されるサーバーカードには定義のみが含まれます。

npm run bundle -- /path/to/output を実行すると、現在のカタログから .mcpb デスクトップバンドルをビルドできます。認証情報はインストール中にローカルで入力します。書き込みツールは、明示的に有効化しない限り無効のままです。

More from getmcpads

Meta Ads · Google Ads · Google Analytics 4 · Google Search Console · TikTok Ads · X Ads

Maintained by Emmanuel at getmcpads. Questions: [email protected].

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。