Your AI Chief Marketing Officer. Autonomous agent that runs your entire marketing — auto-posts to Twitter/X, Bluesky, Telegram, Discord, auto-engages with your audience (replies, likes, follows), runs SEO/GEO audits, tracks competitors, scans communities for opportunities, learns what works, and continuously optimizes. 50+ countries, 1000+ posts published. Free tier available.
SKILL.md
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):
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:
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"
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)
{
"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.
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.
