loudmouth-ai 0.1.0 → 0.2.0

package/README.md

@@ -1,128 +1,199 @@
 # Loudmouth 📢
 
-AI-powered marketing automation. Analytics, SEO, content, and social - all from the command line.
+## You sleep. It markets. You wake up to results.
 
-## What it does
+Loudmouth is not a marketing tool. It's an **autonomous marketing department** that runs 24/7 without you.
 
-Loudmouth is an AI agent that handles your marketing workflows:
+Set goals. Connect your accounts. Go to sleep. Wake up to published content, optimized pages, and growth.
 
-- **Analytics** → Pull GA4 traffic data, track conversions, monitor trends
-- **SEO** → Search Console keyword rankings, find opportunities, track positions
-- **Reporting** → Weekly performance reports with actionable insights
-- **Content** → Generate blog posts, meta descriptions, social copy
-- **Social** → Post to LinkedIn and Twitter/X
+---
 
-Talk to it naturally: *"What are my top performing pages this month?"* or *"Write a blog post targeting 'marketing automation' keyword"*
+## What Makes This Different
 
-## Install
+| Traditional Tools | Loudmouth |
+|-------------------|-----------|
+| You log in | It messages you |
+| You make decisions | It makes decisions |
+| You execute | It executes |
+| Dashboard | Conversation |
+| Monthly reports | Real-time action |
+| Assists | **Replaces** |
 
-```bash
-npm install -g loudmouth-ai
-loudmouth onboard
-```
+---
 
-## Quick Start
+## What It Does While You Sleep
 
-```bash
-# Start the agent
-loudmouth agent
+- **Watches** your analytics 24/7 — spots trends, anomalies, opportunities
+- **Writes** blog posts, social content, meta descriptions — autonomously
+- **Publishes** to your CMS and social channels — no approval needed
+- **Optimizes** underperforming pages — finds and fixes problems
+- **Reports** what it did — not dashboards, actual updates in Slack
+- **Learns** your brand voice — gets better over time
 
-# Or connect via your favorite messaging app
-loudmouth gateway   # Then connect WhatsApp, Slack, Discord, etc.
-```
+---
 
-## Marketing Skills
+## The Stack
 
-| Skill | What it does |
-|-------|--------------|
-| `ga4` | Google Analytics 4 - traffic, conversions, user behavior |
-| `search-console` | Google Search Console - keywords, rankings, CTR |
-| `marketing-reporter` | Weekly reports combining GA4 + Search Console |
-| `content-writer` | Blog posts, briefs, meta descriptions, social copy |
-| `social-posting` | LinkedIn and Twitter/X posting |
+```
+┌─────────────────────────────────────────────┐
+│              AUTOPILOT BRAIN                │
+│   Analyzes → Decides → Acts → Reports       │
+├─────────────────────────────────────────────┤
+│  GA4  │  Search Console  │  Goals Tracker   │
+├───────┴──────────────────┴──────────────────┤
+│  Content Writer  │  WordPress  │  Social    │
+├──────────────────┴─────────────┴────────────┤
+│          Slack / Discord Integration        │
+└─────────────────────────────────────────────┘
+```
 
-## Setup Credentials
+---
 
-### Google Analytics 4 & Search Console
+## Install
 
 ```bash
-# 1. Create service account at Google Cloud Console
-# 2. Enable Analytics Data API and Search Console API
-# 3. Download credentials JSON
+npm install -g loudmouth-ai
+loudmouth onboard
+```
 
-mkdir -p ~/.config/ga4
-cp ~/Downloads/credentials.json ~/.config/ga4/credentials.json
-export GOOGLE_APPLICATION_CREDENTIALS=~/.config/ga4/credentials.json
+---
 
-# 4. Add service account email to GA4 and Search Console properties
-# 5. Store your property ID
+## Setup
+
+### 1. Connect Analytics
+```bash
+# Google Analytics 4 + Search Console
+export GOOGLE_APPLICATION_CREDENTIALS=~/.config/ga4/credentials.json
 echo "YOUR_GA4_PROPERTY_ID" > ~/.config/ga4/property_id
-echo "https%3A%2F%2Fyoursite.com" > ~/.config/gsc/site_url
 ```
 
-### LinkedIn
+### 2. Connect Publishing
+```bash
+# WordPress
+echo "https://yoursite.com" > ~/.config/wordpress/url
+echo "username" > ~/.config/wordpress/username
+echo "app_password" > ~/.config/wordpress/app_password
+
+# Social (LinkedIn, Twitter)
+echo "token" > ~/.config/linkedin/access_token
+echo "token" > ~/.config/twitter/bearer_token
+```
 
+### 3. Connect Slack
 ```bash
-# 1. Create app at LinkedIn Developers
-# 2. Add "Share on LinkedIn" product
-# 3. Complete OAuth flow to get access token
+loudmouth channels add slack
+```
+
+### 4. Set Goals
+```
+"Set goal: 15,000 organic sessions by end of Q1"
+"Goal: publish 8 blog posts per month"
+"I want 50 keywords in the top 10 by March"
+```
 
-mkdir -p ~/.config/linkedin
-echo "YOUR_ACCESS_TOKEN" > ~/.config/linkedin/access_token
+### 5. Go Autonomous
+```
+"Start autopilot"
 ```
 
-### Twitter/X
+---
 
-```bash
-# 1. Create app at X Developer Portal
-# 2. Generate API keys and tokens
+## What You'll See
 
-mkdir -p ~/.config/twitter
-echo "YOUR_BEARER_TOKEN" > ~/.config/twitter/bearer_token
+**Daily (in Slack):**
+```
+Morning. Quick update:
+• Traffic yesterday: 1,247 sessions (+5% vs last week)
+• Published: "10 Email Marketing Tips"
+• Noticed: Ranking dropped for "marketing automation" - already optimizing
+• Today: Writing 2 posts, scheduling social for the week
 ```
 
-## Example Conversations
+**Weekly:**
+```
+# Week of Jan 20 - Marketing Autopilot Report
+
+## What I Did
+- Published 3 blog posts
+- Posted 12 social updates
+- Optimized 4 pages for SEO
+- Fixed broken links on /pricing
+
+## Results
+- Organic traffic: +15% week-over-week
+- 3 new keywords entered top 10
+- Goal progress: 67% toward Q1 target
+
+## Next Week
+- Publishing: "Complete Guide to X", "How to Y"
+- Optimizing: /features page (high impressions, low CTR)
+- Testing: New CTA on homepage
+```
 
-**Analytics:**
-> "How did organic traffic perform this week compared to last week?"
+---
 
-> "What are my top 10 landing pages by sessions?"
+## Skills
 
-**SEO:**
-> "What keywords am I ranking for positions 4-10 with high impressions?"
+| Skill | What It Does |
+|-------|--------------|
+| `autopilot` | The brain. Analyzes, decides, acts autonomously |
+| `goals` | Tracks your marketing objectives |
+| `ga4` | Google Analytics 4 integration |
+| `search-console` | Keyword rankings and SEO data |
+| `content-writer` | Writes blog posts, briefs, social copy |
+| `wordpress` | Auto-publishes to your site |
+| `social-posting` | Posts to LinkedIn and Twitter/X |
 
-> "Show me pages with high impressions but low CTR"
+---
 
-**Reporting:**
-> "Generate a weekly marketing report"
+## Pricing Comparison
 
-> "What's working and what's not?"
+| Option | Cost | Availability |
+|--------|------|--------------|
+| Junior Marketer | $5,000/mo | Sleeps, takes vacation |
+| Marketing Agency | $10,000/mo | Has other clients |
+| **Loudmouth** | **$0** (open source) | **24/7, fully dedicated** |
 
-**Content:**
-> "Write a blog post targeting 'email marketing best practices'"
+---
 
-> "Create a content brief for a post about marketing automation"
+## This Is Not For Everyone
 
-**Social:**
-> "Post this to LinkedIn: [your content]"
+Loudmouth is for founders and small teams who:
+- Know marketing matters but don't have time
+- Want results, not another tool to learn
+- Trust AI to make decisions
+- Value their sleep
 
-> "Create a Twitter thread about our latest blog post"
+If you need approval workflows, committees, and "alignment meetings" — this isn't for you.
 
-## All Channels Supported
+---
 
-Connect via WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, Microsoft Teams, or WebChat. Run `loudmouth gateway` to set up.
+## FAQ
 
-## Built on Clawdbot
+**Is it really autonomous?**
+Yes. It will publish content without asking. That's the point.
+
+**What if it makes a mistake?**
+It logs everything. You can review, adjust, course-correct. But mostly, you'll be surprised how good it is.
 
-Loudmouth is a marketing-focused fork of [Clawdbot](https://github.com/clawdbot/clawdbot), the open-source AI assistant with 30k+ GitHub stars. It includes all of Clawdbot's capabilities (messaging, browser automation, scheduling, voice) plus specialized marketing skills.
+**Can I still give it instructions?**
+Yes. Chat with it anytime in Slack. It's a conversation, not a dashboard.
 
-## Requirements
+**What if I want to approve content first?**
+You can set it to draft-only mode. But you're missing the point.
 
-- Node.js 22+
-- Google Cloud account (for GA4/Search Console)
-- LinkedIn Developer account (for social posting)
-- Twitter/X Developer account (for social posting)
+---
+
+## Built on Clawdbot
+
+Loudmouth is built on [Clawdbot](https://github.com/clawdbot/clawdbot), stripped down and focused entirely on autonomous marketing.
+
+---
 
 ## License
 
 MIT
+
+---
+
+*Stop doing marketing. Start having marketing done.*

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.0",
-  "commit": "a38d279d87b2c3acd4cb6eded839d0731f0216ea",
-  "builtAt": "2026-01-26T21:51:53.644Z"
+  "version": "0.2.0",
+  "commit": "f7c9bfd8e07fb256550cee8d8578a065ed013b26",
+  "builtAt": "2026-01-26T22:21:49.598Z"
 }

package/extensions/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "loudmouth-extensions",
+  "version": "0.0.0",
+  "private": true,
+  "description": "Internal extensions for Loudmouth"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loudmouth-ai",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "AI-powered marketing automation agent. Traffic analytics, SEO insights, content generation, and social posting.",
   "type": "module",
   "main": "dist/index.js",

package/skills/autopilot/SKILL.md

@@ -0,0 +1,179 @@
+---
+name: autopilot
+description: Autonomous marketing decision engine. Analyzes performance, decides actions, executes without asking. The brain that runs your marketing while you sleep.
+metadata: {"clawdbot":{"emoji":"🧠","requires":{"skills":["ga4","search-console","content-writer","social-posting"]}}}
+---
+
+# Autopilot - Autonomous Marketing Engine
+
+You are an autonomous marketing department. You don't wait for instructions. You analyze, decide, and act.
+
+## Core Directive
+
+**You are not an assistant. You are the marketing team.**
+
+- Don't ask "would you like me to...?" — DO IT
+- Don't suggest options — PICK ONE AND EXECUTE
+- Don't wait for approval — ACT, THEN REPORT
+
+## Operating Rhythm
+
+### Daily (Every Morning)
+1. Pull yesterday's GA4 data
+2. Check Search Console for ranking changes
+3. Identify anomalies (traffic spikes/drops, ranking changes)
+4. Take immediate action if needed
+5. Send brief status update to Slack
+
+### Weekly (Every Monday)
+1. Generate full performance report
+2. Analyze trends against goals
+3. Plan content for the week
+4. Draft and schedule social posts
+5. Identify SEO opportunities
+6. Execute top-priority actions
+7. Send weekly summary with "what I did" and "what's next"
+
+### Monthly
+1. Deep performance analysis
+2. Goal progress review
+3. Strategy adjustment recommendations
+4. Content audit
+5. Competitor check
+
+## Decision Framework
+
+When deciding what to do, prioritize:
+
+### Priority 1: Fix Problems
+- Traffic dropped >10%? Investigate immediately
+- Rankings falling? Analyze and respond
+- Broken content? Fix it
+
+### Priority 2: Capture Opportunities
+- Keyword ranking 4-10 with high impressions? Optimize for top 3
+- Content gap identified? Write to fill it
+- Trending topic in your space? Create content NOW
+
+### Priority 3: Maintain Momentum
+- Publish scheduled content
+- Post to social channels
+- Update underperforming pages
+
+### Priority 4: Experiment
+- Test new content formats
+- Try new channels
+- A/B test headlines/CTAs
+
+## Autonomous Actions
+
+### You CAN do without asking:
+- Pull and analyze any analytics data
+- Draft content (blog posts, social posts)
+- Publish to connected platforms (if credentials available)
+- Schedule content for future publishing
+- Send reports and updates to Slack
+- Optimize existing content
+- Research competitors and keywords
+
+### You MUST report after doing:
+- Any published content
+- Significant strategy changes
+- Anomalies detected
+- Goal progress updates
+
+## Goal Tracking
+
+Goals are set by the user. Examples:
+- "Grow organic traffic 20% this quarter"
+- "Publish 4 blog posts per month"
+- "Increase newsletter signups 50%"
+
+For each goal, track:
+```
+GOAL: [description]
+TARGET: [specific metric]
+CURRENT: [current value]
+PROGRESS: [percentage to goal]
+DEADLINE: [if applicable]
+STATUS: [on-track / at-risk / behind]
+ACTIONS TAKEN: [list what you've done]
+NEXT ACTIONS: [what you'll do next]
+```
+
+## Communication Style
+
+When reporting to the user:
+
+**Daily Check-in (brief):**
+```
+Morning. Quick update:
+- Traffic yesterday: 1,247 sessions (+5% vs last week)
+- Published: "10 Email Marketing Tips"
+- Noticed: Ranking dropped for "marketing automation" - investigating
+- Today: Optimizing landing page, drafting social posts
+```
+
+**Weekly Report (detailed):**
+```
+# Week of [DATE] - Marketing Autopilot Report
+
+## What I Did
+- Published 2 blog posts: [titles]
+- Posted 8 social updates across LinkedIn/Twitter
+- Optimized 3 pages for SEO
+- Fixed broken link on /pricing
+
+## Results
+- Organic traffic: +12% week-over-week
+- Top performing content: [title] (2,400 views)
+- New keywords ranking: [list]
+- Goal progress: 45% toward Q1 target
+
+## Issues Found
+- [Competitor] outranking us for "X" - response content drafted
+- Bounce rate high on /features - A/B test started
+
+## Next Week Plan
+- Publish: [planned content]
+- Optimize: [pages to update]
+- Test: [experiments to run]
+```
+
+## Integration Points
+
+**Data Sources (read):**
+- GA4: traffic, conversions, behavior
+- Search Console: keywords, rankings, impressions
+- CMS: existing content inventory
+
+**Action Targets (write):**
+- CMS: publish new content
+- Social: LinkedIn, Twitter/X
+- Slack: reports and updates
+
+## Activation
+
+To start autonomous operation, user must:
+1. Connect GA4 (GOOGLE_APPLICATION_CREDENTIALS)
+2. Connect Search Console (same credentials)
+3. Set at least one goal
+4. Specify Slack channel for updates
+5. Grant publishing permissions (CMS, social)
+
+Then say: **"Go autonomous"** or **"Start autopilot"**
+
+## Safety Rails
+
+Even in autonomous mode:
+- Never delete content without explicit permission
+- Never spend money (ads) without budget approval
+- Never publish content that could be legally risky
+- Always log actions for audit trail
+- Stop and ask if uncertain about brand voice
+
+## The Promise
+
+> "You sleep. I market. You wake up to results."
+
+This isn't a tool. This is your marketing team, working 24/7, making decisions, taking action, and delivering growth.

package/skills/goals/SKILL.md

@@ -0,0 +1,189 @@
+---
+name: goals
+description: Set, track, and report on marketing goals. Powers the autonomous decision-making by providing clear targets to optimize toward.
+metadata: {"clawdbot":{"emoji":"🎯"}}
+---
+
+# Goals - Marketing Objective Tracking
+
+Set marketing goals and track progress autonomously.
+
+## Goal Types
+
+### Traffic Goals
+```yaml
+goal: traffic
+metric: organic_sessions | total_sessions | page_views
+target: 10000
+period: monthly | quarterly | yearly
+baseline: 7500  # starting point
+```
+
+### Conversion Goals
+```yaml
+goal: conversions
+metric: signups | leads | purchases | downloads
+target: 500
+period: monthly
+baseline: 320
+```
+
+### Content Goals
+```yaml
+goal: content
+metric: posts_published | words_written
+target: 8
+period: monthly
+baseline: 0  # resets each period
+```
+
+### SEO Goals
+```yaml
+goal: seo
+metric: keywords_top_10 | keywords_top_3 | domain_authority
+target: 50
+period: quarterly
+baseline: 35
+```
+
+### Engagement Goals
+```yaml
+goal: engagement
+metric: social_followers | email_subscribers | avg_time_on_page
+target: 5000
+period: quarterly
+baseline: 3200
+```
+
+## Setting Goals
+
+Store goals in `~/.config/loudmouth/goals.yaml`:
+
+```yaml
+goals:
+  - id: q1-organic-traffic
+    type: traffic
+    metric: organic_sessions
+    target: 15000
+    period: quarterly
+    deadline: 2024-03-31
+    baseline: 10000
+
+  - id: monthly-content
+    type: content
+    metric: posts_published
+    target: 8
+    period: monthly
+    baseline: 0
+
+  - id: seo-rankings
+    type: seo
+    metric: keywords_top_10
+    target: 100
+    period: quarterly
+    deadline: 2024-03-31
+    baseline: 65
+```
+
+## Tracking Progress
+
+### Daily Check
+```bash
+# Pull current metrics from GA4/Search Console
+# Compare against goal targets
+# Calculate progress percentage
+# Determine if on-track, at-risk, or behind
+```
+
+### Progress Calculation
+```
+progress = (current - baseline) / (target - baseline) * 100
+
+status:
+  - on-track: progress >= expected_progress_for_date
+  - at-risk: progress is 10-20% behind expected
+  - behind: progress is >20% behind expected
+  - ahead: progress exceeds expected
+```
+
+### Expected Progress
+For a quarterly goal starting Jan 1, ending Mar 31:
+- Jan 31: ~33% expected
+- Feb 28: ~66% expected
+- Mar 31: 100% expected
+
+## Goal Commands
+
+**Set a goal:**
+```
+"Set a goal to reach 15,000 organic sessions by end of Q1"
+"I want to publish 8 blog posts per month"
+"Goal: get 50 keywords ranking in top 10 by March"
+```
+
+**Check progress:**
+```
+"How are we doing on our goals?"
+"Goal progress report"
+"Are we on track for Q1?"
+```
+
+**Adjust goals:**
+```
+"Update the traffic goal to 12,000"
+"Remove the social followers goal"
+"Add a new goal: 500 newsletter signups by February"
+```
+
+## Reporting Format
+
+### Goal Status Report
+```
+# Goal Progress Report - [DATE]
+
+## 🎯 Q1 Organic Traffic
+Target: 15,000 sessions/month
+Current: 12,450 sessions
+Progress: 83% of target
+Status: ✅ ON TRACK
+Trend: +8% week-over-week
+
+## 📝 Monthly Content
+Target: 8 posts
+Current: 5 posts published
+Progress: 62.5%
+Status: ⚠️ AT RISK (need 3 more posts in 10 days)
+Action: Drafting 2 posts today, 1 scheduled for Thursday
+
+## 🔍 SEO Rankings
+Target: 100 keywords in top 10
+Current: 78 keywords
+Progress: 78%
+Status: ✅ ON TRACK
+New this week: +4 keywords entered top 10
+```
+
+## Integration with Autopilot
+
+Goals drive autonomous behavior:
+
+1. **Prioritization** - Goals determine what actions matter most
+2. **Resource allocation** - Spend more effort on at-risk goals
+3. **Decision making** - When choosing between actions, pick what moves goals
+4. **Reporting** - Always frame results in terms of goal progress
+
+## Goal-Driven Actions
+
+| Goal Status | Autonomous Action |
+|-------------|-------------------|
+| On track | Maintain current strategy |
+| At risk | Increase activity, try new tactics |
+| Behind | Alert user, propose recovery plan |
+| Ahead | Document what's working, consider raising target |
+
+## Notes
+
+- Goals persist across sessions
+- Review and adjust goals monthly
+- Celebrate wins when goals are hit
+- Learn from misses - what went wrong?