概要
Salsify PXM API for one organization: 製品とそのプロパティ値、デジタル資産、プロパティ定義、リストメンバーシップ、エクスポート、インポート実行、チャネル実行。APIキー(ベアラー)と組織ID。
ガイド付きセットアップ
Salsify を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Salsify を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Salsify のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセス。 サインインし、Connectors → Salsifyをクリックして、認証情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Salsify
Salsify PXM API for one organization: 製品とそのプロパティ値、デジタル資産、プロパティ定義、リストメンバーシップ、エクスポート、インポート実行、チャネル実行。APIキー(ベアラー)と組織ID。
セットアップ
セットアップには約3分かかります。
- Salsifyにサインインし(理想的には必要な権限のみを持つ専用の統合ユーザーとして)、プロフィールのAPIアクセス(https://app.salsify.com/app/profile/edit/api)を開きます。**APIキー**をコピーし(空の場合は生成)、`SALSIFY_API_TOKEN`に貼り付けます。このキーはそのユーザーの権限で動作し、再生成されるまで有効です。
- アドレスバーから組織IDをコピーします:
/orgs/の後の部分で、s-から始まります(例:s-1a2b3c4d-...)。これをSALSIFY_ORG_IDに貼り付けます。
APIアクセスはあなたのSalsifyライセンスに依存します。プロフィールにAPIキーが表示されない場合は、Salsifyの担当者に確認してください。トークンはベアラートークンとして送信されます。
開始する場所:salsify_list_products(フィルターあり、またはすべての製品)およびsalsify_get_productで1つの製品を取得します。プロパティIDは製品で見るキーです;salsify_get_propertyが1つを説明します。
製品:salsify_list_products、salsify_get_product、salsify_create_product、salsify_update_product。値はプロパティIDでキー付けされます(例:Brand、Product Name);マルチバリュープロパティはリストを取ります;nullは値をクリアします。未知のプロパティIDはテキストプロパティとして作成されるので、スペルを確認してください。salsify_upsert_products(バルク)およびsalsify_delete_productはインストール時にオフになっています。
デジタル資産:salsify_list_digital_assets、salsify_get_digital_asset、salsify_create_digital_asset(公開URLから;バックグラウンドで処理されます)、salsify_update_digital_asset。資産のIDを製品の資産プロパティに設定することで、資産を製品にリンクします。
プロパティとリスト:salsify_get_property、salsify_add_list_members、salsify_remove_list_members。すべてのプロパティをリストするためのドキュメント化された呼び出しはありません:entity_type属性でエクスポートします。
エクスポートとインポート:salsify_start_exportの後にsalsify_get_exportを使用して完了するまで;URLはファイルへの一時リンクです。salsify_get_import_runはインポート実行を読み取ります;salsify_start_import_run(多くの製品にわたる設定されたインポートを実行)はオフになっています。
チャネル:salsify_get_latest_channel_runおよびsalsify_get_channel_runはチャネルの状態とフィードリンクを表示します;salsify_start_channel_runは、実行が小売業者に公開できるためオフになっています。チャネルルートはSalsify自身の統合によって使用されますが、公開リファレンスでは部分的にしか説明されていません。
フィルター:Salsifyフィルター言語:='Brand':'Acme'(等しい)、='Product Name':^'Mug'(始まる)、='Price':>'10'、=list:12345(リストメンバー);条件をANDで結合するにはカンマを使用します。プロパティ名と値はシングルクオートで囲みます。
ページングと制限:ページは1から始まり、per_pageは最大100;meta.total_entriesが合計を示します。ページングは10,000件目の結果で停止します(422):より大きなセットにはエクスポートを使用してください。組織はすべてのユーザーに対して1時間あたり10,000リクエストを行うことができます(429以上;ヘッダーx-ratelimit-remainingおよびx-ratelimit-reset)。エラーは422としてエラーリストと共に返されます;401はAPIキーが間違っていることを意味します;400は組織IDが欠落または間違っていることを示します。
前提条件:SALSIFY_ORG_ID、SALSIFY_API_TOKEN
コネクタをローカルにインストールする
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
http://localhost:3000/connectors/storeを開き、Salsifyを選択し、前提条件の下にリストされている環境変数を貼り付けます。
利用可能なツール
| ツール | 何をするか |
|---|---|
salsify_list_products | 製品をリスト表示し、オプションでSalsifyフィルターで絞り込みます:各製品のすべてのプロパティ値をプロパティIDと値のペアとして表示し、システム… |
salsify_get_product | 製品IDで1つの製品を取得します:すべてのプロパティ値(プロパティIDと値のペア、マルチバリュープロパティのリスト)、システムフィールド… |
salsify_create_product | プロパティIDと値のペアから製品を作成します;製品IDプロパティは必須です。まだ存在しないプロパティIDは作成されます… |
salsify_update_product | 1つの製品のプロパティ値を更新します:送信されたプロパティのみが変更され、各送信された値が保存された値を置き換え、nullはそれを削除します… |
salsify_upsert_products | プロパティ値オブジェクトのリストから1回の呼び出しで最大100製品を作成または更新します(各オブジェクトには製品IDプロパティがあります)。… |
salsify_delete_product | 1つの製品をそのプロパティ値と共に永久に削除します。元に戻すことはできません。インストール時にオフになっています。 |
salsify_list_digital_assets | デジタル資産(画像、動画、文書)をリスト表示し、オプションでフィルターで絞り込みます:salsify:id、salsify:name、salsify:url、salsify:format… |
salsify_get_digital_asset | 1つのデジタル資産を取得します:salsify:id、salsify:name、salsify:url(ダウンロードリンク)、salsify:format、salsify:bytes、salsify:status(in_progress… |
salsify_create_digital_asset | 公開URLからデジタル資産を追加します;Salsifyはバックグラウンドでダウンロードします(salsify:status in_progress、その後完了)。オプションのID… |
salsify_update_digital_asset | デジタル資産を更新します:カスタムメタデータ、salsify:name、またはファイルを置き換えるためのsalsify:source_url(新しいリンクを作成します)。… |
salsify_get_property | 1つのプロパティ(属性)定義を取得します:salsify:id、salsify:name、salsify:data_type(string、rich_text、number、date、boolean、enumerated… |
salsify_add_list_members | 既存のSalsifyリストに製品(または他のエンティティ)をIDで追加します。リストIDはSalsifyのリストURLの番号です。 |
salsify_remove_list_members | Salsifyリストから製品(または他のエンティティ)を削除します。製品自体はそのまま残ります。 |
salsify_start_export | 製品、デジタル資産、プロパティ(属性)、列挙値(attribute_value)またはすべて(all)のエクスポートファイルを開始します。… |
salsify_get_export | エクスポート実行の状態を取得します:ステータス(running、completed、failed)、進捗、estimated_time_remaining、failure_reason、完了後… |
salsify_start_import_run | Salsifyで既に設定されたインポートを実行します(例えば、マウントポイントからのJSONまたはCSVインポート)。多くの製品を一度に変更できます… |
salsify_get_import_run | インポート実行の状態を取得します:ステータス(running、completed、failed、canceled、stopped)、進捗とエラー。15分ごとにポーリングしないでください… |
salsify_get_latest_channel_run | チャネルの最新の実行を取得します(小売業者やサイトへの製品フィードまたは公開):ID、ステータス(running、completed、failed)、タイムスタンプ… |
salsify_get_channel_run | チャネルの1つの実行を取得します:ステータス、タイムスタンプ、完了後のproduct_export_url |
salsify_start_channel_run | チャネルの新しい実行を開始します。これによりフィードが再生成され、小売業者やサイトに送信されます。インストール時にオフになっています… |
例のプロンプト
- "ブランドNorthwindのSalsify製品で、製品名がないものはどれですか?"
- "製品00012345678905とそのプロパティ値を表示してください。"
- "リストHoliday Catalogのエクスポートを開始し、準備ができたら教えてください。"
- "私たちの小売業者チャネルの最後のチャネル実行はいつ終了し、どのようなエラーがありましたか?"
- "製品00012345678905と00012345678912をリストSpring Launchに追加してください。"
次のステップ
このガイドは役に立ちましたか?