SuperAPI AI 工具集

sirv-ecommerce

营销与增长

查看项目

更新于 10-15 22:17

技能介绍

用途:把电商产品图片从处理到发布串成一条流程——AI Studio 处理图片,Sirv 存储与分发,MCP 工具把结果推送到 Shopify,并执行已保存的流水线、校验平台与供应商标准。前提是已配置 sirv-ai MCP 服务器;去背景、放大、场景图、alt 文本等处理工具在 sirv-ai-studio 技能中说明,本技能负责面向店铺的一层。

默认流程:先用 sirv_shopify_status 检查连接(connected、valid、needsReconnect),未连接或无效则停止并让用户在 Sirv AI Studio 中连接店铺;目录级操作时用 sirv_sync_shopify_products 把 Shopify 商品与图片导入 PIM(仅入站,单次最多 500,默认 100);按 sirv-ai-studio 文档处理图片,或用 sirv_execute_workflow 运行已保存流水线;发布前用平台预设(Amazon、eBay、Shopify、Walmart)做图片审查,并用 sirv_run_supplier_autofix 自动修正;用 sirv_push_image_to_shopify 推送,需谨慎选择 upload_strategy;最后在店铺中核对图片、位置、精选状态与 alt 文本。

Shopify 工具:sirv_shopify_status 校验连接;sirv_sync_shopify_products 导入商品与图片(maxProducts 1-500,默认 100;importImages 默认 true);sirv_push_image_to_shopify 发布图片(productId、image_url、alt_text、upload_strategy、set_as_featured、source_image_id)。推送语义:productId 支持数字或 gid 形式;upload_strategy 的 add 为追加(默认),replace_source 需 source_image_id 先删一张再加,replace_all 会删除商品全部图片、属破坏性操作须用户确认;set_as_featured 为 true 时置于第 1 位;推送只作用于商品级媒体,不会创建或关联变体图片;同步仅入站,推送是唯一出站操作。

流水线:用户在 Sirv AI Studio 可视化搭建(如去背景→校验→自动修复→alt 文本),智能体用 sirv_list_workflows、sirv_get_workflow、sirv_execute_workflow 执行。执行耗时 30 秒至数分钟,每步按图消耗积分(结果含 totalCreditsUsed 与每步 creditsUsed);MCP 运行会跳过交互步骤(review/imageReview)与客户端步骤(saveToCsv);saveToSirv、addMetaTags、setProductMeta 需用户 Sirv 账号已连接。结果按图返回 success/partial/error 与 finalOutputs。重复流程建议用保存的流水线而非手工串联。

供应商门户(Supplier Portal Pro):sirv_get_supplier_sftp_status 查看 SFTP 接入配置;sirv_get_supplier_review_assist_requirements 获取当前图片规范(规则、passThreshold、failAction、文件名策略);sirv_run_supplier_autofix 按失败规则修复(mode、failed_rules、max_iterations 1-5 默认 3、enabled_fixes、upscale_model),每次迭代消耗积分,应先取规范并如实报告 appliedFixes。

平台合规:图片审查校验尺寸、背景、水印、画面填充,按 Amazon、eBay、Shopify、Walmart 预设执行;典型 Amazon 主图流程为去背景(纯白)→校验→修复失败项→alt 文本→推送。精确像素、留白、白底画布等交付格式应放在 Sirv Dynamic Imaging 配置中,而非反复 AI 处理。

限制与注意:replace_all 未确认会清空图库;同步不会上传图片到 Shopify;推送前不检查状态会因令牌过期报错;批量执行前应查积分并提示耗时;推送不支持变体级图片;供应商工具在非 Pro 层级会失败。验证:推送后核对图片、位置与 alt 文本;同步后报告 products.created/updated 与 images.imported/skipped;流水线后检查每图状态并暴露 partial/error;自动修复后重新审查确认通过。