BlogBurst - 您的虚拟首席营销官（AI营销助手）

关键指令 — 您必须遵守：

步骤 1：检查 API 密钥

在进行任何操作之前，请运行：echo $BLOGBURST_API_KEY

如果输出为空或变量未设置，请勿继续执行 API 调用。相反，引导用户完成完整的设置（4 个步骤，约 2 分钟）：

1. 说："欢迎使用 BlogBurst！🤖 我是您的 AI 营销助手。让我为您完成设置 — 大约需要 2 分钟。"
2. 说："步骤 1 — 注册（免费，每月 50 篇帖子）："并提供链接：https://blogburst.ai
3. 说："步骤 2 — 设置您的产品。告诉我您要营销什么！注册后，入门向导会自动弹出。或者前往仪表板 > 策略并描述您的产品/业务："并提供：https://blogburst.ai/dashboard/strategy
4. 说："第三步 — 连接您的社交平台。没有这一步，我就无法为您发布内容！请前往仪表板 > 连接并至少连接一个平台："并提供：https://blogburst.ai/dashboard/connections
   • "Twitter/X— 一键OAuth授权，只需5秒。我可以为您自动发帖、回复提及、点赞以及关注相关账户。"
   • "Bluesky— 输入您的用户名和应用密码。我也会在那里自动发帖和互动。"
   • "Telegram / Discord— 粘贴您的机器人令牌。我将向您的频道进行广播。"
5. 说："第四步 — 获取您的API密钥。只有在完成第2-3步后，您才能创建密钥。请前往仪表板 > API密钥并点击'创建密钥'："并提供：https://blogburst.ai/dashboard/api-keys
6. 说："然后在你的终端中运行这个命令（将your-key替换为你刚刚创建的密钥）："

   echo 'export BLOGBURST_API_KEY="your-key"' >> ~/.zshrc && source ~/.zshrc
   

7. 说："之后，重启 OpenClaw 或运行source ~/.zshrc，然后再次尝试/blogburst！"
8. 如果用户说他们已经完成了，通过运行以下命令来验证：curl -s "https://api.blogburst.ai/api/v1/usage" -H "X-API-Key: $BLOGBURST_API_KEY"
9. 如果成功，说："一切就绪！试试这些命令："
   • "/blogburst turn on auto-pilot — 我将每天发布3次并自动与你的受众互动"
   • "/blogburst generate a post about [你的主题]"
   • "/blogburst how are my posts doing? — 查看你的分析数据"

步骤2：进行API调用

当$BLOGBURST_API_KEY设置好时，你必须使用exec工具来运行curl针对BlogBurst API的命令。请勿使用web_search或任何其他工具作为替代。该API返回真实的用户特定数据（他们的帖子、分析数据、自动运行状态）。网络搜索无法提供这些。

如何执行：使用exec配合curl -s "https://api.blogburst.ai/api/v1/<endpoint>" -H "X-API-Key: $BLOGBURST_API_KEY"用于GET请求，并添加-X POST -H "Content-Type: application/json" -d '<json>'用于POST请求。

您的自主AI营销代理。自然地交谈——它能生成内容、发布到9个平台、运行每日自动发布、跟踪分析数据，并学习有效的方法。

一条消息即可完成任何操作：

• "在Twitter和LinkedIn上发布关于我的产品发布的消息"
• "开启自动运行，每日3篇帖子"
• "我这周的帖子表现如何？"
• "重新利用这篇文章：https://myblog.com/post"

设置（手动）

1. 免费注册于blogburst.ai
2. 控制面板 > 设置 > API密钥 > 创建密钥
3. 设置环境变量：

export BLOGBURST_API_KEY="your-key"

所有请求使用：X-API-Key: $BLOGBURST_API_KEY基础URL：https://api.blogburst.ai/api/v1

API 1：智能体对话（推荐 — 功能全面）

与您的AI营销智能体对话。它可以通过自然对话生成内容、查看分析、管理自动运行、查看热门话题等。该智能体具备多种工具，并能自动执行操作。

端点：POST /assistant/agent-chat-v2

请求：

{
  "messages": [
    {"role": "user", "content": "Generate a Twitter post about my product"}
  ],
  "language": "en"
}

多轮对话 — 每次发送完整的消息历史：

{
  "messages": [
    {"role": "user", "content": "Generate a Twitter post about my product"},
    {"role": "assistant", "content": "Here's your Twitter post..."},
    {"role": "user", "content": "Now make one for LinkedIn too"}
  ],
  "language": "en"
}

响应：

{
  "reply": "I've generated a Twitter post for you. Ready to copy and post!",
  "data_referenced": ["marketing_strategy", "analytics_7d"],
  "agent_name": "Nova",
  "actions_taken": [
    {
      "tool": "generate_content",
      "result": {
        "success": true,
        "data": {
          "platform": "twitter",
          "content": "Week 3 building BlogBurst. 15 followers, 40 posts published. Best post got 5 likes on Bluesky. Small numbers, real progress.\n\nThe AI agent now picks topics based on what actually performed well last week. No more guessing.",
          "image_urls": ["https://..."],
          "copy_only": true
        }
      }
    }
  ]
}

用户可以说什么（智能体能理解自然语言）：

• "为Twitter/Bluesky/LinkedIn/所有平台生成一条帖子"
• "我的领域有什么热门趋势？"
• "我这周的帖子表现如何？"
• "开启自动运行" / "暂停自动运行"
• "你今天发了什么帖子？"
• "我连接了哪些平台？"
• "显示我近期的活动"

何时使用：这是主要API。任何关于社交媒体内容、分析、自动化或营销的用户请求都可以使用它。它通过对话处理所有事宜。

API 2：生成平台内容（快速单次生成）

一次性为多个平台生成优化内容。适用于无需对话、快速直接的生成需求。

端点：POST /blog/platforms

请求：

{
  "topic": "5 lessons from building my SaaS in public",
  "platforms": ["twitter", "linkedin", "bluesky"],
  "tone": "casual",
  "language": "en"
}

参数：

• topic （必填）：标题或主题（5-500字符） (required): The title or topic (5-500 chars)
• 平台（必需）：数组，可选自：twitter, linkedin, reddit, bluesky, threads, telegram, discord, tiktok, youtube
• 语气: 专业 | 随意 | 诙谐 | 教育性 | 鼓舞人心 (默认：专业)
• 语言: 语言代码 (默认：en)

响应:

{
  "success": true,
  "topic": "5 lessons from building my SaaS in public",
  "twitter": {
    "thread": [
      "1/ 5 months building a SaaS in public. Here are the lessons nobody talks about...",
      "2/ Lesson 1: Your first 10 users teach you more than 10,000 pageviews.",
      "3/ Lesson 2: Ship weekly. Perfection is the enemy of traction."
    ]
  },
  "linkedin": {
    "post": "I've been building my SaaS in public for 5 months...",
    "hashtags": ["#BuildInPublic", "#SaaS", "#IndieHacker"]
  },
  "bluesky": {
    "posts": ["5 months of building in public. The biggest lesson: your first users don't care about features. They care that you listen."]
  }
}

使用时机: 当用户希望无需持续对话，快速获取基于某个主题的多平台内容时。

API 3：重新利用现有内容

将一篇博客文章或文章（通过URL或文本）转换为针对平台优化的帖子。

端点:POST /repurpose

请求:

{
  "content": "https://myblog.com/my-article",
  "platforms": ["twitter", "linkedin", "bluesky"],
  "tone": "casual",
  "language": "en"
}

参数:

• 内容（必需）：文章的URL，或完整文本（至少50个字符）
• 平台（必填）：数组来源：twitter、linkedin、reddit、bluesky、threads、telegram、discord、tiktok、youtube
• 语气：专业 | 随意 | 诙谐 | 教育性 | 鼓舞人心
• 语言：语言代码（默认：en）

响应：与API 2格式相同。

何时使用：当用户提供URL或粘贴现有内容，并希望将其适配到社交平台时。

API 4：自动管理

检查并配置自动发布代理。

获取状态：GET /assistant/auto-pilot

响应：

{
  "enabled": true,
  "platforms": ["bluesky", "telegram", "discord", "twitter"],
  "posts_per_day": 4,
  "timezone": "America/New_York",
  "last_daily_run": "2026-03-02T08:49:28Z",
  "reactions_enabled": true
}

配置：POST /assistant/auto-pilot

{
  "enabled": true,
  "posts_per_day": 3,
  "platforms": ["twitter", "bluesky", "telegram"],
  "timezone": "America/New_York"
}

立即运行：POST /assistant/auto-pilot/run-now

何时使用：当用户想要启动/停止自动发布、更改发布频率或检查自动化状态时。

API 5: 热门话题

从Reddit、HackerNews、Google Trends和Product Hunt获取实时热门话题。每4小时更新一次。

端点：GET /assistant/trending-topics?limit=10

响应：

{
  "topics": [
    {"keyword": "AI agents replacing SaaS", "source": "hackernews", "score": 92},
    {"keyword": "Claude Code launch", "source": "reddit", "score": 87},
    {"keyword": "Open source AI tools", "source": "google_trends", "score": 78}
  ],
  "total": 96,
  "sources": ["reddit", "hackernews", "google_trends", "producthunt"]
}

何时使用：当用户询问趋势、热门话题或流行写作主题时。

API 6: 构思标题

与AI对话，构思引人注目的标题。

端点：POST /chat/title

请求：

{
  "messages": [
    {"role": "user", "content": "I want to write about AI agents"}
  ],
  "language": "en"
}

响应：

{
  "success": true,
  "reply": "Great topic! Here are some angles...",
  "suggested_titles": [
    "I Replaced My Marketing Team with an AI Agent",
    "Why AI Agents Are the New SaaS",
    "Building an AI Agent That Posts for Me While I Sleep"
  ]
}

API 7: 生成博客文章

根据主题生成完整的博客文章。

端点:POST /blog/generate

请求:

{
  "topic": "I Replaced My Marketing Team with an AI Agent",
  "tone": "casual",
  "language": "en",
  "length": "medium"
}

参数:

• topic(必填): 标题或主题 (5-500 字符)
• tone: 专业 | 随意 | 诙谐 | 教育性 | 鼓舞人心
• language: 语言代码 (默认: en)
• length: 短 (500-800 词) | 中 (1000-1500 词) | 长 (2000-3000 词)

响应:

{
  "success": true,
  "title": "I Replaced My Marketing Team with an AI Agent",
  "content": "Full markdown blog post...",
  "summary": "A concise summary...",
  "keywords": ["AI agent", "marketing automation", "SaaS"]
}

API 8: SEO 审核 (v3.0 新增)

获取您产品的全面 SEO 分析 — 技术问题、关键词差距、内容建议。

端点:GET /assistant/seo-audit?product_id=1

响应:

{
  "score": 72,
  "audit_type": "seo",
  "findings": {
    "technical": [{"issue": "Missing meta descriptions on 3 pages", "severity": "high"}],
    "content_gaps": ["No content targeting 'AI marketing automation' keyword"],
    "backlink_opportunities": ["Guest post on IndieHackers"]
  },
  "recommendations": [
    {"title": "Create comparison page: BlogBurst vs Buffer", "impact": "high", "type": "content"}
  ]
}

何时使用：当用户询问“我的SEO做得怎么样？”、“我应该为谷歌写什么内容？”或“运行SEO检查”时。

API 9：GEO审计 — AI搜索优化（v3.0版本新增）

为AI搜索引擎（ChatGPT、Perplexity、Google AI概览）优化您的内容。GEO = 生成引擎优化。

端点：GET /assistant/geo-audit?product_id=1

响应：

{
  "score": 58,
  "audit_type": "geo",
  "findings": {
    "ai_visibility": {"score": 45, "key_queries": ["best AI marketing tool"], "missing_queries": ["AI social media agent"]},
    "citation_readiness": {"score": 60, "issues": ["No structured FAQ page", "Missing expert quotes"]},
    "question_coverage": [
      {"question": "What is the best AI marketing tool?", "current_coverage": "none", "priority": "high"}
    ]
  },
  "recommendations": [
    {"title": "Create FAQ with 20 common questions", "impact": "high", "type": "structural"}
  ]
}

何时使用：当用户询问“我如何在ChatGPT结果中显示？”、“为AI搜索优化”或“GEO审计”时。

API 10：竞争对手情报分析（v3.0版本新增）

追踪并分析竞争对手的社交媒体策略。

端点：GET /assistant/competitors?product_id=1

响应：

{
  "competitors": [
    {
      "name": "Buffer",
      "platforms": ["twitter", "linkedin"],
      "posting_frequency": "3x/day",
      "top_content_themes": ["social media tips", "remote work"],
      "engagement_rate": "2.3%",
      "insights": "Heavy use of carousel posts on LinkedIn"
    }
  ],
  "opportunities": ["Competitor X doesn't post on Bluesky — you can own that space"]
}

何时使用：当用户询问“我的竞争对手在做什么？”、“分析竞争对手X”或“寻找内容差距”时。

API 11：社区机遇（v3.0 新增功能）

扫描 HackerNews、Reddit 和论坛，寻找与您产品相关的互动机会。

端点:GET /assistant/opportunities?product_id=1&limit=10

响应:

{
  "opportunities": [
    {
      "source": "hackernews",
      "title": "Ask HN: What tools do you use for social media automation?",
      "url": "https://news.ycombinator.com/item?id=...",
      "relevance_score": 92,
      "suggested_reply": "I built BlogBurst for exactly this — it auto-posts to 4 platforms and even engages with your audience...",
      "expires_at": "2026-03-12T00:00:00Z"
    }
  ]
}

使用时机: 当用户询问“我该在哪里推广？”、“寻找互动场所”或“社区机遇”时使用。

API 12：增长诊断（v3.0 新增功能）

AI驱动的营销表现综合分析，并提供可执行任务。

端点:GET /assistant/diagnostic?product_id=1

响应:

{
  "overall_score": 65,
  "areas": {
    "content_quality": {"score": 78, "trend": "improving"},
    "posting_consistency": {"score": 90, "trend": "stable"},
    "audience_engagement": {"score": 45, "trend": "declining"},
    "growth_rate": {"score": 52, "trend": "improving"}
  },
  "top_actions": [
    {"task": "Increase reply engagement on Twitter", "priority": "high", "expected_impact": "+30% engagement"},
    {"task": "Post during US peak hours (10-11 AM EST)", "priority": "medium", "expected_impact": "+20% reach"}
  ]
}

使用时机: 当用户询问“我的表现如何？”、“我应该改进什么？”或“营销报告”时使用。

API 13：任务管理（v3.0 新增功能）

CMO代理为您创建并管理营销任务。

获取任务：GET /assistant/tasks?product_id=1&status=pending

响应：

{
  "tasks": [
    {
      "id": 42,
      "title": "Write comparison blog: BlogBurst vs Hootsuite",
      "category": "seo",
      "priority": "high",
      "status": "pending",
      "prefilled_content": {"title": "BlogBurst vs Hootsuite: Which AI Marketing Tool Is Right for You?", "outline": ["...", "..."]},
      "due_date": "2026-03-14"
    }
  ]
}

完成任务：POST /assistant/tasks/42/complete

何时使用：当用户询问"我应该做什么工作？"、"我的营销任务"或"CMO推荐什么？"时

推荐的工作流程

快速内容生成

用户说："创建关于X的Twitter和LinkedIn帖子" → 调用API 2(/blog/platforms)

对话式（最佳体验）

用户说："帮我处理社交媒体"或任何复杂任务 → 调用API 1(/assistant/agent-chat-v2) — 代理会处理一切

重新利用现有内容

用户分享URL或粘贴文本 → 调用API 3(/repurpose)

完整内容流水线

1. 头脑风暴API 6(/chat/title)
2. 撰写博客API 7(/blog/generate)
3. 分发API 2(/blog/platforms)

自动化

用户说："自动化我的发布" 或 "开启自动模式" → 调用API 4(/助手/自动驾驶)

营销智能（新功能）

1. 使用以下方式检查健康状况API 12(/助手/诊断)
2. 使用以下方式发现机会API 11(/助手/机会)
3. 使用以下方式运行SEO/GEO审计API 8/9
4. 从以下方式获取任务API 13(/助手/任务)

BlogBurst的独特之处

• 自主代理：不仅仅是一个工具——它是一个全天候工作的首席营销官。发布内容、互动、学习、优化。
• 自动互动自动回复提及、主动参与相关推文、智能关注——全部自动化。
• 自我学习：追踪表现最佳的内容，根据真实数据持续调整策略。
• SEO + GEO：同时针对谷歌和AI搜索引擎（如ChatGPT、Perplexity）进行优化。
• 社区扫描器：在Hacker News/Reddit上寻找与您产品相关的讨论。
• 多平台：一个代理同时管理Twitter/X、Bluesky、Telegram、Discord。

支持平台

重要提示：要启用自动发布，请在仪表板 > 连接处连接您的平台。Twitter/X 是一键式 OAuth 授权 — 只需 5 秒钟。

链接

• 网站：https://blogburst.ai
• API 文档：https://api.blogburst.ai/docs
• GitHub：https://github.com/shensi8312/blogburst-openclaw-skill