social-media-autoresearch
# 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
```bash
# 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](https://postiz.pro/ziwen-xu)
### 2. Configure
**config/channels.json** — YouTube channels to monitor:
```json
{
"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:
```json
{
"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:
```json
{
"niches": ["AI", "productivity", "entrepreneurship"],
"clips_per_video": 6,
"clip_duration_seconds": 35,
"posts_per_day": 3
}
```
### 3. Verify
```bash
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`
```bash
python3 scripts/clip_runner.py --url "..." --engine prism --num-clips 6
```
### Wayin (Cloud)
See `wayin-clips/SKILL.md`
```bash
python3 scripts/clip_runner.py --url "..." --engine wayin --topics "AI"
```
---
## 📤 Posting
See `postiz/SKILL.md`
```bash
# 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](https://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
```bash
# 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
标签
skill
ai
