socai-cli
/socai-cli
Use the installed socai CLI for research on Xiaohongshu, Douyin, TikTok, Instagram, LinkedIn, and podcasts. Use when an external agent needs real posts, comments, creator profiles, or source-linked social research through the user's signed-in browser, or podcast summaries and transcripts without a browser.
- Author
- socai-io ↗
- Repository
- socai ↗
- Licence
- Apache-2.0
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
What it does and when to use it
Use the installed socai CLI for research on Xiaohongshu, Douyin, TikTok, Instagram, LinkedIn, and podcasts. Use when an external agent needs real posts, comments, creator profiles, or source-linked social research through the user's signed-in browser, or podcast summaries and transcripts without a browser.
Original author description
Use the installed socai CLI for research on Xiaohongshu, Douyin, TikTok, Instagram, LinkedIn, and podcasts. Use when an external agent needs real posts, comments, creator profiles, or source-linked social research through the user's signed-in browser, or podcast summaries and transcripts without a browser.
How it works
- Start each new task once
- Gather and deliver evidence
SKILL.md preview
---
name: socai-cli
description: Use the installed socai CLI for research on Xiaohongshu, Douyin, TikTok, Instagram, LinkedIn, and podcasts. Use when an external agent needs real posts, comments, creator profiles, or source-linked social research through the user's signed-in browser, or podcast summaries and transcripts without a browser.
---
# socai CLI research
Use `socai --help` and `socai <site> <command> --help` as the authoritative
command reference. `socai status --json` checks readiness without connecting
Chrome. If the binary is missing, follow the installation instructions in the
repository README. Do not substitute scraping or private APIs for socai.
## Start each new task once
This is the standard workflow for all platform CLI operations. The command
reference examples are operations inside a task, not alternative entry points.
Before the first site command for a new user request, pass the user's original
question to `socai task begin`. Keep their wording; do not replace it with a
summary, search keywords, or your plan.
```bash
socai task begin "Find why first-time campers regret their gear purchases."
socai xhs search "camping gear regrets" --num-notes 10 > /tmp/camping-xhs.json
socai instagram search "camping gear regrets" --num 20 > /tmp/camping-instagram.json
```
Ordinary commands automatically join the daemon's current task. No ID or extra
argument is needed. A new user goal starts a new task; searching another keyword,
reading a profile, or retrying within the same task does not. Register again
after the daemon restarts. Multiple agents using the same daemon share its most
recent task boundary; separate `SOCAI_HOME` directories create independent daemon
sessions when needed.
For multiline or shell-sensitive text, write a task-specific UTF-8 JSON file using
a file tool or JSON serializer, then run `socai task begin --context-file <path>`:
```json
{
"user_prompt": "The user's original question",
"agent_host": "unknown"
}
```
`agent_host` is optional; use the actual host identifier when known. Stdin is
supported with `--context-file -`. Remove the temporary input file after use.
If the original question is no longer available, use `user_prompt: null` rather
than reconstructing it. Do not read other conversations or submit system prompts,
attachments, or credentials. Registration does not connect Chrome.
On an older CLI that lacks `task begin`, continue ordinary research without
registration. Do not repeatedly retry or automatically upgrade. Failed
registration leaves the previous daemon task unchanged.
## Gather and deliver evidence
Choose among `xhs`, `dy`, `tiktok`, `instagram`, `linkedin`, and `podcast` according to the
user's scope. Inspect command help before using platform-specific options.
Redirect large JSON results into task-specific files and read relevant fields
selectively. Keep source URLs and distinguish collected evidence from inference.
Treat login, permission prompts, and platform verification as access limitations;
do not loop indefinitely when blocked.
Deliver the requested analysis or artifact, with sources and material gaps.
Keep research read-only unless the user explicitly requested a specific write.
Versions
The database has no other skills named socai-cli.
Database snapshot: 13.11.2026 · package version e644fe1d8eb3 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90socai-social-research
使用本机 socai CLI 和用户已登录的 Chrome 调研小红书、抖音、TikTok、Instagram、LinkedIn 与 X/Twitter 的公开帖子、评论、账号和趋势,并返回带来源链接的洞察。 当用户要做社媒聆听、消费者洞察、竞品研究、达人或公司研究、帖子与评论取证、趋势验证或跨平台比较时使用;不要用于普通网页搜索、内容创作或发布。 触发词:小红书、XHS、RedNote、Redbook、抖音、Douyin、TikTok、Instagram、LinkedIn、X、Twitter、社媒聆听、social listening、消费者洞察、竞品研究。 - 100jev-social
Run browser-grounded, read-only social research through Jev Social when a user wants posts, profiles, comments, video evidence, or a source-linked report from Instagram, TikTok, or LinkedIn and the local socai CLI reports support for that platform. Do not use for publishing,… - 90socai-social-research
Research, compare, and cite public content from Xiaohongshu (XHS/RedNote/Redbook), Douyin, TikTok, Instagram, LinkedIn, or X (Twitter) by using the local socai CLI and the user's authenticated Chrome session. Use for social listening, consumer insights, competitor research,… - 100jev-social
Run browser-grounded social research without remote account mutations through Jev Social when a user wants posts, profiles, comments, video evidence, or a source-linked report from Instagram, TikTok, or LinkedIn and the local socai CLI reports support for that platform. Do not… - 100crawling-social-media
Downloads and extracts content from social media platforms. Use when user wants to crawl, download, or extract videos/content from Bilibili, YouTube, TikTok, Douyin, Instagram, Twitter, Xiaohongshu. 下载视频、抓取视频、爬取内容、提取视频、下载B站视频、下载抖音视频、下载YouTube视频、视频采集。 - 95linkedin
LinkedIn automation via the Linked API CLI - fetch profiles, search people and companies, send messages, manage connections, create posts, react, comment, and run Sales Navigator and custom workflows. Use when the user wants to interact with LinkedIn.