[简体中文](./SKILL.zh-CN.md) | English

X2C Social Poster

Source: storyclaw-official/skills · Dashboard: x2cpool.com

Publish posts, manage comments, run analytics, send DMs, and generate AI content across 13+ social platforms via X2C Open API.

Installation Requirements

First-Time Setup Guide

Step 0: Check API Key

python3 scripts/x2c_social.py --action check-key

• Key is set → proceed to Step 1.
• Key is NOT set → guide the user:

🔑 X2C API Key is not configured yet. Let's set it up:

1. Go to https://x2creel.ai and sign up / log in
2. Click your avatar → User Center → Social Account Management
3. Click "Link Account" to authorize each social platform (X, TikTok, Instagram, etc.)
4. Go to Developer → API Keys, create a new key
5. Paste the key here and I'll save it for you

Step 1: Verify Linked Accounts

python3 scripts/x2c_social.py --action status

If no accounts are linked, guide the user:

⚠️ No social accounts linked yet. Here's how to link them:

1. Log in at https://x2creel.ai
2. Click your avatar (top-right) → User Center
3. Go to Social Account Management
4. Click "Link Account" next to each platform you want to use
   • X (Twitter): OAuth login — no API keys needed
   • TikTok / Instagram / YouTube / etc.: follow the OAuth prompts
5. Once linked, come back and I'll verify the connection.

After showing linked accounts, proactively offer:

"Want to see your account analytics (followers, trends)? I can pull them now. [Yes / Skip]"

Platform Requirements Quick Reference

⚠️ Multi-Platform Posting Caveat

When posting to multiple platforms simultaneously, the shortest character limit wins across all platforms. Use separate publish calls for different text per platform.

Commands

Existing Commands

1. Check Linked Accounts

python3 scripts/x2c_social.py --action status

2. Publish Post

# Text-only
python3 scripts/x2c_social.py --action publish \
  --platforms twitter facebook \
  --post "Hello world! 🚀"

# With local file (auto-uploaded, any size up to 5GB)
python3 scripts/x2c_social.py --action publish \
  --platforms tiktok instagram \
  --post "Watch this! 🎬" \
  --media-files /path/to/video.mp4

# With remote URL
python3 scripts/x2c_social.py --action publish \
  --platforms tiktok \
  --post "Watch this! 🎬" \
  --media-urls "https://example.com/video.mp4"

# YouTube (title auto-generated if omitted)
python3 scripts/x2c_social.py --action publish \
  --platforms youtube \
  --post "Video description here" \
  --title "My YouTube Video" \
  --visibility public \
  --media-files /path/to/video.mp4

# Reddit
python3 scripts/x2c_social.py --action publish \
  --platforms reddit \
  --post "Post body text" \
  --title "Discussion: AI in 2026" \
  --subreddit technology

# TikTok with AI content flag
python3 scripts/x2c_social.py --action publish \
  --platforms tiktok \
  --post "AI generated content" \
  --ai-generated \
  --media-files /path/to/video.mp4

# Scheduled post
python3 scripts/x2c_social.py --action publish \
  --platforms tiktok instagram \
  --post "Coming soon! ⏰" \
  --media-files /path/to/video.mp4 \
  --schedule "2026-04-01T12:00:00Z"

3. Post History

python3 scripts/x2c_social.py --action posts
python3 scripts/x2c_social.py --action posts --platform tiktok

4. Delete Post

python3 scripts/x2c_social.py --action delete-post --post-id post_abc123
python3 scripts/x2c_social.py --action delete-post --post-id post_abc123 --bulk

5–8. Comments

# Post a comment
python3 scripts/x2c_social.py --action comment \
  --post-id post_abc123 --platforms tiktok --comment "🔥"

# List comments
python3 scripts/x2c_social.py --action comments --post-id post_abc123 --platform tiktok

# Reply to a comment
python3 scripts/x2c_social.py --action reply \
  --comment-id cmt_xyz --comment "Thanks!"

# Delete a comment
python3 scripts/x2c_social.py --action delete-comment --comment-id cmt_xyz

9. Upload Media (standalone)

python3 scripts/x2c_social.py --action upload --file /path/to/file.mp4 --folder videos

New Commands (v2.0)

10. AI Post Generation

Generate platform-optimized post text from a topic or prompt.

# Basic generation
python3 scripts/x2c_social.py --action generate \
  --gen-prompt "Promote a new AI short drama episode about time loops" \
  --platform tiktok \
  --gen-hashtags \
  --gen-emojis \
  --tone energetic \
  --max-chars 2200

# For Twitter (respects 280-char limit)
python3 scripts/x2c_social.py --action generate \
  --gen-prompt "Launch announcement for X2C social tool" \
  --platform twitter \
  --gen-hashtags \
  --max-chars 280

Options: --tone accepts energetic, casual, professional, inspiring, etc. --language accepts en, zh, ja, etc.

11. Hashtag Recommendations

Get AI-ranked hashtags for a topic or post text.

python3 scripts/x2c_social.py --action hashtags \
  --text "AI generated short drama about time travel" \
  --platform instagram \
  --max-tags 10 \
  --language en

12. Auto-Schedule (Best Time)

Publish at the next optimal engagement time — no need to guess the best hour.

python3 scripts/x2c_social.py --action auto-schedule \
  --platforms tiktok instagram \
  --post "New episode is live! 🎬" \
  --media-files /path/to/video.mp4

13. Post Analytics (Published via X2C)

# Analytics for a specific post
python3 scripts/x2c_social.py --action analytics-post \
  --post-id post_abc123 \
  --platforms instagram tiktok

# With platform-native ID lookup
python3 scripts/x2c_social.py --action analytics-post \
  --post-id native_id_123 \
  --platforms youtube \
  --search-platform-id

Analytics availability notes:

• TikTok: 24–48 h delay
• Pinterest: 24–72 h delay
• Instagram: requires ≥ 100 followers
• Facebook: requires ≥ 100 page likes

14. External Post Analytics

Analytics for posts NOT published via X2C.

# By URL
python3 scripts/x2c_social.py --action analytics-social \
  --platform youtube \
  --url "https://youtube.com/watch?v=VIDEO_ID"

# By native ID
python3 scripts/x2c_social.py --action analytics-social \
  --platform tiktok \
  --ext-id "7123456789"

Supported: youtube, tiktok, instagram, facebook, twitter, linkedin.

15. Account Analytics

Followers, audience demographics, and historical trends.

# Basic account analytics
python3 scripts/x2c_social.py --action analytics-account \
  --platforms instagram youtube tiktok

# With daily trends and 60-day window
python3 scripts/x2c_social.py --action analytics-account \
  --platforms instagram \
  --daily \
  --period-60

16. Full Post History

# All platforms, last 30 days
python3 scripts/x2c_social.py --action history --last-days 30

# Specific platform, last 50 records, successful only
python3 scripts/x2c_social.py --action history \
  --platform instagram \
  --last-records 50 \
  --history-status success

17. Platform Feed / Timeline

python3 scripts/x2c_social.py --action feed \
  --platform twitter \
  --last-records 20

18. Direct Messages

# List DMs
python3 scripts/x2c_social.py --action messages --platform instagram

# Send a DM
python3 scripts/x2c_social.py --action send-message \
  --platform instagram \
  --recipient-id ig_user_id_123 \
  --message "Thanks for watching! 😊"

# Reply in a conversation
python3 scripts/x2c_social.py --action send-message \
  --platform instagram \
  --conversation-id conv_abc \
  --message "Great question!"

# DM with media
python3 scripts/x2c_social.py --action send-message \
  --platform twitter \
  --recipient-id twitter_user_id \
  --message "Check this out!" \
  --media-url "https://cdn.example.com/image.jpg"

Supported platforms: instagram, facebook, twitter.

19. Short Links with UTM Tracking

# Create a trackable short link
python3 scripts/x2c_social.py --action links \
  --link-url "https://x2creel.ai/episode/123" \
  --utm-source instagram \
  --utm-medium bio \
  --utm-campaign drama_s2

# Get click analytics for existing short link
python3 scripts/x2c_social.py --action links \
  --link-id short_link_abc123

20. Google Business Reviews

# Last 30 days of reviews
python3 scripts/x2c_social.py --action reviews --last-days 30

21. Brand Lookup

python3 scripts/x2c_social.py --action brand --domain x2creel.ai

Returns brand colors, logo, social links, and description.

Parameter Reference

Interaction Guide

This is the most important section. When handling user requests, always follow these principles:

Core Principle: Lead With a Proposal

Never ask vague questions. Always present a concrete plan based on what you already know, then let the user accept, modify, or skip.

Smart Publishing Flow

When a user wants to create a post, run through this sequence. Skip steps that the user has already covered.

Phase 1 — Onboarding (once per session)

python3 scripts/x2c_social.py --action check-key
python3 scripts/x2c_social.py --action status

Show linked platforms. After status, proactively offer:

"You're linked to: TikTok, Instagram, YouTube. Want account analytics too? [Yes / Skip]"

Phase 2 — Content Creation

If the user describes a topic but hasn't written the post yet:

python3 scripts/x2c_social.py --action generate \
  --gen-prompt "[user's topic]" \
  --platform [primary platform] \
  --gen-hashtags --gen-emojis \
  --tone [inferred from context, default: energetic] \
  --language [inferred from user language, default: en]

Present 2-3 variations (or the top result) and let the user pick or edit. Do not wait for the user to ask for AI generation — proactively offer it.

Phase 3 — Hashtag Suggestions

After the post text is confirmed, automatically run:

python3 scripts/x2c_social.py --action hashtags \
  --text "[confirmed post text]" \
  --platform [primary platform] \
  --max-tags 8

Present the top suggestions immediately:

"Suggested hashtags: #AIDrama (high) #ShortFilm (high) #TikTok (medium). Add all? [Yes / Pick some / Skip]"

If the user says "add all" or picks some, append them to the post text directly.

Phase 4 — Platform Checks

Based on the confirmed platforms:

• YouTube: confirm title (or show the auto-generated one) and visibility (public default).
• Reddit: confirm --title and --subreddit.
• Instagram/TikTok/Snapchat: remind media is required; ask for file if not provided.
• TikTok + AI content: suggest --ai-generated.

Phase 5 — Scheduling

Present the scheduling choice with auto-schedule as the recommended default:

"When should I post?
✨ Auto-schedule — I'll pick the best time for each platform (recommended)
⚡ Post now
🕐 Set a time — e.g. 2026-05-01T18:00:00Z

[Auto-schedule] [Now] [Set time]"

• If auto-schedule: use --action auto-schedule
• If specific time: use --action publish --schedule "ISO8601"
• If now: use --action publish

Phase 6 — Post-Publish Smart Offers

After a successful publish, always offer these in one compact block:

✅ Published to [platforms]! Post ID: post_abc123

Quick actions — pick any, or skip all:
🔗 Create trackable short link  → yes/no
📊 Analytics: [platform-specific timing note, e.g. "TikTok ready in ~24h"]
💬 Check/reply to comments?    → yes/no

If the post text contained a URL, auto-propose creating a short link:

"Your post includes a URL. Want me to create a trackable short link with UTM tags? I'll use utm_source=[platform] automatically. [Yes / No]"

Context-Triggered Proactive Suggestions

Run these checks based on context — no need for the user to ask:

Determine Intent (when request is vague)

What would you like to do?

📝 Create & publish a post      → Smart publishing flow (Phase 1–6 above)
🤖 Generate post ideas          → AI generation + hashtag suggestions
⏰ Auto-schedule a post         → Best-time publishing
📊 Check analytics              → Post or account analytics
💬 Manage comments/DMs          → Comments, replies, or DMs
📜 Browse post history          → Full history with filters
📤 Upload media                 → Standalone upload
🔗 Create a short link          → Link creation + UTM
⭐ Check GMB reviews            → Google Business reviews
🔍 Look up brand info           → Brand lookup
🔗 Check linked accounts        → Status

Error Handling

Analytics delay notes (set expectations proactively):

• TikTok: 24–48 h data delay
• Pinterest: 24–72 h data delay
• Instagram: account analytics require ≥ 100 followers
• Facebook: page analytics require ≥ 100 page likes