BlogBurst - Your Virtual CMO (AI 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 the full setup (4 steps, ~2 minutes):

1. Say: "Welcome to BlogBurst! 🤖 I'm your AI marketing agent. Let me get you set up — it takes about 2 minutes."
2. Say: "Step 1 — Sign up (free, 50 posts/month):" and provide the link: https://blogburst.ai
3. Say: "Step 2 — Set up your product. Tell me what you're marketing! The onboarding wizard pops up automatically after signup. Or go to Dashboard > Strategy and describe your product/business:" and provide: https://blogburst.ai/dashboard/strategy
4. Say: "Step 3 — Connect your social platforms. Without this I can't post for you! Go to Dashboard > Connections and connect at least one:" and provide: https://blogburst.ai/dashboard/connections
   • "Twitter/X — one-click OAuth, takes 5 seconds. I can auto-post, reply to mentions, like, and follow relevant accounts for you."
   • "Bluesky — enter your handle and app password. I'll auto-post and engage there too."
   • "Telegram / Discord — paste your bot token. I'll broadcast to your channels."
5. Say: "Step 4 — Get your API key. You can only create a key after completing Steps 2-3. Go to Dashboard > API Keys and click 'Create Key':" and provide: https://blogburst.ai/dashboard/api-keys
6. 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
   

7. Say: "After that, restart OpenClaw or run source ~/.zshrc, then try /blogburst again!"
8. 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"
9. If successful, say: "All set! Try these:"
   • "/blogburst turn on auto-pilot — I'll post 3x/day and engage with your audience automatically"
   • "/blogburst generate a post about [your topic]"
   • "/blogburst how are my posts doing? — check your analytics"

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

API 8: SEO Audit (NEW in v3.0)

Get a comprehensive SEO analysis for your product — technical issues, keyword gaps, content recommendations.

Endpoint: GET /assistant/seo-audit?product_id=1

Response:

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

When to use: When user asks "How's my SEO?", "What should I write about for Google?", or "Run an SEO check".

API 9: GEO Audit — AI Search Optimization (NEW in v3.0)

Optimize your content for AI search engines (ChatGPT, Perplexity, Google AI Overviews). GEO = Generative Engine Optimization.

Endpoint: GET /assistant/geo-audit?product_id=1

Response:

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

When to use: When user asks "How do I show up in ChatGPT results?", "Optimize for AI search", or "GEO audit".

API 10: Competitor Intelligence (NEW in v3.0)

Track and analyze competitors' social media strategies.

Endpoint: GET /assistant/competitors?product_id=1

Response:

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

When to use: When user asks "What are my competitors doing?", "Analyze competitor X", or "Find content gaps".

API 11: Community Opportunities (NEW in v3.0)

Scan HackerNews, Reddit, and forums for engagement opportunities relevant to your product.

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

Response:

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

When to use: When user asks "Where should I promote?", "Find places to engage", or "Community opportunities".

API 12: Growth Diagnostic (NEW in v3.0)

AI-powered comprehensive analysis of your marketing performance with actionable tasks.

Endpoint: GET /assistant/diagnostic?product_id=1

Response:

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

When to use: When user asks "How am I doing?", "What should I improve?", or "Marketing report".

API 13: Task Management (NEW in v3.0)

The CMO agent creates and manages marketing tasks for you.

Get tasks: GET /assistant/tasks?product_id=1&status=pending

Response:

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

Complete a task: POST /assistant/tasks/42/complete

When to use: When user asks "What should I work on?", "My marketing tasks", or "What's the CMO recommending?"

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)

Marketing Intelligence (NEW)

1. Check health with API 12 (/assistant/diagnostic)
2. Find opportunities with API 11 (/assistant/opportunities)
3. Run SEO/GEO audit with API 8/9
4. Get tasks from API 13 (/assistant/tasks)

What Makes BlogBurst Different

• Autonomous Agent: Not just a tool — it's a CMO that works 24/7. Posts, engages, learns, optimizes.
• Auto-Engagement: Replies to mentions, proactively engages with relevant tweets, smart follows — all automated.
• Self-Learning: Tracks what content performs best, continuously adapts strategy based on real data.
• SEO + GEO: Optimizes for both Google AND AI search engines (ChatGPT, Perplexity).
• Community Scanner: Finds conversations on HN/Reddit where your product is relevant.
• Multi-Platform: One agent manages Twitter/X, Bluesky, Telegram, Discord simultaneously.

Supported Platforms

Important: To auto-publish, connect your platforms at Dashboard > Connections. Twitter/X is one-click OAuth — takes 5 seconds.

Links

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