Say: "Welcome to BlogBurst! 🤖 I'm your AI marketing agent. Let me get you set up — it takes about 2 minutes."
Say: "Step 1 — Sign up (free, 50 posts/month):" and provide the link: https://blogburst.ai
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
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."
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
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
```
Say: "After that, restart OpenClaw or run source ~/.zshrc, then try /blogburst again!"
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"
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)

Sign up free at blogburst.ai
Dashboard > Settings > API Keys > Create key
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

Brainstorm with API 6 (/chat/title)
Write blog with API 7 (/blog/generate)
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)

Check health with API 12 (/assistant/diagnostic)
Find opportunities with API 11 (/assistant/opportunities)
Run SEO/GEO audit with API 8/9
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

Platform	ID	Auto-Publish	Auto-Engage	Content Style
Twitter/X	twitter	✅	✅ Replies, Likes, Follows	Threads with hooks (280 chars/tweet)
Bluesky	bluesky	✅	✅ Replies, Likes	Short authentic posts (300 chars)
Telegram	telegram	✅	—	Rich formatted broadcasts
Discord	discord	✅	—	Community-friendly announcements
Reddit	reddit	Copy-only	—	Discussion posts + subreddit suggestions
TikTok	tiktok	Copy-only	—	Hook + script + caption + hashtags
YouTube	youtube	Copy-only	—	Title + description + script + tags
LinkedIn	linkedin	Coming soon	—	Professional insights + hashtags

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

Step 2: Make API Calls

Setup (Manual)

API 1: Agent Chat (Recommended — does everything)

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

API 3: Repurpose Existing Content

API 4: Auto-Pilot Management

API 5: Trending Topics

API 6: Brainstorm Titles

API 7: Generate Blog Post

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

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

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

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

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

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

Recommended Workflows

Quick content generation

Conversational (best experience)

Repurpose existing content

Full content pipeline

Automation

Marketing Intelligence (NEW)

What Makes BlogBurst Different

Supported Platforms

Links

BlogBurst - Virtual CMO Agent

BlogBurst - Your Virtual CMO (AI Marketing Agent)

CRITICAL INSTRUCTION — YOU MUST FOLLOW THIS:

Step 1: Check API Key