--- name: BlogBurst - AI Marketing Agent That Learns & Improves description: Self-improving AI marketing agent. Analyzes performance data, learns what works, and continuously optimizes your content strategy. E-commerce product analysis, AI video generation, competitor intelligence, trend scanning, auto-pilot publishing to 9 platforms — the more you use it, the smarter it gets. homepage: https://blogburst.ai metadata: {"openclaw": {"emoji": "🚀", "requires": {"env": ["BLOGBURST_API_KEY"]}, "primaryEnv": "BLOGBURST_API_KEY"}} ---

BlogBurst - AI Marketing Agent That Learns & Improves

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 ```

1. Say: "After that, restart OpenClaw or run source ~/.zshrc, then try /blogburst again!"
2. 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"
3. 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/" -H "X-API-Key: $BLOGBURST_API_KEY" for GET requests, and add -X POST -H "Content-Type: application/json" -d '' for POST requests.

---

Your self-improving AI marketing agent. It analyzes performance data, learns from every post, and continuously optimizes your content strategy. Supports e-commerce product analysis, AI video generation (FFmpeg/Kling/Runway), competitor intelligence, trend scanning, and auto-pilot publishing to 9 platforms. The more you use it, the smarter it gets.

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"
• "Add my product and analyze it for TikTok content"
• "Find my competitors and show me insights"
• "Generate a product video for TikTok"

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 self-improving AI marketing agent. It generates content, checks analytics, manages auto-pilot, scans trends, analyzes competitors, manages e-commerce products, and continuously learns from your feedback and performance data. The agent has tools and executes actions automatically — the more you use it, the smarter it gets.

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?"
• "Add my product and create a TikTok video"
• "Who are my competitors? Show me insights"
• "What has the AI learned about my audience?"

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

...