Summary
SocialCrabs currently supports Instagram, LinkedIn, and Twitter/X. This issue tracks the addition of TikTok platform integration to enable automated posting, engagement, and content management on TikTok.
Motivation
TikTok is one of the fastest-growing social media platforms with significant organic reach potential. Adding TikTok support would complete the multi-platform automation suite and provide users with:
- Automated video/image carousel posting
- Comment automation
- Follow/unfollow automation
- DM capabilities
- Analytics and monitoring
Technical Approach
Based on the existing platform architecture (src/platforms/), the TikTok integration should follow the established patterns.
File Structure
src/platforms/tiktok.ts - Main TikTok platform handlersrc/platforms/tiktok/login.ts - TikTok login with 2FA supportsrc/platforms/tiktok/post.ts - Video and carousel postingsrc/platforms/tiktok/engagement.ts - Like, comment, followsrc/platforms/tiktok/scraper.ts - Profile and content scrapingsrc/platforms/__tests__/tiktok.test.ts - Unit tests
Core Capabilities
- Login with credentials or QR code
- Upload video posts (TikTok video API)
- Upload image carousels (multi-image posts, up to 35 images)
- Like, comment, and follow actions
- Profile scraping (followers, following, posts)
- Story posting
- Analytics and metrics collection
TikTok API Considerations
Unlike Instagram and Twitter, TikTok has restricted API access. Recommended approach: Playwright-based browser automation (matching SocialCrabs simulative human-like behavior approach) for full feature parity.
Implementation Notes
- Login: TikTok uses email/phone + password or QR code. 2FA with authenticator apps should be supported.
- Video Posting: TikTok requires video format (.mp4, max 10 min, <2GB). FFmpeg preprocessing needed.
- Carousel Posts: TikTok supports image posts (up to 35 images) - can leverage this for carousel content.
- Rate Limiting: TikTok is aggressive with rate limits. Conservative delays needed (~30-60s between actions).
- Stealth Mode: TikTok has strong bot detection. Anti-detection measures critical.
Labels
enhancement, platform-tiktok, good-first-issue
References
Summary
SocialCrabs currently supports Instagram, LinkedIn, and Twitter/X. This issue tracks the addition of TikTok platform integration to enable automated posting, engagement, and content management on TikTok.
Motivation
TikTok is one of the fastest-growing social media platforms with significant organic reach potential. Adding TikTok support would complete the multi-platform automation suite and provide users with:
Technical Approach
Based on the existing platform architecture (
src/platforms/), the TikTok integration should follow the established patterns.File Structure
src/platforms/tiktok.ts- Main TikTok platform handlersrc/platforms/tiktok/login.ts- TikTok login with 2FA supportsrc/platforms/tiktok/post.ts- Video and carousel postingsrc/platforms/tiktok/engagement.ts- Like, comment, followsrc/platforms/tiktok/scraper.ts- Profile and content scrapingsrc/platforms/__tests__/tiktok.test.ts- Unit testsCore Capabilities
TikTok API Considerations
Unlike Instagram and Twitter, TikTok has restricted API access. Recommended approach: Playwright-based browser automation (matching SocialCrabs simulative human-like behavior approach) for full feature parity.
Implementation Notes
Labels
enhancement, platform-tiktok, good-first-issue
References
src/platforms/instagram.ts,src/platforms/twitter.ts