Cross Platform Content Syncer

概述

跨平台内容同步器 消除了在内容生态系统中手动重复发布的需求。在您的主平台（WordPress、Substack、Medium 或 LinkedIn）中撰写一次，即可自动同步至所有其他平台，实现智能格式化、SEO 优化和平台特定元数据的处理。

本技能适用于：

• 内容创作者：在多个平台上管理不同受众
• 营销团队：规模化分发思想领导力内容
• 通讯稿出版商：扩大影响力，无需重复劳动
• B2B 公司：在各渠道保持一致的信息传递

为什么重要

内容分发通常需要每个平台执行 4–5 个手动步骤（复制、重新排版、添加元数据、预览、发布）。此技能自动化该工作流程，每篇文章节省 30–45 分钟，同时确保内容一致性与 SEO 最佳实践。

支持的集成：

• WordPress（REST API v2）
• Substack（邮件 + 网页）
• Medium（合作伙伴计划 API）
• LinkedIn（内容分发 API）
• Slack（通知）
• Google Drive（备份）

快速上手

立即尝试以下提示：

示例 1：将 WordPress 文章同步到所有平台

将我最新的 WordPress 文章《10 个内容创作者必备的 AI 工具》同步至 Substack、Medium 和 LinkedIn。为 LinkedIn 添加话题标签，针对 Medium 用户优化内容，并在完成时通过 Slack 通知我。

示例 2：跨平台定时发布内容

我的博客文章已准备就绪。首先立即发布到 Substack，24 小时后发布到 Medium，再过 48 小时发布到 LinkedIn。为各平台添加特定的行动号召（CTA），并追踪互动数据。

示例 3：批量同步多篇文章

将我最近发布的最后 5 篇 WordPress 文章同步到 Medium。跳过 2024 年 1 月之前发布的文章。保留所有图片，添加作者简介，并创建一份 Google 表格记录每篇文章同步到了哪些平台。

示例 4：内容转换式同步

将我的 Substack 通讯稿草稿转换为 LinkedIn 文章（添加专业排版）、Medium 博文（添加 SEO 关键词）以及 WordPress 博客文章（添加相关文章链接）。包含各平台特有的元数据。

功能特性

1. 多平台发布

• WordPress：通过 REST API 直接发布，支持特色图片、分类、标签和 SEO 元数据
• Substack：邮件分发 + 网页存档，支持订阅者列表细分
• Medium：合作伙伴计划发布，支持规范 URL 和出版物选择
• LinkedIn：文章发布，支持格式化、话题标签和互动数据追踪

2. 智能内容转换

• 自动转换格式（Markdown → HTML → 平台专用格式）
• 跨平台保留并优化图片
• 生成平台专属标题和摘要
• 添加符合平台风格的行动号召（如“订阅”“关注”“阅读更多”）
• 保持内部链接结构，并设置重定向

3. SEO 与元数据管理

• 自动生成各平台的元描述
• 添加相关话题标签（如 #内容、#营销、#AI）
• 创建规范 URL，避免重复内容处罚
• 根据各平台算法优化关键词密度
• 生成 Open Graph 标签以提升社交分享效果

4. 调度与工作流

• 可立即发布或指定日期/时间发布
• 支持跨平台错峰发布（例如 24–48 小时延迟）
• 在 Slack 中可见的内容日历
• 队列管理，支持优先级设置
• 失败同步自动重试（采用指数退避策略）

5. 分析与追踪

• 追踪各平台的浏览量、互动率和点击数
• 生成每周表现报告
• 识别内容表现最佳的平台
• 监控跨平台的评论与回复
• 将数据导出至 Google Sheets 或 Data Studio

6. 内容备份与版本控制

• 自动将所有同步内容备份至 Google Drive
• 保留版本历史（支持回滚）
• 归档原始版本与同步版本
• 对比各平台间的格式差异

配置说明

必需环境变量

请在 .env 文件或 ClawHub 秘密管理中设置以下参数：

# WordPress
WORDPRESS_SITE_URL="https://yourblog.com"
WORDPRESS_API_KEY="your-application-password"

# Substack
SUBSTACK_API_KEY="sk_live_xxxxxxxxxxxx"

# Medium
MEDIUM_API_TOKEN="your-medium-integration-token"

# LinkedIn
LINKEDIN_ACCESS_TOKEN="your-oauth-access-token"
LINKEDIN_ORGANIZATION_ID="12345678"

# Slack（可选，用于通知）
SLACK_WEBHOOK_URL="https://hooks.slack.com/services/YOUR/WEBHOOK/URL"

# Google Drive（可选，用于备份）
GOOGLE_DRIVE_FOLDER_ID="your-folder-id"
GOOGLE_SERVICE_ACCOUNT_JSON="path/to/service-account.json"

配置选项

sync_config:
  source_platform: "wordpress"  # wordpress, substack, medium, linkedin
  target_platforms: ["substack", "medium", "linkedin"]

  # 调度设置
  publish_immediately: false
  schedule_delays:
    substack: 0  # 小时
    medium: 24
    linkedin: 48

  # 内容转换
  preserve_formatting: true
  add_platform_ctc: true
  generate_seo_metadata: true

  # 通知设置
  notify_slack: true
  notify_email: "your@email.com"

  # 分析设置
  track_engagement: true
  report_frequency: "weekly"

示例输出

输出 1：同步完成确认

✅ 跨平台同步已完成

文章标题：《10 个内容创作者必备的 AI 工具》
来源：WordPress（ID: 1247）
已同步：3/3 个平台

平台             状态      URL                              发布时间
─────────────────────────────────────────────────────────────────────
Substack         ✓         substack.com/@yourname/ai-tools  2024-01-15
Medium           ✓         medium.com/@yourname/ai-tools   2024-01-16
LinkedIn         ✓         linkedin.com/feed/update/...    2024-01-17

下一步操作：
→ 查看分析仪表板：https://clawhub.app/sync/1247
→ 分享 LinkedIn 文章：https://linkedin.com/feed/update/...
→ 检查 Slack 获取互动更新

输出 2：每周内容互动报告

📊 每周内容表现（2024年1月8日-14日）

表现最佳内容：《AI 工具》文章
├─ WordPress：3,240 次浏览 | 127 条评论
├─ Medium：1,850 次浏览 | 43 次鼓掌
├─ LinkedIn：4,120 次曝光 | 89 次互动
└─ Substack：2,310 次打开 | 340 次点击

平台洞察：
• LinkedIn：最适合 B2B 思想领导力内容（相比上周互动率提升 15%）
• Medium：技术类受众持续增长（粉丝数增加 8%）
• Substack：点击率最高（14.7%）

优化建议：
→ 提高 LinkedIn 发布频率（每周两次）
→ 为 Medium 受众增加更多技术深度内容
→ 根据订阅者兴趣对 Substack 内容进行分组推送

输出 3：内容转换示例

原始 WordPress 文章：
─────────────────────────
标题：《内容创作者必备的 10 个 AI 工具》
字数：2,100 字
图片：5 张
格式：带章节和代码块的博客文章

转换为 Medium 版本：
─────────────────────────
标题：《改变我创作方式的 10 个 AI 工具》（优化以提升互动性）
字数：2,050 字（根据 Medium 推荐长度精简）
图片：5 张（自动适配移动端）
格式：带引用语和高亮段落的文章
原始链接：https://yourblog.com/ai-tools

转换为 LinkedIn 版本：
─────────────────────────
标题：《2024 年每个内容创作者都该知道的 10 个 AI 工具》（关键词优化）
字数：850 字（摘要版，适合 LinkedIn 阅读习惯）
图片：3 张（表现最佳的视觉素材）
格式：专业排版的文章
标签：#AI #ContentCreation #ProductivityTools #MarketingTech
行动号召：「你最喜欢的 AI 工具是什么？欢迎在评论区分享。」

转换为 Substack 版本：
─────────────────────────
标题：《本月我在用的 10 个 AI 工具（含免费替代方案）》（激发好奇心）
字数：2,100 字（完整版本，适合邮件阅读）
图片：5 张（全分辨率，适配邮件客户端）
格式：带有个人叙事的通讯稿
行动号召：「分享给需要这份清单的创作者朋友。」

使用技巧与最佳实践

1. 选择合适的源平台

• WordPress：适合长篇、注重 SEO 的内容
• Substack：适合以通讯稿为核心的受众
• Medium：适合技术性或垂直领域的深度内容
• LinkedIn：适合行业洞察与思想领导力内容

实用提示：将 WordPress 作为主要发布源——它具备最强的灵活性和 SEO 能力。

2. 针对各平台算法进行优化

• LinkedIn：使用 3-5 个行业相关标签，提出互动问题，建议周二至周四上午 8 点至 10 点发布
• Medium：添加 5-7 个主题标签，首段具有吸引力，目标字数控制在 1,500 至 2,000 字之间
• Substack：个性化邮件主题行，包含一个明确的行动号召，固定时间发送
• WordPress：在标题和前 100 字中嵌入目标关键词，添加内部链接，优化图片

3. 错峰发布时间

不要同时发布到所有平台。建议间隔 24-48 小时：

• 第 1 天：WordPress（主渠道，建立 SEO 权威）
• 第 2 天：Substack（提升邮件订阅者参与度）
• 第 3 天：Medium（吸引搜索流量）
• 第 4 天：LinkedIn（最大化专业影响力）

此举可避免因重复内容被算法处罚，并实现跨平台最大曝光。

4. 使用平台专属行动号召（CTA）

• WordPress：「订阅我的通讯」（用于积累邮箱列表）
• Substack：「分享给同事」（用于扩大订阅人群）
• Medium：「关注我获取更多见解」（用于增长 Medium 粉丝）
• LinkedIn：「你的看法是？」（用于提升互动率）

5. 监控各平台专属指标

跟踪每平台的关键数据：

• WordPress：访问量、跳出率、页面停留时间、转化率
• Substack：打开率、点击率、订阅人数增长
• Medium：鼓掌数、阅读时长、粉丝增长
• LinkedIn：曝光量、互动率、个人资料访问量

6. 批量处理内容

按周或按月批量同步内容，而非单篇逐次操作。这能减少 API 调用次数，提高效率，并支持更优的排期管理。

7. 保持原始链接一致性

始终将 WordPress 设为原始内容源。这向搜索引擎表明哪个版本为“原创”，有助于维护 SEO 价值。

安全与防护机制

本技能不会执行以下行为

• 未经许可的再发布：同步前需用户明确确认
• 抄袭行为：不复制其他创作者内容，除非注明出处
• 垃圾信息分发：遵守各平台服务条款，不人为制造虚假互动
• 数据爬取：仅收集平台通过 API 提供的数据，不主动抓取读者信息
• 未经同意的内容修改：保留原文核心信息，仅按平台要求调整格式
• 无原始链接的跨平台发布：始终维护原始链接，防止 SEO 损失

限制与边界

1. 平台 API 速率限制

- WordPress：每秒最多 10 次请求

- Substack：每小时最多 100 次请求

- Medium：每小时最多 50 次请求

- LinkedIn：每天最多 100 次请求

- 超出请求将自动排队并重试

1. 内容类型限制

- 视频内容：仅支持链接形式（平台不支持通过 API 直接上传视频）

- 付费内容：无法同步至免费平台（遵守 Medium 合作计划规则）

- 敏感内容：需人工审核后方可同步

1. 图片处理规范

- 单张图片最大 50MB

- 支持格式：JPG、PNG、WebP、GIF

- 系统会自动根据各平台需求进行优化

1. 认证机制

- 认证令牌会过期，需手动刷新（建议设置日历提醒）

- 所有平台均需启用多因素认证

- API 密钥存储于加密保险库中（永不记录或暴露）

1. 内容发布审批

- 草稿必须手动发布（不支持从草稿自动发布）

- 计划发布内容需预留至少 15 分钟审查窗口

- 批量同步每次最多 50 篇文章

故障排查

常见问题与解决方案

问题 1："认证失败 - 无效令牌"

原因：API 令牌已过期或凭据错误

解决方案：

1. 在 ClawHub 秘密仪表板中验证令牌
2. 在平台中重新生成令牌（设置 → API/集成）
3. 更新 .env 文件中的 WORDPRESS_API_KEY、MEDIUM_API_TOKEN 等配置
4. 测试连接：curl -H "Authorization: Bearer YOUR_TOKEN" https://api.platform.com/me
5. 重试同步

问题 2："超出速率限制"

原因：向平台 API 发送请求过多

解决方案：

1. 该技能会自动排队请求——单篇文章同步无需操作
2. 对批量同步：将批次大小从 50 减少到 25 篇文章
3. 增加平台同步之间的间隔时间（例如，从 24 小时改为 48-72 小时）
4. 检查平台 API 状态：https://status.medium.com，https://status.substack.com

问题 3："图片未同步"

原因：图片链接失效、格式不支持或文件大小超过限制

解决方案：

1. 验证图片链接是否可公开访问（不在登录后才能访问）
2. 检查图片格式（仅支持 JPG、PNG、WebP、GIF）
3. 若图片大于 5MB，请压缩：使用 ImageOptim（Mac）或 TinyPNG（网页工具）
4. 重新上传图片至 WordPress 后，再次尝试同步
5. 查看同步日志：clawhub logs cross-platform-content-syncer --tail 50

问题 4："Medium/LinkedIn 上格式错乱"

原因：HTML 转换错误或不支持的格式

解决方案：

1. 检查源内容中是否存在复杂 HTML（如表格、嵌套列表、iframe）
2. 简化格式：仅使用粗体/斜体，避免自定义 CSS
3. 先用较简单的文章测试同步效果
4. 启用 preserve_formatting: false 以自动清理 HTML
5. 提供截图联系支持：support@clawhub.app

问题 5："Slack 通知未到达"

原因：无效的 webhook URL 或 Slack 工作区权限不足

解决方案：

1. 验证 .env 文件中的 SLACK_WEBHOOK_URL（应以 https://hooks.slack.com 开头）
2. 检查 Slack 应用权限：设置 → 管理应用 → ClawHub → 权限
3. 手动测试 webhook：

   curl -X POST -H 'Content-type: application/json' \
     --data '{"text":"Test message"}' \
     YOUR_WEBHOOK_URL

1. 如需，重新生成 webhook：Slack → 集成 → 入站 webhook
2. 确认配置中 notify_slack: true

常见问题解答

问：我可以只同步到部分平台，而不是全部吗？

答：可以。在配置中设置 target_platforms: ["medium", "linkedin"]，即可仅同步至指定平台。

问：如果某个平台同步失败，其他平台还会继续同步吗？

答：是的。该技能会独立同步每个平台。若 Medium 同步失败，WordPress/Substack/LinkedIn 仍会正常发布。系统会自动重试失败的平台。