Socai AI Agent

<div align="center"> <h1> <a href="https://socai.io/?utm_source=github&amp;utm_medium=readme&amp;utm_campaign=main-repo-logo"><img src="site/public/icon-192.png" width="36" alt="socai icon" align="absmiddle"></a> socai </h1>

Makes your agent actually understand social platforms.

English · 简体中文 · 日本語 · 한국어

<p> <img src="site/public/platforms/xiaohongshu.png" height="32" alt="Xiaohongshu"> &nbsp;&nbsp; <img src="site/public/platforms/tiktok.png" height="32" alt="TikTok / Douyin"> &nbsp;&nbsp; <img src="site/public/platforms/instagram.png" height="32" alt="Instagram"> &nbsp;&nbsp; <img src="site/public/platforms/linkedin.svg" height="32" alt="LinkedIn"> &nbsp;&nbsp; <img src="site/public/platforms/x.png" height="32" alt="X"> &nbsp;&nbsp; <img src="site/public/platforms/weixin.png" height="32" alt="WeChat"> &nbsp;&nbsp; <img src="site/public/platforms/podcast.png" height="32" alt="Podcast"> </p>

<br> </div>

Social media platforms are hard to access for agents. Scrapers get you banned. Generic computer use methods are slow, expensive and lack the know-hows.

socai, instead, builds the deep ontology of each platform. This enables agents to actually understand the entities, states and flows in each platform. Then socai reuses your signed-in Chrome -- and thus keeps your social status -- to search, open posts, expand comments, read profiles, OCR images, transcribe video and so on, just like a human does.

Instagram research	Xiaohongshu research
https://github.com/user-attachments/assets/4849e0f3-87d5-4a0d-8e0b-2a58e3d0267a	https://github.com/user-attachments/assets/8aebcded-f365-4f12-b9c4-102cc1fa964d

Supported platforms

RedNote (Xiaohongshu) — search, authors, posts, comments, media, OCR, and transcription.

socai xhs search "sugar-free tea" --num-notes 10 --num-comments 8
socai xhs author <author_id> --num-notes 10
socai xhs get-notes --note '<note_id>=<xsec_token>' --num-comments 8
socai xhs comment '<note_url>' --text 'Exact comment text'

X — search, profiles, posts, and replies.

socai x search "open source" --num 10
socai x profile <handle>
socai x get-posts --post https://x.com/<handle>/status/<id> --num-comments 8
socai x reply https://x.com/<handle>/status/<id> --text 'Exact reply text'

Douyin — search, videos, authors, and comments.

socai dy search "coffee" --num 20
socai dy author <author_id> --num 10
socai dy get-videos --video <url> --num-comments 8

TikTok — search, videos, profiles, and comments.

socai tiktok search "coffee" --num 20
socai tiktok author <handle> --num 10
socai tiktok get-videos --video <url> --num-comments 8

Instagram — search, profiles, posts, reels, and comments.

socai instagram search "coffee" --num 10
socai instagram profile nike
socai instagram get-posts --post https://www.instagram.com/p/<shortcode>/ --num-comments 8
socai instagram search_accounts "nike"
socai instagram comment https://www.instagram.com/p/<shortcode>/ --text 'Exact comment text'

LinkedIn — people, companies, posts, and comments.

socai linkedin search "product designer" --type people --num 10
socai linkedin profile <id>
socai linkedin company <company>
socai linkedin get-posts --post https://www.linkedin.com/posts/<id> --num-comments 8
socai linkedin comment https://www.linkedin.com/posts/<id> --text 'Exact comment text'

WeChat Media Platform — search articles and read full article text.

socai weixin search "personal agent" --num 10
socai weixin search "personal agent" --num 3 --read
socai weixin read 'https://mp.weixin.qq.com/s/ARTICLE_ID'

Podcasts — discover Chinese and international shows, search episodes, and read summaries or transcripts from BidClub’s indexed library. No browser or login required.

socai podcast shows "Lex"
socai podcast episodes --show <show_id> --limit 5
socai podcast search "artificial intelligence" --limit 5
socai podcast read <episode_slug> --section digest
socai podcast read <episode_slug> --section transcript

Filters, comments, and the rest of the commands are in the user guide.

Get started

Desktop app for macOS and Windows:

• Download for macOS
• Download for Windows

CLI on macOS:

curl -fsSL https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/latest/install.sh | sh

Connect the installed CLI to Codex, Claude Code, Cursor, Gemini CLI, OpenCode, GitHub Copilot, and other local Agent Skills hosts:

socai integrate install all
socai integrate status --json

The portable socai-social-research Skill keeps agent-driven research read-only and covers all six supported platforms.

Windows installation, agent setup, platform commands, Chrome profiles, run artifacts, and local development are documented in the guide.

Browser protocol compatibility and security boundaries are documented in the browser backend support matrix.

Built with socai

Jev Social is a local-first demo that lets Jev choose bounded socai CLI operations for Instagram, TikTok, and LinkedIn. Captured post cards stay visible while a source-linked research report streams into the browser.

Install the Agent Skill

Community

Join the Discord.

Join WeChat group:

<img src="docs/assets/wechat-group-qr.jpg" alt="socai social media research WeChat group QR code" width="280">

If socai is useful, star the repo.