---

name: BlogBurst - AI Social Media Agent description: Autonomous AI marketing agent. Chat naturally to generate content, manage auto-pilot, check analytics, and post to 9 platforms (Twitter/X, LinkedIn, Bluesky, Telegram, Discord, Reddit, TikTok, YouTube, Threads). One command to automate your entire social media. homepage: https://blogburst.ai metadata: {"openclaw": {"emoji": "🚀", "requires": {"env": ["BLOGBURST_API_KEY"]}, "primaryEnv": "BLOGBURST_API_KEY"}}

BlogBurst - AI Social Media Marketing Agent

CRITICAL INSTRUCTION — YOU MUST FOLLOW THIS:

Step 1: Check API Key

Before doing ANYTHING, run: echo $BLOGBURST_API_KEY

If the output is empty or the variable is not set, do NOT proceed with API calls. Instead, guide the user through setup:

1. Say: "Welcome to BlogBurst! 🚀 Let me help you get set up. It only takes 30 seconds."
2. Say: "First, sign up for a free account (50 generations/month):" and provide the link: https://blogburst.ai
3. Say: "Once signed in, go to Dashboard > Settings > API Keys and click 'Create Key'."
4. Say: "Then run this command in your terminal (replace your-key with the key you just created):"

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

5. Say: "After that, restart OpenClaw or run source ~/.zshrc, then try /blogburst again!"
6. If the user says they've done it, verify by running: curl -s "https://api.blogburst.ai/api/v1/usage" -H "X-API-Key: $BLOGBURST_API_KEY"
7. If successful, say: "All set! Try: /blogburst generate a post about [topic]"

Step 2: Make API Calls

When $BLOGBURST_API_KEY is set, you MUST use the exec tool to run curl commands against the BlogBurst API. Do NOT use web_search or any other tool as a substitute. The API returns real user-specific data (their posts, their analytics, their auto-pilot status). Web search cannot provide this.

How to execute: Use exec with curl -s "https://api.blogburst.ai/api/v1/<endpoint>" -H "X-API-Key: $BLOGBURST_API_KEY" for GET requests, and add -X POST -H "Content-Type: application/json" -d '<json>' for POST requests.

---

Your autonomous AI marketing agent. Talk naturally — it generates content, publishes to 9 platforms, runs auto-pilot daily posting, tracks analytics, and learns what works.

One message to do anything:

• "Post about my product launch on Twitter and LinkedIn"
• "Turn on auto-pilot, 3 posts per day"
• "How did my posts perform this week?"
• "Repurpose this article: https://myblog.com/post"

Setup (Manual)

1. Sign up free at blogburst.ai
2. Dashboard > Settings > API Keys > Create key
3. Set environment variable:

export BLOGBURST_API_KEY="your-key"

All requests use: X-API-Key: $BLOGBURST_API_KEY Base URL: https://api.blogburst.ai/api/v1

---

API 1: Agent Chat (Recommended — does everything)

Chat with your AI marketing agent. It can generate content, check analytics, manage auto-pilot, view trending topics, and more — all through natural conversation. The agent has tools and will execute actions automatically.

Endpoint: POST /assistant/agent-chat-v2

Request:

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

Multi-turn conversation — send the full message history each time:

{
  "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"
}

Response:

{
  "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
        }
      }
    }
  ]
}

What users can say (the agent understands natural language):

• "Generate a post for Twitter/Bluesky/LinkedIn/all platforms"
• "What's trending in my space?"
• "How are my posts doing this week?"
• "Turn on auto-pilot" / "Pause auto-pilot"
• "What did you post today?"
• "What platforms do I have connected?"
• "Show me my recent activity"

When to use: This is the PRIMARY API. Use it for any user request about social media content, analytics, automation, or marketing. It handles everything through conversation.

---

API 2: Generate Platform Content (Quick one-shot)

Generate optimized content for multiple platforms at once. Use this for fast, direct generation without conversation.

Endpoint: POST /blog/platforms

Request:

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

Parameters:

• topic (required): The title or topic (5-500 chars)
• platforms (required): Array from: twitter, linkedin, reddit, bluesky, threads, telegram, discord, tiktok, youtube
• tone: professional | casual | witty | educational | inspirational (default: professional)
• language: Language code (default: en)

Response:

{
  "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."]
  }
}

When to use: When user wants quick multi-platform content from a topic without ongoing conversation.

---

API 3: Repurpose Existing Content

Transform a blog post or article (by URL or text) into platform-optimized posts.

Endpoint: POST /repurpose

Request:

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

Parameters:

• content (required): A URL to an article, or the full text (min 50 chars)
• platforms (required): Array from: twitter, linkedin, reddit, bluesky, threads, telegram, discord, tiktok, youtube
• tone: professional | casual | witty | educational | inspirational
• language: Language code (default: en)

Response: Same format as API 2.

When to use: When user provides a URL or pastes existing content and wants it adapted for social platforms.

---

API 4: Auto-Pilot Management

Check and configure the autonomous posting agent.

Get status: GET /assistant/auto-pilot

Response:

{
  "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
}

Configure: POST /assistant/auto-pilot

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

Run immediately: POST /assistant/auto-pilot/run-now

When to use: When user wants to start/stop auto-pilot, change posting frequency, or check automation status.

---

API 5: Trending Topics

Get real-time trending topics from Reddit, HackerNews, Google Trends, and Product Hunt. Updated every 4 hours.

Endpoint: GET /assistant/trending-topics?limit=10

Response:

{
  "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"]
}

When to use: When user asks about trends, hot topics, or what's popular to write about.

---

API 6: Brainstorm Titles

Chat with AI to develop compelling titles.

Endpoint: POST /chat/title

Request:

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

Response:

{
  "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: Generate Blog Post

Generate a full blog article from a topic.

Endpoint: POST /blog/generate

Request:

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

Parameters:

• topic (required): Title or topic (5-500 chars)
• tone: professional | casual | witty | educational | inspirational
• language: Language code (default: en)
• length: short (500-800 words) | medium (1000-1500) | long (2000-3000)

Response:

{
  "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"]
}

---

Recommended Workflows

Quick content generation

User says: "Create posts about X for Twitter and LinkedIn" → Call API 2 (/blog/platforms)

Conversational (best experience)

User says: "Help me with my social media" or anything complex → Call API 1 (/assistant/agent-chat-v2) — the agent handles everything

Repurpose existing content

User shares a URL or pastes text → Call API 3 (/repurpose)

Full content pipeline

1. Brainstorm with API 6 (/chat/title)
2. Write blog with API 7 (/blog/generate)
3. Distribute with API 2 (/blog/platforms)

Automation

User says: "Automate my posting" or "Turn on auto-pilot" → Call API 4 (/assistant/auto-pilot)

Supported Platforms

Links

• Website: https://blogburst.ai
• API Docs: https://api.blogburst.ai/docs
• GitHub: https://github.com/shensi8312/blogburst-openclaw-skill