mcpField
S
social-commerce

social-commerce

github.com/finsilabs营销与增长60108 次安装5 天前更新
代码仓库

关于 social-commerce

social-commerce 是一项面向电商商家的技能,指导将商品目录连接到 Instagram、TikTok 和 Facebook 等社交平台。内容涵盖平台设置、商品标记、目录诊断与效果衡量。

主要功能

  1. 01选择社交商务渠道
  2. 02连接商店并同步商品目录
  3. 03配置社交内容中的商品标记
  4. 04诊断目录问题并监控表现

适用场景

  1. 01为现有商店添加 Instagram Shopping 或 TikTok Shop
  2. 02首次将商品目录同步到 Meta Commerce Manager
  3. 03排查商品标签无法识别或价格库存延迟

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/finsilabs/awesome-ecommerce-skills --skill social-commerce

安装后在 Claude Code 中输入/social-commerce确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

tile.json
evals/meta-xml-catalog-feed-generation/
criteria.json
task.md
evals/real-time-meta-catalog-sync-and-feed-reg/
criteria.json
task.md
evals/tiktok-catalog-feed-and-meta-capi-conver/
criteria.json
task.md

详细介绍

社交商务

概述

社交商务可将你的产品目录与 Instagram、TikTok 和 Facebook 集成,让客户无需离开这些平台即可发现和购买产品。Shopify、WooCommerce 和 BigCommerce 都有官方集成,可自动同步你的产品目录,无需编写自定义代码。需要重点做好的是正确设置目录、在帖子中启用产品标记,以及监控目录状态。

何时使用此技能

  • 为现有商店添加 Instagram Shopping 或 TikTok Shop 时
  • 首次将产品目录同步到 Meta Commerce Manager 时
  • Instagram 帖子中的产品标记返回“找不到产品”错误时
  • 社交平台产品列表中的价格或库存情况滞后于商店时
  • 在没有原生平台集成的情况下构建自定义无头店面时

核心说明

第 1 步:选择社交商务渠道
平台设置方式应用内结账适用场景
Instagram ShoppingMeta Commerce Manager是(仅限美国)时尚、美妆、生活方式
Facebook ShopMeta Commerce Manager是(仅限美国)所有品类
TikTok ShopTikTok Seller Center是爆款/冲动型产品
Pinterest ShoppingPinterest Ads Manager否(链接到你的商店)家居、时尚、食品

**Shopify 用户:**通过一个集成(Facebook & Instagram 渠道)即可同时启用 Instagram 和 Facebook Shopping。TikTok 需要单独集成。

第 2 步:将平台连接到 Instagram 和 Facebook Shopping

Shopify
  1. 前往 Shopify Admin → Sales Channels → + → Facebook & Instagram
  2. 安装该渠道并连接你的 Meta Business Manager 账户
  3. 在 Commerce → Catalog 下,Shopify 会自动将你的产品目录同步到 Meta Commerce Manager——每件产品、每个变体、价格和库存更新都会自动同步
  4. 在 Meta Commerce Manager → Catalog → Items 中,检查产品是否已显示并获批
  5. 在 Instagram → Settings → Business → Shopping 中:将你的 Meta 目录连接到 Instagram 个人资料——这样即可在帖子中标记产品
  6. 等待 Instagram Shop 审核通过(通常需要 1–5 个工作日)
  7. 获批后,前往 Instagram → Create Post → Tag Products,即可为任何照片或短视频添加产品标记

对于 TikTok Shop:

  1. 前往 Shopify Admin → Sales Channels → + → TikTok
  2. 安装 TikTok for Shopify 渠道
  3. 连接你的 TikTok Seller Central 账户
  4. Shopify 会自动将你的产品目录同步到 TikTok Shop

WooCommerce
  1. 从 WordPress 插件目录安装 Facebook for WooCommerce(免费,Meta 官方插件)
  2. 前往 WooCommerce → Facebook → Get Started 并连接你的 Meta Business Manager
  3. 该插件会自动将你的 WooCommerce 产品目录同步到 Meta Commerce Manager
  4. 在 Instagram 设置中启用购物功能 → 关联该插件创建的 Meta 目录
  5. 对于 TikTok:安装 TikTok for WooCommerce 插件并连接你的 TikTok Seller Central 账户

BigCommerce
  1. 前往 BigCommerce Admin → Channel Manager → Add a Channel
  2. 选择 Facebook & Instagram 并连接你的 Meta Business Manager 账户
  3. BigCommerce 会自动创建产品 Feed 并将其同步到 Meta Commerce Manager
  4. 对于 TikTok:前往 Channel Manager → TikTok 并连接你的 TikTok Seller Central 账户
  5. 在 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 中的商品目录获批后:

  1. 像往常一样创建 Instagram 帖子或 Reels
  2. 在分享页面,点按 Tag Products
  3. 点按图片中显示的商品
  4. 搜索商品名称,并从商品目录中选择该商品
  5. 每张图片帖子最多可标记 5 件商品,视频帖子最多可标记 1 件

**对于 Stories:**点按贴纸图标 → Product → 搜索商品目录

**对于 Reels:**与视频帖子相同 — 添加商品链接贴纸

步骤 4:设置 TikTok Shop 商品标记

TikTok Seller Central 获批且商品目录同步后:

  1. 在 TikTok 应用中创建 TikTok 视频
  2. 上传时点按 Products → 从已同步的商品目录中选择商品
  3. TikTok 会在视频上添加购物袋图标 — 观众点按该图标即可查看商品并在应用内购买
  4. 对于 Live Shopping:前往 TikTok Live → 点按购物车图标 → 将商品添加到直播场次
步骤 5:监控商品目录状况

商品目录错误会导致商品无法被标记或在商店中显示。每周检查:

Meta Commerce Manager:

  1. 前往 Commerce Manager → Catalog → Diagnostics
  2. 按类别查看错误:
    • 缺少必填字段(通常是 brand 或 google_product_category)
    • 违反政策(图片上有叠加文字,或商品包含受限声明)
    • 价格不匹配(Feed 价格与落地页价格不同)
  3. 对于采用原生集成的 Shopify/WooCommerce:在平台管理后台修正商品数据 — 更改会自动同步

TikTok Seller Center:

  1. 前往 Products → All Products,并按“Under Review”或“Rejected”筛选
  2. 修复标记的问题(通常是图片质量或违禁商品类别)
步骤 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

评论

支持 Markdown