摘要
Salsify PXM API 针对一个组织:产品及其属性值、数字资产、属性定义、列表成员、导出、导入运行和渠道运行。API 密钥(持有者)和组织 ID。
引导式设置
2 分钟将 Salsify 连接到 Claude、ChatGPT 或 Copilot
开始 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 针对一个组织:产品及其属性值、数字资产、属性定义、列表成员、导出、导入运行和渠道运行。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 获取单个产品。属性 ID 是你在产品上看到的键;salsify_get_property 解释一个属性。
产品: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 开始分页,每页最多 100;meta.total_entries 给出总数。分页在第 10,000 个结果处停止(422):对于更大的集合,请使用导出。该组织可以在所有用户之间每小时发出 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 获取一个产品:所有属性值(属性 ID 和值对,多值属性的列表)、系统字段… |
salsify_create_product | 从属性 ID 和值对创建一个产品;产品 ID 属性是必需的。不存在的属性 ID 将被创建为… |
salsify_update_product | 更新一个产品的属性值:仅发送的属性会更改;每个发送的值替换存储的值,null 则移除它。… |
salsify_upsert_products | 从属性值对象列表(每个都有产品 ID 属性)中一次性创建或更新最多 100 个产品。返回… |
salsify_delete_product | 永久删除一个产品及其属性值。无法撤销。默认关闭 |
salsify_list_digital_assets | 列出数字资产(图像、视频、文档),可选地通过过滤器缩小范围:salsify:id、salsify:name、salsify:url、salsify:format… |
salsify_get_digital_asset | 获取一个数字资产:salsify:id、salsify:name、salsify:url(下载链接)、salsify:format、salsify:bytes、salsify:status(进行中… |
salsify_create_digital_asset | 从公共 URL 添加数字资产;Salsify 在后台下载(salsify:status 进行中,然后完成)。可选 ID… |
salsify_update_digital_asset | 更新数字资产:自定义元数据、salsify:name 或 salsify:source_url 替换文件(这会创建一个新链接)。仅… |
salsify_get_property | 获取一个属性(属性)定义:salsify:id、salsify:name、salsify:data_type(字符串、富文本、数字、日期、布尔值、枚举… |
salsify_add_list_members | 通过 ID 将产品(或其他实体)添加到现有的 Salsify 列表中。列表 ID 是 Salsify 列表 URL 中的数字 |
salsify_remove_list_members | 从 Salsify 列表中移除产品(或其他实体)。产品本身保持不变 |
salsify_start_export | 启动产品、数字资产、属性(属性)、枚举值(attribute_value)或所有内容的导出文件。返回… |
salsify_get_export | 获取导出运行的状态:状态(运行中、已完成、失败)、进度、预计剩余时间、失败原因,一旦… |
salsify_start_import_run | 运行在 Salsify 中已配置的导入(例如从挂载点的 JSON 或 CSV 导入)。可以更改多个产品… |
salsify_get_import_run | 获取导入运行的状态:状态(运行中、已完成、失败、已取消、已停止)、进度和错误。每 15… |
salsify_get_latest_channel_run | 获取一个渠道的最新运行(产品供稿或发布到零售商或网站):ID、状态(运行中、已完成、失败)、时间戳… |
salsify_get_channel_run | 获取一个渠道的运行:状态、时间戳和完成后产品导出 URL |
salsify_start_channel_run | 启动一个渠道的新运行,重新生成其供稿,并且对于发布渠道,将其发送到零售商或网站。默认关闭… |
示例提示
- "品牌 Northwind 的哪些 Salsify 产品没有产品名称?"
- "显示产品 00012345678905 及其属性值。"
- "启动假日目录列表的导出,并告诉我何时准备好。"
- "我们零售商渠道的最后一次渠道运行何时结束,出现了哪些错误?"
- "将产品 00012345678905 和 00012345678912 添加到春季发布列表中。"
下一步
这份指南对你有帮助吗?