Skip to content
Back to search

social-bot

Reddit & X auto-reply bot — browser-based, Claude AI generated replies for Solvea/VOC.ai

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mguozhen--social-bot/badge.svg)](/listings/mguozhen--social-bot)

HTML

<a href="/listings/mguozhen--social-bot"><img src="/api/listings/mguozhen--social-bot/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Option 1: One-Line Install

curl -fsSL https://raw.githubusercontent.com/mguozhen/social-bot/main/install.sh | bash

This will: 1. Clone the repo to `~/social-bot` 2. Install Python dependencies (`anthropic`, `flask`) 3. Check for `browse` CLI 4. Guide you through `.env` setup 5. Initialize SQLite database 6. Register macOS LaunchAgent (daily 10:05 AM)

Option 2: Manual Setup

git clone https://github.com/mguozhen/social-bot.git ~/social-bot
cd ~/social-bot
pip3 install -r requirements.txt
cp .env.template .env
# Edit .env with your ANTHROPIC_API_KEY

Prerequisites

| Requirement | How to Get It | |------------|---------------| | Python 3.9+ | Pre-installed on macOS | | `browse` CLI | `npm install -g @anthropic-ai/browse-cli` | | Anthropic API Key | [console.anthropic.com](https://console.anthropic.com) | | Reddit account | Log in once in the browse-controlled Chrome | | X/Twitter account | Log in once in the browse-controlled Chrome |

> **No Reddit API key or Twitter API key required.** The bot uses browser sessions, not platform APIs.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 61 lines · 1 finding marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: social-reply-bot
  3. description: "Reddit & X/Twitter auto-reply bot for ecommerce/SaaS growth. Finds relevant posts about AI customer service, Amazon FBA, Shopify — posts genuine AI-generated replies mentioning your product. Includes Reddit account warmup (karma building) and lead tracking. Triggers: social reply bot, reddit auto reply, twitter auto reply, x auto reply, social media bot, amazon seller engagement, ecommerce social engagement, reddit warmup, karma building, warmup reddit, social leads, potential customers"
  4. allowed-tools: Bash
  5. metadata:
  6. openclaw:
  7. homepage: https://github.com/mguozhen/social-bot
  8. ---
  9. # Social Reply Bot
  10. Automatically finds and replies to relevant Reddit and X/Twitter posts about ecommerce, Amazon FBA, and AI customer service. Also builds Reddit account karma and tracks potential customer leads.
  11. ## Commands
  12. ```
  13. social reply bot # run both platforms
  14. social reply bot x only # X/Twitter only
  15. social reply bot reddit only # Reddit only
  16. social reply bot warmup # build Reddit karma (8 comments)
  17. social reply bot warmup 15 # warmup with custom target
  18. social reply bot leads # show potential customers found
  19. social reply bot stats # today's stats
  20. social reply bot dashboard # open web dashboard
  21. ```
  22. ## Setup
  23. ```bash
  24. curl -fsSL https://raw.githubusercontent.com/mguozhen/social-bot/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 30 on GitHub
  25. ```
  26. ## Requirements
  27. - `browse` CLI: `npm install -g @browserbasehq/browse-cli`
  28. - Log in to Reddit and X in the browse-controlled Chrome window
  29. - `ANTHROPIC_API_KEY` in `.env`
  30. ## Features
  31. ### Daily Reply Bot
  32. - Searches subreddits and X for posts matching your product keywords
  33. - Claude generates genuine, on-topic replies (not spam)
  34. - Browser automation — no Reddit/X API key needed
  35. - SQLite deduplication — never replies to the same post twice
  36. ### Reddit Warmup (karma building)
  37. - Visits low-moderation subreddits (r/karma, r/CasualConversation, r/self)
  38. - Claude Haiku generates authentic short comments (no product mentions)
  39. - Natural delays between posts (90–180s)
  40. - Builds Comment Karma to unlock restricted subreddits
  41. ### Lead Tracking
  42. - Every replied post analyzed by Claude for customer potential
  43. - Scored 1–10 with urgency level
  44. - Extracts business type and pain points
  45. - View with: `social reply bot leads`
  46. ## Configuration
  47. Edit `~/social-bot/config.json` to set your subreddits, X search queries, product descriptions, and daily targets.
README.md · README · 334 lines · 1 finding marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="https://cdn-icons-png.flaticon.com/512/4712/4712027.png" width="80" alt="Social Bot">
  3. </p>
  4. <h1 align="center">Social Reply Bot</h1>
  5. <p align="center">
  6. <strong>AI-powered Reddit & X auto-reply bot that finds your customers and joins the conversation.</strong>
  7. </p>
  8. <p align="center">
  9. <a href="#quick-start"><img src="https://img.shields.io/badge/setup-5min-brightgreen?style=flat-square" alt="5min Setup"></a>
  10. <a href="https://agentskills.io"><img src="https://img.shields.io/badge/Agent%20Skills-compatible-blue?style=flat-square" alt="Agent Skills"></a>
  11. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="MIT License"></a>
  12. <img src="https://img.shields.io/badge/python-3.9+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python 3.9+">
  13. <img src="https://img.shields.io/badge/platforms-Reddit%20%2B%20X-FF4500?style=flat-square" alt="Reddit + X">
  14. </p>
  15. <p align="center">
  16. <a href="#quick-start">Quick Start</a> &bull;
  17. <a href="#how-it-works">How It Works</a> &bull;
  18. <a href="#features">Features</a> &bull;
  19. <a href="#screenshots">Screenshots</a> &bull;
  20. <a href="#configuration">Configuration</a> &bull;
  21. <a href="#architecture">Architecture</a>
  22. </p>
  23. ---
  24. ## What is this?
  25. **Social Reply Bot** searches Reddit and X/Twitter for posts relevant to your product, then uses Claude AI to generate genuine, helpful replies that naturally mention your brand. No API keys for Reddit or X required — it uses browser automation to act like a real user.
  26. **Not spam.** The AI evaluates every post for relevance first. If a post isn't a good fit, it skips it. When it does reply, it sounds like an experienced practitioner sharing real insight — because that's what the prompt engineers it to be.
  27. Currently configured for two products:
  28. - **[Solvea](https://solvea.cx)** — AI customer service agent for Amazon/Shopify sellers
  29. - **[VOC.ai](https://voc.ai)** — Amazon review intelligence and sentiment analysis
  30. But it's fully configurable for any product/niche via `config.json`.
  31. ## Features
  32. | Feature | Description |
  33. |---------|-------------|
  34. | **Dual Platform** | Reddit (subreddit search) + X/Twitter (keyword search) |
  35. | **AI-Generated Replies** | Claude crafts genuine, on-topic responses — not templates |
  36. | **Smart Filtering** | Two-layer filter: keyword match first, then AI relevance check |
  37. | **Browser Automation** | No platform API keys needed — uses real browser sessions |
  38. | **Reddit Warmup** | Karma-building mode for new accounts (safe subreddits, no product mentions) |
  39. | **Lead Tracking** | Every replied post scored 1-10 for customer potential |
  40. | **Web Dashboard** | Real-time Flask dashboard showing daily progress |
  41. | **Deduplication** | SQLite-backed — never replies to the same post twice |
  42. | **Rate Limiting** | Configurable delays (Reddit: 10min, X: 5min between replies) |
  43. | **Daily Scheduling** | macOS LaunchAgent runs at 10:05 AM automatically |
  44. ## How It Works
  45. ```
  46. Keyword Search (Reddit subreddits + X queries)
  47. ↓
  48. Two-Layer Relevance Filter
  49. ├─ Layer 1: Keyword match (zero API cost)
  50. └─ Layer 2: Claude AI judges if post is worth replying to
  51. ↓
  52. Claude generates reply as "experienced seller sharing real insight"
  53. ↓
  54. Browser automation posts the reply
  55. ↓
  56. SQLite logs it → Dashboard displays it → Lead scored
  57. ```
  58. **The core principle:** Every reply must provide genuine value. The AI is prompted as a "seller with 5 years of experience" who naturally mentions tools they use — not as a marketer pushing a product. Posts that don't fit get skipped, not force-fitted.
  59. ## Screenshots
  60. ### Dashboard — Real-time Daily Progress
  61. <p align="center">
  62. <img src="docs/screenshot_dashboard.png" width="700" alt="Dashboard showing daily reply targets and progress">
  63. </p>
  64. The web dashboard tracks daily X posts, Reddit comments, product mentions, and historical totals.
  65. ### X/Twitter — Targeted Competitive Replies
  66. <p align="center">
  67. <img src="docs/screenshot_x_reply.png" width="700" alt="AI-generated reply on X to a competitor's post">
  68. </p>
  69. The bot found a competitor's tweet about customer support automation and replied with a genuine insight that naturally positioned Solvea as an alternative. No "Great product!" fluff — real technical substance.
  70. ### Reddit — High-Quality Community Comments
  71. <p align="center">
  72. <img src="docs/screenshot_reddit_reply.png" width="700" alt="AI-generated Reddit comment about WooCommerce chatbot issues">
  73. </p>
  74. On r/ecommerce, a user discussed WooCommerce chatbot inventory sync issues. The bot shared specific technical experience (event-triggered vs. scheduled sync), earning genuine upvotes and discussion.
  75. ## Quick Start
  76. ### Option 1: One-Line Install
  77. ```bash
  78. curl -fsSL https://raw.githubusercontent.com/mguozhen/social-bot/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 106 on GitHub
  79. ```
  80. This will:
  81. 1. Clone the repo to `~/social-bot`
  82. 2. Install Python dependencies (`anthropic`, `flask`)
  83. 3. Check for `browse` CLI
  84. 4. Guide you through `.env` setup
  85. 5. Initialize SQLite database
  86. 6. Register macOS LaunchAgent (daily 10:05 AM)
  87. ### Option 2: Manual Setup
  88. ```bash
  89. git clone https://github.com/mguozhen/social-bot.git ~/social-bot
  90. cd ~/social-bot
  91. pip3 install -r requirements.txt
  92. cp .env.template .env
  93. # Edit .env with your ANTHROPIC_API_KEY
  94. ```
  95. ### Prerequisites
  96. | Requirement | How to Get It |
  97. |------------|---------------|
  98. | Python 3.9+ | Pre-installed on macOS |
  99. | `browse` CLI | `npm install -g @anthropic-ai/browse-cli` |
  100. | Anthropic API Key | [console.anthropic.com](https://console.anthropic.com) |
  101. | Reddit account | Log in once in the browse-controlled Chrome |
  102. | X/Twitter account | Log in once in the browse-controlled Chrome |
  103. > **No Reddit API key or Twitter API key required.** The bot uses browser sessions, not platform APIs.
  104. ## Commands
  105. ### As Claude Code Skill
  106. Once installed as a skill, just tell Claude:
  107. ```
  108. social reply bot # run both platforms
  109. social reply bot x only # X/Twitter only
  110. social reply bot reddit only # Reddit only
  111. social reply bot warmup # build Reddit karma (8 comments)
  112. social reply bot warmup 15 # warmup with custom target
  113. social reply bot leads # show potential customers found
  114. social reply bot stats # today's stats
  115. social reply bot dashboard # open web dashboard
  116. ```
  117. ### As Standalone Script
  118. ```bash
  119. python3 run_daily.py # run both platforms
  120. python3 run_daily.py --x-only # X only
  121. python3 run_daily.py --reddit-only # Reddit only
  122. python3 warmup_reddit.py # karma building mode
  123. ```
  124. ## Configuration
  125. Edit `config.json` to customize for your product:
  126. ```json
  127. {
  128. "x": {
  129. "username": "@YourAccount",
  130. "daily_target": 20,
  131. "min_delay_seconds": 300,
  132. "search_queries": [
  133. "your product keyword 1",
  134. "your product keyword 2"
  135. ]
  136. },
  137. "reddit": {
  138. "username": "your_reddit_user",
  139. "daily_target": 10,
  140. "min_delay_seconds": 600,
  141. "subreddits": ["YourTargetSubreddit", "AnotherOne"]
  142. },
  143. "products": {
  144. "YourProduct": {
  145. "description": "What your product does (AI uses this to craft mentions)",
  146. "trigger_keywords": ["keyword1", "keyword2"]
  147. }
  148. },
  149. "reply_style": {
  150. "tone": "knowledgeable practitioner sharing experience",
  151. "max_length_x": 260,
  152. "max_length_reddit": 400,
  153. "rules": [
  154. "Lead with genuine insight about the post",
  155. "Mention product as 'what we use/built' — not as an ad",
  156. "Skip if not relevant — never force a mention"
  157. ]
  158. }
  159. }
  160. ```
  161. ### Environment Variables
  162. | Variable | Required | Description |
  163. |----------|----------|-------------|
  164. | `ANTHROPIC_API_KEY` | Yes | Claude API key for reply generation |
  165. | `BROWSERBASE_API_KEY` | No | Optional: persistent browser sessions across reboots |
  166. | `BROWSERBASE_PROJECT_ID` | No | Optional: pairs with Browserbase key |
  167. ## Architecture
  168. ```
  169. social-bot/
  170. ├── bot/
  171. │ ├── ai_engine.py # Claude AI: relevance filter + reply generation
  172. │ ├── browser.py # Browser automation via browse CLI
  173. │ ├── db.py # SQLite: dedup, history, lead scoring
  174. │ ├── reddit_bot.py # Reddit: search subreddits, post comments
  175. │ └── x_bot.py # X/Twitter: search queries, post replies
  176. ├── dashboard/
  177. │ ├── app.py # Flask web dashboard
  178. │ └── templates/ # Dashboard HTML
  179. ├── docs/
  180. │ ├── screenshot_dashboard.png
  181. │ ├── screenshot_reddit_reply.png
  182. │ └── screenshot_x_reply.png
  183. ├── launchd/ # macOS LaunchAgent plist
  184. ├── config.json # Platform targets, keywords, products
  185. ├── run_daily.py # Main entry point (scheduled daily)
  186. ├── warmup_reddit.py # Reddit karma builder
  187. ├── install.sh # One-line installer
  188. ├── setup.sh # Manual setup helper
  189. ├── SKILL.md # Claude Code / Agent Skills definition
  190. └── .env.template # Credential template
  191. ```
  192. ### Two-Layer Filtering
  193. ```python
  194. # Layer 1: Fast keyword match (zero API cost)
  195. def detect_product(text: str) -> Optional[str]:
  196. # Returns matching product name or None
  197. # Layer 2: Claude AI relevance check
  198. # If Layer 1 matches, Claude decides:
  199. # - Is this post genuinely relevant?
  200. # - Can we add real value with a reply?
  201. # - SKIP if forcing a mention would feel unnatural
  202. ```
  203. ### Rate Limiting & Safety
  204. | Platform | Delay Between Replies | Daily Cap | Deduplication |
  205. |----------|----------------------|-----------|---------------|
  206. | Reddit | 10 minutes | 10 posts | SQLite (URL-based) |
  207. | X/Twitter | 5 minutes | 20 posts | SQLite (URL-based) |
  208. ## Reddit Warmup
  209. New Reddit accounts need karma before posting in restricted subreddits. The warmup mode:
  210. - Visits safe, low-moderation subreddits (r/karma, r/CasualConversation, r/self)
  211. - Claude Haiku generates authentic short comments (no product mentions)
  212. - 90-180 second natural delays between posts
  213. - Default: 8 comments per session, configurable
  214. ```bash
  215. python3 warmup_reddit.py # default 8 comments
  216. python3 warmup_reddit.py --target 15 # custom target
  217. ```
  218. ## Expected Results
  219. With default settings (X: 20/day, Reddit: 10/day):
  220. | Metric | Monthly |
  221. |--------|---------|
  222. | Posts covered | 600+ targeted posts |
  223. | Users reached | 600+ people actively discussing your niche |
  224. | Click-through | ~10-15% visit your profile/link |
  225. | Cost | ~$0.30/day (Claude API at ~$0.01/reply) |
  226. This isn't viral growth — it's **consistent, targeted brand presence** in conversations where your product is genuinely relevant.
  227. ## Known Limitations
  228. | Issue | Cause | Workaround |
  229. |-------|-------|------------|
  230. | Reddit comments auto-removed | Account karma < 10 or age < 10 days | Run `warmup` mode for 1-2 weeks first |
  231. | Some X replies fail | Page structure changes or rate limits | Auto-retry with backoff, skips on persistent failure |
  232. | Low match rate on some days | Today's posts don't match your keywords | Add more subreddits and search queries |
  233. ## FAQ
  234. <details>
  235. <summary><strong>Is this against Reddit/X terms of service?</strong></summary>
  236. This tool uses browser automation (not API abuse) and generates unique, contextually relevant responses (not spam). However, automated posting always carries platform risk. Use responsibly, keep daily volumes reasonable, and ensure your replies genuinely add value to conversations.
  237. </details>
  238. <details>
  239. <summary><strong>How do I add my own product?</strong></summary>
  240. Edit the `products` section in `config.json`. Add your product name, description (used by Claude to craft natural mentions), and trigger keywords. Then update `search_queries` and `subreddits` to target where your audience hangs out.
  241. </details>
  242. <details>
  243. <summary><strong>Can I use this without Claude Code?</strong></summary>
  244. Yes. `run_daily.py` is a standalone script. You just need Python 3.9+, the `browse` CLI, and an Anthropic API key. The Claude Code skill integration is optional.
  245. </details>
  246. <details>
  247. <summary><strong>How much does it cost to run?</strong></summary>
  248. About $0.01 per reply (Claude API). At 30 replies/day, that's roughly $9/month. Browser automation is free — no Reddit or X API fees.
  249. </details>
  250. ## Contributing
  251. PRs welcome. Please test your changes with both platforms before submitting.
  252. ## License
  253. [MIT](LICENSE)
  254. ---
  255. <p align="center">
  256. Built with <a href="https://claude.ai">Claude AI</a> &bull; Browser automation via <a href="https://www.npmjs.com/package/@anthropic-ai/browse-cli">browse CLI</a>
  257. </p>
install.sh · Bundled script · 114 lines · 1 finding marked
  1. #!/bin/bash
  2. # ============================================================
  3. # Social Reply Bot — One-command installer
  4. # Works on any macOS with Homebrew + Python 3
  5. #
  6. # Usage:
  7. # curl -fsSL https://raw.githubusercontent.com/mguozhen/social-bot/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 7 on GitHub
  8. # Or after cloning:
  9. # bash install.sh
  10. # ============================================================
  11. set -e
  12. REPO_URL="https://github.com/mguozhen/social-bot.git"
  13. INSTALL_DIR="$HOME/social-bot"
  14. PYTHON="python3"
  15. echo ""
  16. echo "╔══════════════════════════════════════╗"
  17. echo "║ Social Reply Bot Installer ║"
  18. echo "╚══════════════════════════════════════╝"
  19. echo ""
  20. # ── 1. Clone or update repo ──────────────────────────────────
  21. echo "[1/6] Getting latest code..."
  22. if [ -d "$INSTALL_DIR/.git" ]; then
  23. cd "$INSTALL_DIR"
  24. git pull --ff-only
  25. echo " Updated existing repo at $INSTALL_DIR"
  26. else
  27. git clone "$REPO_URL" "$INSTALL_DIR"
  28. echo " Cloned to $INSTALL_DIR"
  29. fi
  30. cd "$INSTALL_DIR"
  31. # ── 2. Python dependencies ───────────────────────────────────
  32. echo "[2/6] Installing Python packages..."
  33. $PYTHON -m pip install -r requirements.txt --quiet
  34. echo " Done: anthropic, flask, flask-cors, python-dotenv"
  35. # ── 3. browse CLI ────────────────────────────────────────────
  36. echo "[3/6] Checking browse CLI..."
  37. if ! command -v browse &>/dev/null; then
  38. if command -v npm &>/dev/null; then
  39. npm install -g @browserbasehq/browse-cli --silent
  40. echo " Installed browse CLI"
  41. else
  42. echo " WARNING: npm not found. Install Node.js then run:"
  43. echo " npm install -g @browserbasehq/browse-cli"
  44. fi
  45. else
  46. echo " browse CLI already installed ($(browse --version 2>/dev/null || echo 'ok'))"
  47. fi
  48. # ── 4. .env file ─────────────────────────────────────────────
  49. echo "[4/6] Setting up credentials..."
  50. if [ ! -f "$INSTALL_DIR/.env" ]; then
  51. cp "$INSTALL_DIR/.env.template" "$INSTALL_DIR/.env"
  52. echo ""
  53. echo " ┌─────────────────────────────────────────────┐"
  54. echo " │ ACTION REQUIRED: Add your API key │"
  55. echo " │ │"
  56. echo " │ nano $INSTALL_DIR/.env │"
  57. echo " │ Set: ANTHROPIC_API_KEY=sk-ant-... │"
  58. echo " └─────────────────────────────────────────────┘"
  59. echo ""
  60. read -p " Press Enter after editing .env to continue..." _
  61. else
  62. echo " .env already configured"
  63. fi
  64. # ── 5. Database init ─────────────────────────────────────────
  65. echo "[5/6] Initializing database..."
  66. $PYTHON -c "
  67. import sys; sys.path.insert(0, '$INSTALL_DIR')
  68. from bot.db import init_db; init_db()
  69. print(' DB ready: $INSTALL_DIR/logs/social_bot.db')
  70. "
  71. # ── 6. LaunchAgent ───────────────────────────────────────────
  72. echo "[6/6] Installing LaunchAgent (daily 10:05 AM)..."
  73. PLIST_SRC="$INSTALL_DIR/launchd/com.socialbot.daily.plist"
  74. PLIST_DST="$HOME/Library/LaunchAgents/com.socialbot.daily.plist"
  75. mkdir -p "$HOME/Library/LaunchAgents"
  76. # Inject real python3 path and API key
  77. PYTHON_PATH="$(which $PYTHON)"
  78. API_KEY="$(grep ANTHROPIC_API_KEY "$INSTALL_DIR/.env" | cut -d= -f2 | tr -d ' ')"
  79. sed \
  80. -e "s|/usr/bin/python3|$PYTHON_PATH|g" \
  81. -e "s|FILL_IN|$API_KEY|g" \
  82. -e "s|/Users/guozhen|$HOME|g" \
  83. "$PLIST_SRC" > "$PLIST_DST"
  84. launchctl unload "$PLIST_DST" 2>/dev/null || true
  85. launchctl load "$PLIST_DST"
  86. echo " LaunchAgent loaded — will run daily at 10:05 AM"
  87. # ── Done ─────────────────────────────────────────────────────
  88. echo ""
  89. echo "╔══════════════════════════════════════════════════════╗"
  90. echo "║ Installation complete! ║"
  91. echo "║ ║"
  92. echo "║ Next steps: ║"
  93. echo "║ 1. Open browser and log in to Reddit + X manually ║"
  94. echo "║ (just visit the sites — sessions are shared) ║"
  95. echo "║ 2. Test run: ║"
  96. echo "║ cd $HOME/social-bot ║"
  97. echo "║ python3 run_daily.py --x-only ║"
  98. echo "║ 3. Dashboard: python3 dashboard/app.py ║"
  99. echo "║ Open: http://localhost:5050 ║"
  100. echo "╚══════════════════════════════════════════════════════╝"
  101. echo ""

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.