Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/socai-io--socai/badge.svg)](/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

i

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.

  1. {
  2. "name": "socai",
  3. "description": "Official socai integrations for social-media research.",
  4. "owner": {
  5. "name": "socai"
  6. },
  7. "plugins": [
  8. {
  9. "name": "socai-social-research",
  10. "source": "./plugins/socai-social-research",
  11. "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.",
  12. "version": "0.5.0"
  13. }
  14. ]
  15. }
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.

  1. <div align="center">
  2. <h1>
  3. <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>
  4. socai
  5. </h1>
  6. **Makes your agent actually understand social platforms.**
  7. **English** · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md)
  8. <p>
  9. <img src="site/public/platforms/xiaohongshu.png" height="32" alt="Xiaohongshu">
  10. &nbsp;&nbsp;
  11. <img src="site/public/platforms/tiktok.png" height="32" alt="TikTok / Douyin">
  12. &nbsp;&nbsp;
  13. <img src="site/public/platforms/instagram.png" height="32" alt="Instagram">
  14. &nbsp;&nbsp;
  15. <img src="site/public/platforms/linkedin.svg" height="32" alt="LinkedIn">
  16. &nbsp;&nbsp;
  17. <img src="site/public/platforms/x.png" height="32" alt="X">
  18. &nbsp;&nbsp;
  19. <img src="site/public/platforms/weixin.png" height="32" alt="WeChat">
  20. &nbsp;&nbsp;
  21. <img src="site/public/platforms/podcast.png" height="32" alt="Podcast">
  22. </p>
  23. [![website](https://img.shields.io/badge/website-socai.io-555?style=flat-square&color=blue)](https://socai.io/?utm_source=github&utm_medium=readme)
  24. [![release](https://img.shields.io/github/v/release/socai-io/socai?style=flat-square&color=blue&label=release)](https://github.com/socai-io/socai/releases/latest)
  25. [![discord](https://img.shields.io/badge/discord-join-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/CpQdA7bwt8)
  26. [![license](https://img.shields.io/badge/license-Apache--2.0-555?style=flat-square)](LICENSE)
  27. <br>
  28. </div>
  29. 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.
  30. 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.
  31. [![Beauty trend research and running creator discovery across Instagram, X and TikTok](docs/assets/research-demo-en.gif)](https://socai.io/?utm_source=github&utm_medium=readme&utm_campaign=research-demo#demo)
  32. | Instagram research | Xiaohongshu research |
  33. | --- | --- |
  34. | https://github.com/user-attachments/assets/4849e0f3-87d5-4a0d-8e0b-2a58e3d0267a | https://github.com/user-attachments/assets/8aebcded-f365-4f12-b9c4-102cc1fa964d |
  35. ## Supported platforms
  36. **RedNote (Xiaohongshu)** — search, authors, posts, comments, media, OCR, and transcription.
  37. ```bash
  38. socai xhs search "sugar-free tea" --num-notes 10 --num-comments 8
  39. socai xhs author <author_id> --num-notes 10
  40. socai xhs get-notes --note '<note_id>=<xsec_token>' --num-comments 8
  41. socai xhs comment '<note_url>' --text 'Exact comment text'
  42. ```
  43. **X** — search, profiles, posts, and replies.
  44. ```bash
  45. socai x search "open source" --num 10
  46. socai x profile <handle>
  47. socai x get-posts --post https://x.com/<handle>/status/<id> --num-comments 8
  48. socai x reply https://x.com/<handle>/status/<id> --text 'Exact reply text'
  49. ```
  50. **Douyin** — search, videos, authors, and comments.
  51. ```bash
  52. socai dy search "coffee" --num 20
  53. socai dy author <author_id> --num 10
  54. socai dy get-videos --video <url> --num-comments 8
  55. ```
  56. **TikTok** — search, videos, profiles, and comments.
  57. ```bash
  58. socai tiktok search "coffee" --num 20
  59. socai tiktok author <handle> --num 10
  60. socai tiktok get-videos --video <url> --num-comments 8
  61. ```
  62. **Instagram** — search, profiles, posts, reels, and comments.
  63. ```bash
  64. socai instagram search "coffee" --num 10
  65. socai instagram profile nike
  66. socai instagram get-posts --post https://www.instagram.com/p/<shortcode>/ --num-comments 8
  67. socai instagram search_accounts "nike"
  68. socai instagram comment https://www.instagram.com/p/<shortcode>/ --text 'Exact comment text'
  69. ```
  70. **LinkedIn** — people, companies, posts, and comments.
  71. ```bash
  72. socai linkedin search "product designer" --type people --num 10
  73. socai linkedin profile <id>
  74. socai linkedin company <company>
  75. socai linkedin get-posts --post https://www.linkedin.com/posts/<id> --num-comments 8
  76. socai linkedin comment https://www.linkedin.com/posts/<id> --text 'Exact comment text'
  77. ```
  78. **WeChat Media Platform** — search articles and read full article text.
  79. ```bash
  80. socai weixin search "personal agent" --num 10
  81. socai weixin search "personal agent" --num 3 --read
  82. socai weixin read 'https://mp.weixin.qq.com/s/ARTICLE_ID'
  83. ```
  84. **Podcasts** — discover Chinese and international shows, search episodes, and read summaries or transcripts from BidClub’s indexed library. No browser or login required.
  85. ```bash
  86. socai podcast shows "Lex"
  87. socai podcast episodes --show <show_id> --limit 5
  88. socai podcast search "artificial intelligence" --limit 5
  89. socai podcast read <episode_slug> --section digest
  90. socai podcast read <episode_slug> --section transcript
  91. ```
  92. Filters, comments, and the rest of the commands are in the [user guide](docs/guide.md#platform-command-reference).
  93. ## Get started
  94. Desktop app for macOS and Windows:
  95. - [Download for macOS](https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/latest/socai-macos-universal.dmg)
  96. - [Download for Windows](https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/latest/socai-windows-x86_64-setup.exe)
  97. CLI on macOS:
  98. ```bash
  99. curl -fsSL https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/latest/install.sh | sh
  100. ```
  101. Connect the installed CLI to Codex, Claude Code, Cursor, Gemini CLI, OpenCode, GitHub Copilot, and other local Agent Skills hosts:
  102. ```bash
  103. socai integrate install all
  104. socai integrate status --json
  105. ```
  106. 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.
  107. Windows installation, agent setup, platform commands, Chrome profiles, run artifacts, and local development are documented in the [guide](docs/guide.md).
  108. Browser protocol compatibility and security boundaries are documented in the [browser backend support matrix](docs/browser-backends.md).
  109. ## Built with socai
  110. [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.
  111. [![Jev Social demo](https://raw.githubusercontent.com/socai-io/jev-social/main/docs/jev-social.gif)](https://github.com/socai-io/jev-social)
  112. [Install the Agent Skill](https://github.com/socai-io/jev-social/tree/v0.1.13/skills/jev-social)
  113. ## Community
  114. [Join the Discord](https://discord.gg/CpQdA7bwt8).
  115. Join WeChat group:
  116. <img src="docs/assets/wechat-group-qr.jpg" alt="socai social media research WeChat group QR code" width="280">
  117. If socai is useful, star the repo.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.