关于 social-commerce
social-commerce 是一项面向电商商家的技能,指导将商品目录连接到 Instagram、TikTok 和 Facebook 等社交平台。内容涵盖平台设置、商品标记、目录诊断与效果衡量。
主要功能
- 01选择社交商务渠道
- 02连接商店并同步商品目录
- 03配置社交内容中的商品标记
- 04诊断目录问题并监控表现
适用场景
- 01为现有商店添加 Instagram Shopping 或 TikTok Shop
- 02首次将商品目录同步到 Meta Commerce Manager
- 03排查商品标签无法识别或价格库存延迟
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ finsilabs/ awesome-ecommerce-skills --skill social-commerce安装后在 Claude Code 中输入/social-commerce确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
tile.jsonevals/meta-xml-catalog-feed-generation/criteria.jsontask.mdevals/real-time-meta-catalog-sync-and-feed-reg/criteria.jsontask.mdevals/tiktok-catalog-feed-and-meta-capi-conver/criteria.jsontask.md详细介绍
社交商务
概述
社交商务可将你的产品目录与 Instagram、TikTok 和 Facebook 集成,让客户无需离开这些平台即可发现和购买产品。Shopify、WooCommerce 和 BigCommerce 都有官方集成,可自动同步你的产品目录,无需编写自定义代码。需要重点做好的是正确设置目录、在帖子中启用产品标记,以及监控目录状态。
何时使用此技能
- 为现有商店添加 Instagram Shopping 或 TikTok Shop 时
- 首次将产品目录同步到 Meta Commerce Manager 时
- Instagram 帖子中的产品标记返回“找不到产品”错误时
- 社交平台产品列表中的价格或库存情况滞后于商店时
- 在没有原生平台集成的情况下构建自定义无头店面时
核心说明
第 1 步:选择社交商务渠道
| 平台 | 设置方式 | 应用内结账 | 适用场景 |
|---|---|---|---|
| Instagram Shopping | Meta Commerce Manager | 是(仅限美国) | 时尚、美妆、生活方式 |
| Facebook Shop | Meta Commerce Manager | 是(仅限美国) | 所有品类 |
| TikTok Shop | TikTok Seller Center | 是 | 爆款/冲动型产品 |
| Pinterest Shopping | Pinterest Ads Manager | 否(链接到你的商店) | 家居、时尚、食品 |
**Shopify 用户:**通过一个集成(Facebook & Instagram 渠道)即可同时启用 Instagram 和 Facebook Shopping。TikTok 需要单独集成。
第 2 步:将平台连接到 Instagram 和 Facebook Shopping
Shopify
- 前往 Shopify Admin → Sales Channels → + → Facebook & Instagram
- 安装该渠道并连接你的 Meta Business Manager 账户
- 在 Commerce → Catalog 下,Shopify 会自动将你的产品目录同步到 Meta Commerce Manager——每件产品、每个变体、价格和库存更新都会自动同步
- 在 Meta Commerce Manager → Catalog → Items 中,检查产品是否已显示并获批
- 在 Instagram → Settings → Business → Shopping 中:将你的 Meta 目录连接到 Instagram 个人资料——这样即可在帖子中标记产品
- 等待 Instagram Shop 审核通过(通常需要 1–5 个工作日)
- 获批后,前往 Instagram → Create Post → Tag Products,即可为任何照片或短视频添加产品标记
对于 TikTok Shop:
- 前往 Shopify Admin → Sales Channels → + → TikTok
- 安装 TikTok for Shopify 渠道
- 连接你的 TikTok Seller Central 账户
- Shopify 会自动将你的产品目录同步到 TikTok Shop
WooCommerce
- 从 WordPress 插件目录安装 Facebook for WooCommerce(免费,Meta 官方插件)
- 前往 WooCommerce → Facebook → Get Started 并连接你的 Meta Business Manager
- 该插件会自动将你的 WooCommerce 产品目录同步到 Meta Commerce Manager
- 在 Instagram 设置中启用购物功能 → 关联该插件创建的 Meta 目录
- 对于 TikTok:安装 TikTok for WooCommerce 插件并连接你的 TikTok Seller Central 账户
BigCommerce
- 前往 BigCommerce Admin → Channel Manager → Add a Channel
- 选择 Facebook & Instagram 并连接你的 Meta Business Manager 账户
- BigCommerce 会自动创建产品 Feed 并将其同步到 Meta Commerce Manager
- 对于 TikTok:前往 Channel Manager → TikTok 并连接你的 TikTok Seller Central 账户
- 在 Channel Manager → Facebook & Instagram → Products 中查看目录同步状态
自定义/无头
生成兼容 Meta 的 XML Feed,并在 Meta Commerce Manager 中注册:
import { XMLBuilder } from 'fast-xml-parser';
export async function generateMetaCatalogFeed(req: Request, res: Response) {
const products = await db.products.findAll({
where: { status: 'active', availableForSale: true },
include: ['variants', 'images'],
});
const items = products.flatMap((p) =>
p.variants.map((v) => ({
id: v.sku, // Use SKU as the catalog item ID — must be stable
title: p.name,
description: p.description.slice(0, 9999),
availability: v.inventory > 0 ? 'in stock' : 'out of stock',
condition: 'new',
price: `${(v.priceInCents / 100).toFixed(2)} USD`,
link: `${process.env.STORE_URL}/products/${p.slug}?variant=${v.id}`,
image_link: p.images[0]?.url,
brand: p.brand ?? process.env.STORE_NAME,
google_product_category: p.googleProductCategory,
item_group_id: p.id, // Required: groups variants together in Meta
color: v.color,
size: v.size,
}))
);
const builder = new XMLBuilder({ arrayNodeName: 'item', ignoreAttributes: false });
const xml = builder.build({ rss: { channel: { item: items } } });
res.setHeader('Content-Type', 'application/xml');
res.setHeader('Cache-Control', 'public, max-age=3600');
res.send(xml);
}
在 Meta Commerce Manager → Catalog → Data Sources → Add Data Feed 中注册 Feed URL,并设置每小时刷新一次。
如需实时更新价格和库存(而不是等待每小时抓取),请使用 Meta 的 Catalog Batch API:
// Push individual product updates immediately when price or inventory changes
async function pushProductUpdateToMeta(variantSku: string, inventory: number, priceInCents: number) {
await fetch(`https://graph.facebook.com/v18.0/${process.env.META_CATALOG_ID}/items_batch`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
access_token: process.env.META_ACCESS_TOKEN,
item_type: 'PRODUCT_ITEM',
requests: [{
method: 'UPDATE',
retailer_id: variantSku,
data: {
availability: inventory > 0 ? 'in stock' : 'out of stock',
price: `${(priceInCents / 100).toFixed(2)} USD`,
},
}],
}),
});
}
步骤 3:在 Instagram 帖子中启用商品标记
Instagram Shop 中的商品目录获批后:
- 像往常一样创建 Instagram 帖子或 Reels
- 在分享页面,点按 Tag Products
- 点按图片中显示的商品
- 搜索商品名称,并从商品目录中选择该商品
- 每张图片帖子最多可标记 5 件商品,视频帖子最多可标记 1 件
**对于 Stories:**点按贴纸图标 → Product → 搜索商品目录
**对于 Reels:**与视频帖子相同 — 添加商品链接贴纸
步骤 4:设置 TikTok Shop 商品标记
TikTok Seller Central 获批且商品目录同步后:
- 在 TikTok 应用中创建 TikTok 视频
- 上传时点按 Products → 从已同步的商品目录中选择商品
- TikTok 会在视频上添加购物袋图标 — 观众点按该图标即可查看商品并在应用内购买
- 对于 Live Shopping:前往 TikTok Live → 点按购物车图标 → 将商品添加到直播场次
步骤 5:监控商品目录状况
商品目录错误会导致商品无法被标记或在商店中显示。每周检查:
Meta Commerce Manager:
- 前往 Commerce Manager → Catalog → Diagnostics
- 按类别查看错误:
- 缺少必填字段(通常是 brand 或 google_product_category)
- 违反政策(图片上有叠加文字,或商品包含受限声明)
- 价格不匹配(Feed 价格与落地页价格不同)
- 对于采用原生集成的 Shopify/WooCommerce:在平台管理后台修正商品数据 — 更改会自动同步
TikTok Seller Center:
- 前往 Products → All Products,并按“Under Review”或“Rejected”筛选
- 修复标记的问题(通常是图片质量或违禁商品类别)
步骤 6:衡量社交电商表现
| 指标 | 查找位置 |
|---|---|
| 来自 Instagram Shopping 的收入 | Meta Commerce Manager → Analytics → Sales |
| 来自 TikTok Shop 的收入 | TikTok Seller Center → Analytics |
| 商品标记点击率 | Meta Business Suite → Content → Posts |
| 商品目录条目拒绝率 | Commerce Manager → Catalog → Diagnostics |
最佳实践
- 使用 SKU 作为商品目录条目 ID — SKU 在不同系统间保持稳定,并与仓库匹配;使用数据库 ID 会在数据迁移时造成不匹配
- 变体商品务必填写
item_group_id— Meta 和 TikTok 会用它将颜色/尺寸选项归为同一商品展示,而不是显示重复商品 - 确保商品图片没有叠加文字 — Meta 的商品目录政策会拒绝带有叠加促销文字、水印或拼贴内容的图片
- 价格变动时启用实时批量更新 — 如果你经常开展促销活动,每小时一次的 Feed 抓取会造成价格不匹配时段;使用 Batch API 立即推送更改
- 关联商店前先完成 TikTok Seller Central 审批 — TikTok 要求单独进行卖家审核;仅同步商品目录并不能解锁 TikTok Shop
常见问题
| 问题 | 解决方案 |
|---|---|
| 商品在 Instagram Shop 中一直处于“under review”状态 | 确保商品图片清晰展示商品且没有叠加文字;查看 Meta 的 Commerce Policies,确认商品不属于违禁类别 |
| Meta 中出现价格不匹配错误 | Feed 中的价格必须与落地页上的价格完全一致;如果正在促销,请同时更新两处价格 |
| TikTok 商品目录条目未显示在 TikTok Shop 中 | TikTok 要求单独审批 Seller Center 账户 — 仅同步商品目录并不足够;请单独申请 TikTok Shop |
| Instagram 帖子中未显示商品标记 | Instagram Shop 必须先获批,商品标记才能生效;检查 Instagram → Settings → Business → Shopping 中的状态 |
| 部署后 Feed URL 返回 403 | 将 Meta 爬虫的 IP 范围添加到 CDN 允许列表,或确保无需身份验证即可公开访问 Feed URL |
Related Skills
- @meta-ads-integration
- @google-shopping-feed
- @tiktok-ads-integration
- @influencer-tracking
- @ugc-campaign-management