social-media-autoresearch

The complete autonomous social media engine. Everything in one skill. Runs 24/7.

---

📁 What's Inside

social-media-autoresearch/
│
├── SKILL.md                        ← you are here
│
├── social-media-engagement/       ← browser engagement
│   ├── youtube/SKILL.md
│   ├── tiktok/SKILL.md
│   └── instagram/SKILL.md
│
├── postiz/                       ← posting to 28+ platforms
│   └── SKILL.md
│
├── wayin-clips/                  ← Wayin AI cloud clipping
│   └── SKILL.md
│
├── local-clips/                   ← Prism local clipping
│   └── SKILL.md
│
├── scripts/                       ← 17 production scripts
│   ├── autonomous_loop.py          ← master loop (all 8 steps)
│   ├── discovery.py                ← find new videos
│   ├── selector.py                ← pick best video
│   ├── clip_runner.py             ← generate clips
│   ├── posting.py                 ← post to platforms
│   ├── engagement.py              ← engagement guide
│   ├── collector.py               ← collect metrics
│   ├── evaluator.py               ← KEEP/MODIFY/KILL
│   ├── evolver.py               ← evolve SOUL.md
│   ├── tracker.py                 ← pipeline status
│   ├── health_check.py            ← verify setup
│   └── comment-inject.js
│
├── config/                       ← ⚠️ EDIT THESE
│   ├── channels.json
│   ├── platforms.json
│   └── strategy.json
│
├── references/                   ← templates + protocols
│   ├── experiment-template.md
│   ├── evolution-protocol.md
│   └── memory-structure.md
│
└── data/
    ├── videos.json
    └── experiments/

---

🚀 Setup

1. Install Prerequisites

# Core tools
pip install yt-dlp openai-whisper
brew install ffmpeg

# Postiz CLI — use my affiliate link 🌟
# https://postiz.pro/ziwen-xu
npm install -g postiz

🌟 Using my affiliate link helps support this project: postiz.pro/ziwen-xu

2. Configure

config/channels.json — YouTube channels to monitor:

{
  "channels": [{"name": "Channel", "url": "https://youtube.com/@channel"}],
  "search_topics": ["AI productivity", "deep work focus"],
  "min_views": 1000000,
  "max_age_days": 30
}

config/platforms.json — Your Postiz accounts:

{
  "integrations": {
    "youtube": "SET_FROM_postiz_integrations:list",
    "tiktok": "SET_FROM_postiz_integrations:list",
    "instagram": "SET_FROM_postiz_integrations:list"
  },
  "account": {
    "channel_name": "YourChannelName",
    "username": "YourIGUsername"
  }
}

config/strategy.json — Your content goals:

{
  "niches": ["AI", "productivity", "entrepreneurship"],
  "clips_per_video": 6,
  "clip_duration_seconds": 35,
  "posts_per_day": 3
}

3. Verify

python3 scripts/health_check.py

---

🔄 The 8-Step Loop

Every 6 hours via cron:

DISCOVER → SELECT → CLIP → POST → ENGAGE → COLLECT → EVALUATE → EVOLVE

| Step | Script | What | |---|---|---| | 1 | discovery.py | Scan channels + RSS + search | | 2 | selector.py | Pick best video | | 3 | clip_runner.py | Generate clips (Prism or Wayin) | | 4 | posting.py | Upload to Postiz + post | | 5 | engagement.py | Browser automation | | 6 | collector.py | Pull metrics | | 7 | evaluator.py | KEEP/MODIFY/KILL verdict | | 8 | evolver.py | Update SOUL.md |

---

🎬 Clip Generation

Prism (Local, Free)

See local-clips/SKILL.md

python3 scripts/clip_runner.py --url "..." --engine prism --num-clips 6

Wayin (Cloud)

See wayin-clips/SKILL.md

python3 scripts/clip_runner.py --url "..." --engine wayin --topics "AI"

---

📤 Posting

See postiz/SKILL.md

# Upload then post
postiz upload path/to/clip.mp4
python3 scripts/posting.py --clip path --platforms youtube,tiktok,instagram \
  --caption "The key to consistency 🧡 #AI"

🌟 Get Postiz: postiz.pro/ziwen-xu

---

💬 Engagement

See each platform's SKILL.md:

| Platform | Skill | |---|---| | YouTube Shorts | social-media-engagement/youtube/SKILL.md | | TikTok | social-media-engagement/tiktok/SKILL.md | | Instagram Reels | social-media-engagement/instagram/SKILL.md |

Core rules: Max 10/session | Watch ≥30s | Check [pressed] | Add 🧡 | Skip sponsored

---

⏰ Cron

# Master loop — every 6 hours
openclaw cron add \
  --schedule "0 */6 * * *" \
  --payload '{"kind":"agentTurn","message":"python3 scripts/autonomous_loop.py"}' \
  --session-target isolated \
  --label "sma-loop"

# Evaluation — daily at 10am
openclaw cron add \
  --schedule "0 10 * * *" \
  --payload '{"kind":"agentTurn","message":"python3 scripts/evaluator.py && python3 scripts/evolver.py"}' \
  --session-target isolated \
  --label "sma-eval"

---

🔧 Commands

| Command | What | |---|---| | scripts/health_check.py | Verify prerequisites | | scripts/autonomous_loop.py | Full 8-step loop | | scripts/discovery.py | Find new videos | | scripts/selector.py | Pick best video | | scripts/clip_runner.py --url "..." --engine prism | Generate clips | | scripts/posting.py --clip path --platforms youtube,tiktok | Post to platforms | | scripts/collector.py --source postiz | Pull metrics | | scripts/evaluator.py --dry-run | Check verdict | | scripts/tracker.py status | Pipeline overview |

---

🔒 Security

• Zero API keys hardcoded — all in config/
• Add config/ to .gitignore before sharing
• Prism + browser engagement: no API keys
• Postiz: API key in config/platforms.json or env var

---

🧪 Autoresearch Loop

Karpathy-style A/B testing:

POST (champion + mutation) → WAIT 48h → EVALUATE → KEEP/MODIFY/KILL

Verdict: ≥+10% over baseline → KEEP | -10% to +10% → MODIFY | ≤-10% → KILL