Skip to content

dcecchino/socialconductor-skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SocialConductor Skills for Claude & OpenClaw

Control your SocialConductor.AI comment automation bots directly from Claude or any OpenClaw-connected chat app. After a one-time 30-second browser setup per platform, all bot control and reply posting runs fully server-side — no ongoing browser access needed.

What is SocialConductor?

SocialConductor is an AI-powered comment automation SaaS for TikTok, YouTube, and Facebook/Instagram creators and businesses. The AI reads each comment, understands your video and post context, and posts intelligent replies automatically — 24/7. Built on Google Vertex AI (Gemini), it learns your voice, detects leads, avoids spam, and handles everything from casual engagement to business inquiries.

Supported Platforms

Platform Status Dashboard
👥 Facebook / Instagram ✅ Live podium.socialconductor.ai
📺 YouTube ✅ Live studio.socialconductor.ai
🎵 TikTok ✅ Live violin.socialconductor.ai

📱 iOS App

Manage your bots natively from your iPhone — the full platform in your pocket.

Download SocialConductor on the App Store

  • Unified dashboard for Facebook/Instagram, YouTube, and TikTok
  • Real-time comment logs, leads, and reply management
  • AI Insights and analytics with enhanced graphs
  • Chat history with context and reply viewer
  • Live streaming support across all three platforms
  • Push notifications for new comments and replies
  • Multiple themes: Glass, AMOLED, Dark Pro, Slate Clean
  • Demo mode to evaluate features before connecting accounts

Install (Claude Code Plugin)

claude plugin marketplace add https://github.com/dcecchino/socialconductor-skills
claude plugin install socialconductor-plugin@socialconductor-skills

Install (OpenClaw / ClawHub)

clawhub install socialconductor-skill

Getting Started

1. Sign up

Create your account at socialconductor.ai.

2. Get your API key(s)

Get your SocialConductor-issued API key(s) from your account settings on each platform dashboard. These are not your Meta, Google, or TikTok passwords — they are keys generated by SocialConductor.

3. Set your environment variables

export SC_FB_API_KEY=your_facebook_key       # Facebook / Instagram
export SC_YT_API_KEY=your_youtube_key        # YouTube
export SC_TIKTOK_API_KEY=your_tiktok_key     # TikTok

You only need keys for the platforms you use.

4. Connect your accounts

Say the connect command for each platform:

connect my facebook page
connect my youtube channel
connect my tiktok account

Facebook/Instagram: Requires a Facebook Business or Professional Creator Page. Personal profiles will not work.

Facebook ToS: Before the bot can post live replies, you must accept terms at https://podium.socialconductor.ai/terms. Until then, the bot runs in simulation mode.

TikTok: Works with any standard creator account. Setup uses a QR code — the link expires in 15 minutes.

New accounts get a 7-day free trial with up to 30 AI replies per day.


Cross-Platform Commands

These work on all three platforms. Replace [platform] with facebook, youtube, or tiktok.

Bot Control

Command What happens
check my [platform] bot Mode, plan, trial status, daily usage, last 3 replies
pause my [platform] bot Hold ON — AI replies stop immediately
resume my [platform] bot Hold OFF — AI replies resume
enable [platform] bot Turns on auto-reply
disable [platform] bot Turns off auto-reply
[platform] simulation mode on Replies generated but not posted
[platform] simulation mode off Bot posts for real

Comment Logs & Leads

Command What happens
show recent [platform] comments Last 5 log entries
show posted [platform] comments Only successfully posted replies
show [platform] skipped comments Comments filtered by gates
show [platform] leads Lead-flagged comments (price, buy, how much…)
show comment detail for [id] on [platform] Full context, vibe, gate details

Replies

Command What happens
reply to [platform] comment [id] saying [text] Post a manual reply
regenerate [platform] reply for comment [id] Re-run AI with current settings

Drafts & Approvals

Command What happens
show my [platform] pending drafts View pending AI replies awaiting approval
approve all pending [platform] drafts Bulk approve all pending AI replies

Analytics & Insights

Command What happens
show my [platform] daily analytics Daily stats, reply counts, trends
show [platform] performance insights Gemini-powered page performance summary
show [platform] enhanced analytics Deep engagement and quality metrics
show [platform] sentiment trend Daily sentiment breakdown over last 30 days
show [platform] ab stats A/B prompt variant performance comparison
show [platform] ai insights AI-generated performance insights via Gemini
show commenter profile for @username on [platform] Full 90-day commenter history

AI Teaching & Prompts

Command What happens
show [platform] teaching examples View star (good) and bad example lists
add this comment to [platform] teaching examples Train the AI on your preferred tone
show [platform] prompt View current A/B system prompts
update [platform] prompt Update system prompt A and/or B
generate [platform] magic prompt Auto-generate prompt from your page profile
show [platform] advanced settings View all advanced AI configuration
update [platform] advanced settings Update one or more advanced settings

Scheduling & Tools

Command What happens
show my [platform] friends list View friends / subscribed channels
turn on [platform] vacation mode Configure away mode scheduling
open the [platform] viral vault View top-performing viral comment examples
register push token for [platform] Register device for push notifications

Video Management (YouTube & TikTok)

Command What happens
show my [platform] videos Video polling status
show stale [platform] videos Videos with no recent activity
reactivate [platform] video [id] Resume polling a stale video

Facebook / Instagram — Additional Commands

Command What happens
block @username Add to block list
unblock @username Remove from block list
show blocked facebook users List all blocked accounts
turn on viral intelligence Enable Reaction-Weighted Intelligence
show my facebook pages All connected pages with status and plan
show facebook security audits Prompt-injection / system-leak audit log

Facebook Reviews

Command What happens
show facebook reviews Recent business reviews
show facebook review drafts Pending AI-drafted review replies
reply to review [id] saying [text] Post or update a review reply
generate reply for review [id] AI-generate a review reply
feedback on review reply [id] Submit thumbs-up/down on a review reply
show facebook reviews analytics Review response rate and sentiment
show facebook reviews settings View/update review reply configuration

YouTube — Additional Commands

Command What happens
fast youtube response mode Sets reply delay to fast
aggressive youtube response mode Sets reply delay to aggressive
conservative youtube response mode Sets reply delay to conservative
show youtube reviews settings View/update YouTube community settings

TikTok — Additional Commands

Command What happens
block @username Add to block list
unblock @username Remove from block list
show blocked tiktok users List all blocked accounts
check tiktok reply status [job_id] Poll status of an async Playwright reply job
fast tiktok response mode Sets reply delay to fast
aggressive tiktok response mode Sets reply delay to aggressive
conservative tiktok response mode Sets reply delay to conservative

Full API Route Reference

All routes require Authorization: Bearer <SC_*_API_KEY> except /register.

Core (all platforms)

Method Route Description
POST /api/openclaw/register Register OpenClaw user, get API key
POST /api/openclaw/link_token Get one-time browser OAuth link
GET /api/openclaw/status Bot status, plan, usage, recent replies
POST /api/openclaw/hold Pause or resume AI replies
GET /api/openclaw/logs Comment activity log
POST /api/openclaw/reply Post a manual reply
POST /api/openclaw/regenerate Regenerate AI reply for a comment
GET /api/openclaw/leads Lead-flagged comments
GET /api/openclaw/videos Video polling status
POST /api/openclaw/reactivate Reactivate a stale video (YT/TT)
GET /api/openclaw/drafts Pending draft replies
POST /api/openclaw/approve_bulk Bulk approve drafts
GET,POST /api/openclaw/settings Get/update bot settings
GET,POST /api/openclaw/live_settings Get/update live-mode settings
POST /api/openclaw/register_push_token Register device push notification token
GET /api/openclaw/skill_manifest Platform API capability manifest

Analytics

Method Route Description
GET /api/openclaw/analytics Daily stats and reply counts
GET /api/openclaw/analytics/enhanced Deep engagement and quality metrics
GET /api/openclaw/insights Gemini-powered performance summary
GET /api/openclaw/ai_insights AI-generated page insights
GET /api/openclaw/ab_stats A/B prompt variant performance
GET /api/openclaw/sentiment_trend Daily sentiment breakdown
GET /api/openclaw/commenter_profile 90-day profile for a specific commenter
GET /api/openclaw/comment_detail Full context and gate info for a comment

AI Teaching & Prompts

Method Route Description
GET /api/openclaw/examples Star and bad example lists
POST /api/openclaw/teach Add a teaching example
GET,POST /api/openclaw/prompt View/update A/B system prompts
POST /api/openclaw/magic_prompt Auto-generate prompt from page profile
GET,POST /api/openclaw/advanced View/update advanced AI settings

Tools & Features

Method Route Description
GET /api/openclaw/friends Friends / subscribed channels list
POST /api/openclaw/vacation Configure vacation/away mode
GET /api/openclaw/viral_vault Top-performing viral comment examples

Facebook / Instagram Only

Method Route Description
GET /api/openclaw/pages All connected pages with status and plan
GET /api/openclaw/blocked Blocked user list
POST /api/openclaw/block Block a user
POST /api/openclaw/unblock Unblock a user
GET /api/openclaw/security_audits Prompt-injection / system-leak audit log
GET /api/openclaw/reviews Business reviews
GET /api/openclaw/reviews/drafts Pending AI-drafted review replies
POST,PUT,DELETE /api/openclaw/reviews/<id>/reply Post, update, or delete a review reply
POST /api/openclaw/reviews/<id>/generate AI-generate a review reply
POST /api/openclaw/reviews/<id>/feedback Thumbs-up/down on a review reply
GET /api/openclaw/reviews/analytics Review response rate and sentiment
GET,POST /api/openclaw/reviews/settings View/update review reply configuration

TikTok Only

Method Route Description
GET /api/openclaw/blocked Blocked user list
POST /api/openclaw/block Block a user
POST /api/openclaw/unblock Unblock a user
POST /api/openclaw/qr_start_link Start a TikTok QR login session
GET /api/openclaw/qr_poll_link Poll QR login completion status
GET /api/openclaw/reply_status/<job_id> Poll async Playwright reply job status

YouTube Only

Method Route Description
GET,POST /api/openclaw/reviews_settings YouTube community/reviews settings

Auth & Privacy

API Keys (SC_FB_API_KEY, SC_YT_API_KEY, SC_TIKTOK_API_KEY) are SocialConductor-issued keys from your dashboard — not your native Meta, Google, or TikTok credentials.

Registration: The connect command sends only a secure anonymous identifier (openclaw_user_id) to generate your one-time OAuth link. No chat history or personal data is transmitted.

Storage: Tokens are stored locally and sent as Authorization: Bearer <key>. Keys are SHA-256 hashed server-side — the plaintext is never stored remotely.

Platform Register endpoint
Facebook / Instagram https://podium.socialconductor.ai/api/openclaw/register
YouTube https://studio.socialconductor.ai/api/openclaw/register
TikTok https://violin.socialconductor.ai/api/openclaw/register

Error Reference

Error Meaning
unauthorized API key missing or invalid
trial_expired 7-day trial ended — upgrade at the platform's /upgrade page
no_page Platform not linked yet — run the connect command
terms_required ToS not accepted — visit podium.socialconductor.ai/terms
rate_limited Platform rate-limited this channel — resumes automatically
reply_failed Reply attempt failed — check dashboard for details

Support

About

AI comment automation for TikTok, YouTube, and Facebook/Instagram — manage your bots from Claude without opening a browser.

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors