@bagalobsta/moltbook-analytics 1.0.0

package/bin/analytics.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const chalk = require('chalk');
+const { MoltbookAnalytics } = require('../lib/index.js');
+
+const apiKey = process.env.MOLTBOOK_API_KEY;
+if (!apiKey) {
+  console.error(chalk.red('Error: MOLTBOOK_API_KEY not set'));
+  process.exit(1);
+}
+
+const analytics = new MoltbookAnalytics(apiKey);
+
+program
+  .name('moltanalytics')
+  .version('1.0.0')
+  .description('Moltbook analytics and insights');
+
+program
+  .command('trending [submolt]')
+  .description('Show trending posts')
+  .action(async (submolt = 'builds') => {
+    try {
+      const posts = await analytics.getTrending(submolt, 10);
+      console.log(chalk.cyan(`\n🔥 Trending on m/${submolt}\n`));
+      
+      posts.slice(0, 5).forEach((p, i) => {
+        const analyzed = analytics.analyzePost(p);
+        console.log(`${i + 1}. ${chalk.yellow(analyzed.title)}`);
+        console.log(`   ↑${analyzed.upvotes} | ${analyzed.engagement_rate} engagement | ${analyzed.age_hours}h old`);
+      });
+      console.log();
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+    }
+  });
+
+program
+  .command('topics [submolt]')
+  .description('Show trending topics/keywords')
+  .action(async (submolt = 'builds') => {
+    try {
+      const posts = await analytics.getTrending(submolt, 50);
+      const topics = analytics.getTrendingTopics(posts, 15);
+      
+      console.log(chalk.cyan(`\n📊 Trending Topics in m/${submolt}\n`));
+      topics.forEach((t, i) => {
+        console.log(`${i + 1}. ${chalk.yellow(t.word)} (score: ${t.engagement})`);
+      });
+      console.log();
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+    }
+  });
+
+program
+  .command('optimal [submolt]')
+  .description('Find optimal posting time')
+  .action(async (submolt = 'builds') => {
+    try {
+      const posts = await analytics.getTrending(submolt, 30);
+      const timing = analytics.analyzeOptimalTime(posts);
+      
+      console.log(chalk.cyan(`\n⏰ Optimal Posting Time\n`));
+      console.log(`Best hour: ${chalk.yellow(timing.bestTime)}`);
+      console.log(`(Posts at this time get highest engagement)\n`);
+    } catch (err) {
+      console.error(chalk.red(`Error: ${err.message}`));
+    }
+  });
+
+program.parse(process.argv);

package/lib/index.js

@@ -0,0 +1,74 @@
+class MoltbookAnalytics {
+  constructor(apiKey) {
+    this.apiKey = apiKey;
+    this.baseUrl = 'https://www.moltbook.com/api/v1';
+  }
+
+  // Get trending posts
+  async getTrending(submolt = 'builds', limit = 10) {
+    try {
+      const res = await fetch(`${this.baseUrl}/feed?submolt=${submolt}&sort=hot&limit=${limit}`, {
+        headers: { 'Authorization': `Bearer ${this.apiKey}` }
+      });
+      const data = await res.json();
+      return data.posts || [];
+    } catch (err) {
+      throw new Error(`Failed to fetch trending: ${err.message}`);
+    }
+  }
+
+  // Analyze post performance
+  analyzePost(post) {
+    const engagement = post.upvotes + (post.comment_count || 0) * 2;
+    const engagement_rate = engagement > 100 ? 'high' : engagement > 50 ? 'medium' : 'low';
+    
+    return {
+      title: post.title,
+      upvotes: post.upvotes,
+      comments: post.comment_count || 0,
+      engagement_score: engagement,
+      engagement_rate,
+      author: post.author.name,
+      age_hours: Math.round((Date.now() - new Date(post.created_at)) / (1000 * 60 * 60))
+    };
+  }
+
+  // Get optimal posting time (stub for API expansion)
+  analyzeOptimalTime(posts) {
+    const times = posts.map(p => new Date(p.created_at).getHours());
+    const avgEngagement = {};
+    
+    times.forEach((h, i) => {
+      avgEngagement[h] = (avgEngagement[h] || 0) + posts[i].upvotes;
+    });
+
+    const best = Object.entries(avgEngagement)
+      .sort((a, b) => b[1] - a[1])[0];
+
+    return {
+      bestHour: best ? parseInt(best[0]) : 12,
+      bestTime: best ? `${best[0]}:00 UTC` : 'noon UTC'
+    };
+  }
+
+  // Keyword frequency (what topics trend)
+  getTrendingTopics(posts, limit = 10) {
+    const words = {};
+    const stopwords = ['the', 'a', 'is', 'to', 'and', 'in', 'of', 'for', 'with', 'that'];
+
+    posts.forEach(p => {
+      p.title.toLowerCase().split(/\s+/).forEach(word => {
+        if (word.length > 4 && !stopwords.includes(word)) {
+          words[word] = (words[word] || 0) + p.upvotes;
+        }
+      });
+    });
+
+    return Object.entries(words)
+      .sort((a, b) => b[1] - a[1])
+      .slice(0, limit)
+      .map(([word, score]) => ({ word, engagement: score }));
+  }
+}
+
+module.exports = { MoltbookAnalytics };

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@bagalobsta/moltbook-analytics",
+  "version": "1.0.0",
+  "description": "Analytics for Moltbook. Track post performance, trending topics, optimal posting times.",
+  "main": "lib/index.js",
+  "bin": {
+    "moltanalytics": "bin/analytics.js"
+  },
+  "scripts": {
+    "test": "echo 'ready'"
+  },
+  "keywords": [
+    "moltbook",
+    "analytics",
+    "social",
+    "posts",
+    "engagement"
+  ],
+  "author": "Bagalobsta <bagalobsta@protonmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bagalobsta/moltbook-analytics.git"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}