socai
Agent that actually understands social platforms. Fast. Precise. Deep.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/socai-io/socai with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/socai-io/socai'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/socai-io--socai)HTML
<a href="/listings/socai-io--socai"><img src="/api/listings/socai-io--socai/badge.svg" alt="findsafeskills safety rating" /></a>Install
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.
.claude-plugin/marketplace.json · Manifest · 15 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "name": "socai",
- "description": "Official socai integrations for social-media research.",
- "owner": {
- "name": "socai"
- },
- "plugins": [
- {
- "name": "socai-social-research",
- "source": "./plugins/socai-social-research",
- "description": "Research public posts, comments, creators, and trends on Xiaohongshu, Douyin, TikTok, Instagram, LinkedIn, and X/Twitter with the local socai CLI and the user's authenticated Chrome session.",
- "version": "0.5.0"
- }
- ]
- }
README.md · README · 166 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <div align="center">
- <h1>
- <a href="https://socai.io/?utm_source=github&utm_medium=readme&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** · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md)
- <p>
- <img src="site/public/platforms/xiaohongshu.png" height="32" alt="Xiaohongshu">
-
- <img src="site/public/platforms/tiktok.png" height="32" alt="TikTok / Douyin">
-
- <img src="site/public/platforms/instagram.png" height="32" alt="Instagram">
-
- <img src="site/public/platforms/linkedin.svg" height="32" alt="LinkedIn">
-
- <img src="site/public/platforms/x.png" height="32" alt="X">
-
- <img src="site/public/platforms/weixin.png" height="32" alt="WeChat">
-
- <img src="site/public/platforms/podcast.png" height="32" alt="Podcast">
- </p>
- [](https://socai.io/?utm_source=github&utm_medium=readme)
- [](https://github.com/socai-io/socai/releases/latest)
- [](https://discord.gg/CpQdA7bwt8)
- [](LICENSE)
- <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.
- [](https://socai.io/?utm_source=github&utm_medium=readme&utm_campaign=research-demo#demo)
- | 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.
- ```bash
- 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.
- ```bash
- 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.
- ```bash
- 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.
- ```bash
- 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.
- ```bash
- 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.
- ```bash
- 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.
- ```bash
- 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.
- ```bash
- 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](docs/guide.md#platform-command-reference).
- ## Get started
- Desktop app for macOS and Windows:
- - [Download for macOS](https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/latest/socai-macos-universal.dmg)
- - [Download for Windows](https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/latest/socai-windows-x86_64-setup.exe)
- CLI on macOS:
- ```bash
- 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:
- ```bash
- socai integrate install all
- socai integrate status --json
- ```
- The portable [`socai-social-research` Skill](https://skills.sh/socai-io/socai/socai-social-research) 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](docs/guide.md).
- Browser protocol compatibility and security boundaries are documented in the [browser backend support matrix](docs/browser-backends.md).
- ## Built with socai
- [Jev Social](https://github.com/socai-io/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.
- [](https://github.com/socai-io/jev-social)
- [Install the Agent Skill](https://github.com/socai-io/jev-social/tree/v0.1.13/skills/jev-social)
- ## Community
- [Join the Discord](https://discord.gg/CpQdA7bwt8).
- 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.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.