호스팅된 대시보드와 MCP server를 통해 AI agent를 11개 이상의 소셜 플랫폼에 연결하여 게시물을 예약, 발행 및 추적합니다.
다른 이름 ndesv21/socialclaw
- 스타
- 110
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.1.20
- 마지막 커밋
- 2026년 10월 12일
- 라이선스
- MIT
SocialClaw MCP란?
호스팅된 대시보드와 MCP server를 통해 AI agent를 11개 이상의 소셜 플랫폼에 연결하여 게시물을 예약, 발행 및 추적합니다.
프로젝트 README에서 생성된 요약
SocialClaw MCP server 정보
SocialClaw는 X, LinkedIn, Instagram, TikTok, YouTube를 포함한 11개 이상의 소셜 미디어 플랫폼과 AI agent를 연결하는 가교 역할을 합니다. 개발자는 통합 인터페이스를 통해 소셜 미디어 콘텐츠의 예약, 발행 및 추적을 자동화할 수 있습니다. 이 시스템은 사용자가 중앙 대시보드에서 계정과 API key를 관리하는 호스팅 서비스로 작동하며, 사용자는 CLI 또는 MCP server를 통해 서비스와 상호작용합니다.
이 도구는 Claude Code, Cursor, Cline과 같은 AI 클라이언트를 사용하는 개발자를 위해 설계되었습니다. SocialClaw MCP server를 추가하면 이러한 agent는 미디어 업로드, 일정 검증, 게시물 분석 확인 등과 같은 작업을 수행할 수 있는 17개의 특화된 도구를 사용할 수 있습니다. 에이전트 실행을 활성화하려면 워크스페이스 API key와 호스팅 대시보드의 활성 구독 또는 트라이얼이 필요합니다. 단순한 게시물 삭제부터 복잡한 캠페인 미리보기, 게시 워크스페이스 상태 점검에 이르기까지 다양한 워크플로우를 지원합니다.
활용 사례
- 1소셜 미디어 예약 자동화AI agent가 JSON 또는 YAML 일정을 검증하고 적용하여 여러 플랫폼에 콘텐츠를 발행할 수 있습니다.
- 2미디어 에셋 관리개발자가 agent에게 소셜 게시물에 사용할 이미지나 비디오를 호스팅된 워크스페이스에 업로드하도록 지시할 수 있습니다.
- 3소셜 미디어 성과 추적AI 클라이언트가 특정 게시물의 상세 분석 데이터를 가져와 참여도를 모니터링할 수 있습니다.
- 4콘텐츠 라이프사이클 관리사용자가 agent에게 지원되는 소셜 프로바이더에서 이전에 발행된 게시물을 삭제하도록 명령할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
SocialClaw MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 SocialClaw MCP 설치
$ claude mcp add --env 'SOCIALCLAW_API_KEY=<YOUR_SOCIALCLAW_API_KEY>' socialclaw -- npx -y socialclawCursor에 SocialClaw MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"socialclaw": {
"command": "npx",
"args": [
"-y",
"socialclaw"
],
"env": {
"SOCIALCLAW_API_KEY": "<YOUR_SOCIALCLAW_API_KEY>"
}
}
}
}VS Code에 SocialClaw MCP 설치
.vscode/mcp.json
{
"servers": {
"socialclaw": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"socialclaw"
],
"env": {
"SOCIALCLAW_API_KEY": "<YOUR_SOCIALCLAW_API_KEY>"
}
}
}
}VS Code CLI에 SocialClaw MCP 설치
$ code --add-mcp '{"name":"socialclaw","type":"stdio","command":"npx","args":["-y","socialclaw"],"env":{"SOCIALCLAW_API_KEY":"<YOUR_SOCIALCLAW_API_KEY>"}}'Claude Desktop에 SocialClaw MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"socialclaw": {
"command": "npx",
"args": [
"-y",
"socialclaw"
],
"env": {
"SOCIALCLAW_API_KEY": "<YOUR_SOCIALCLAW_API_KEY>"
}
}
}
}Codex에 SocialClaw MCP 설치
$ codex mcp add socialclaw --env 'SOCIALCLAW_API_KEY=<YOUR_SOCIALCLAW_API_KEY>' -- npx -y socialclawCodex config.toml에 SocialClaw MCP 설치
~/.codex/config.toml
[mcp_servers.socialclaw] command = "npx" args = ["-y", "socialclaw"] [mcp_servers.socialclaw.env] SOCIALCLAW_API_KEY = "<YOUR_SOCIALCLAW_API_KEY>"
Gemini CLI에 SocialClaw MCP 설치
$ gemini mcp add -s user -e 'SOCIALCLAW_API_KEY=<YOUR_SOCIALCLAW_API_KEY>' socialclaw npx -- -y socialclawGemini settings.json에 SocialClaw MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"socialclaw": {
"command": "npx",
"args": [
"-y",
"socialclaw"
],
"env": {
"SOCIALCLAW_API_KEY": "<YOUR_SOCIALCLAW_API_KEY>"
}
}
}
}구성
SOCIALCLAW_API_KEY필수비밀SocialClaw workspace API key from https://getsocialclaw.com/dashboard
| 이름 | 설명 | 유형 |
|---|---|---|
| SOCIALCLAW_API_KEY | SocialClaw workspace API key from https://getsocialclaw.com/dashboard | 필수비밀 |
자동 검사
2026년 11월 12일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기getsocialclaw.com is the official SocialClaw website — the hosted dashboard, API, and account sign-up all live there.
This repo is the public home for:
- the
socialclawnpm CLI - the OpenClaw and ClawHub skill bundle
- the Claude Code plugin and
/socialclawcommand asset - public usage docs, provider notes, and schedule examples
Install
npm install -g socialclaw
socialclaw login
socialclaw accounts list --json
Install as an AI agent skill (Claude Code, Cursor, Cline, Codex, and more):
npx skills add ndesv21/socialclaw
What the CLI covers
- workspace API key login and hosted dashboard bootstrap
- browser OAuth connect plus manual Discord and Telegram connect
- hosted asset upload and deletion
- schedule validation, campaign preview, apply, inspect, clone, and draft publishing
- post, run, attempt, analytics, job, usage, and health inspection
- provider-side deletion for supported published posts
- Claude Code command installation through
socialclaw install --claude
CLI at a glance
socialclaw login
socialclaw accounts list --json
socialclaw assets upload --file ./image.png --json
socialclaw validate -f schedule.json --json
socialclaw apply -f schedule.json --json
socialclaw posts delete --post-id <post-id> --json
____ _ _ ____ _
/ ___| ___ ___(_) __ _| | / ___| | __ ___ __
\___ \ / _ \ / __| |/ _` | | | | | |/ _` \ \ /\ / /
___) | (_) | (__| | (_| | | | |___| | (_| |\ V V /
|____/ \___/ \___|_|\__,_|_| \____|_|\__,_| \_/\_/
socialclaw login
socialclaw accounts list --json
socialclaw assets upload --file <path> --json
socialclaw campaigns preview -f <schedule.(yaml|yml|json)> --json
socialclaw validate -f <schedule.(yaml|yml|json)> --json
socialclaw apply -f <schedule.(yaml|yml|json)> --json
socialclaw posts get --post-id <id> --json
socialclaw posts delete --post-id <id> --json
socialclaw status --run-id <id> --json
socialclaw analytics post --post-id <id> --json
Watch the Demo
Built for Agent-Driven Publishing
Authentication and access
Running socialclaw login without an API key opens the hosted dashboard so the user can:
- sign in with Google
- connect social accounts
- create or copy a workspace API key
- activate a trial or paid plan for CLI and API access
Important:
- the CLI works against a deployed SocialClaw workspace via API key auth
- an API key alone is not enough for agent execution; the workspace must also have an active trial or paid plan
- if a command returns
plan_requiredorsubscription_*, go tohttps://getsocialclaw.com/pricingorhttps://getsocialclaw.com/dashboard
Quick start
socialclaw login
socialclaw login --api-key <workspace-key> --base-url https://getsocialclaw.com
socialclaw accounts list --json
socialclaw accounts capabilities --provider pinterest --json
socialclaw accounts connect --provider pinterest --open
socialclaw accounts connect --provider discord --webhook-url <webhook-url> --json
socialclaw accounts connect --provider telegram --bot-token <bot-token> --chat-id @yourchannel --json
socialclaw assets upload --file ./image.png --json
socialclaw campaigns preview -f schedule.json --json
socialclaw validate -f schedule.json --json
socialclaw apply -f schedule.json --json
socialclaw posts delete --post-id <post-id> --json
socialclaw workspace health --json
socialclaw usage --json
Agent integrations
MCP server
The package ships a Model Context Protocol server. Any MCP client (Claude Code, Claude Desktop, Cursor, and others) gets 17 validation-first publishing tools over your connected workspace accounts: list accounts and capabilities, upload media, validate and preview schedules, apply with idempotency keys, publish drafts, and inspect posts, attempts, runs, analytics, usage, and health.
Claude Code:
claude mcp add socialclaw \
--env SOCIALCLAW_API_KEY=sc_live_your_key \
-- npx -y socialclaw mcp
Claude Desktop, Cursor, and other JSON-configured clients:
{
"mcpServers": {
"socialclaw": {
"command": "npx",
"args": ["-y", "socialclaw", "mcp"],
"env": {
"SOCIALCLAW_API_KEY": "sc_live_your_key"
}
}
}
}
If you have already run socialclaw login --api-key <key>, the server reuses the saved credentials and the env block is unnecessary. See getsocialclaw.com/mcp for the full tool list.
Claude Code plugin
Install the packaged Claude Code plugin from inside Claude Code:
/plugin marketplace add ndesv21/socialclaw
/plugin install socialclaw@socialclaw
This installs the marketplace plugin from skills/socialclaw/ with metadata from .claude-plugin/. It is the cleanest option if you want Claude to auto-invoke SocialClaw when a user asks to connect accounts, upload media, schedule posts, inspect delivery, or check analytics.
Claude slash command and skill file
If you want the explicit /socialclaw command instead of the full plugin flow:
socialclaw install --claude
That installs the bundled command file from skill/claude/socialclaw.md into ~/.claude/commands/socialclaw.md.
Use this path when you want a lightweight Claude Code setup that:
- exposes one clear SocialClaw command
- keeps the workspace API key flow explicit
- still lets Claude use the same hosted SocialClaw API and CLI workflow
OpenClaw and ClawHub
The OpenClaw-compatible skill bundle lives in skill/.
It is designed for OpenClaw and other compatible agent runtimes that can load a SKILL.md, work from a workspace API key, and call either:
- the SocialClaw HTTP API directly
- the
socialclawCLI as a client for the hosted service
This is the bundle to publish to ClawHub for OpenClaw discovery.
Other agents
SocialClaw is not limited to one agent framework. The repo also includes an agent manifest in skill/agents/openai.yaml, and the CLI works well for any runtime that can execute shell commands or make HTTP requests.
That makes SocialClaw a good fit for:
- Codex and terminal-native agent workflows
- Claude Code via plugin or command file
- OpenClaw and ClawHub skills
- custom internal agents that need one stable publishing surface for social channels
In practice, all of these share the same model:
- connect customer accounts inside SocialClaw
- create a workspace API key
- upload media, validate, apply, inspect, analyze, and optionally delete supported posts through the hosted service
Supported providers
- X
- Facebook Pages
- Instagram Business
- Instagram standalone professional accounts
- LinkedIn profile
- LinkedIn page
- TikTok
- Discord
- Telegram
- YouTube
- WordPress
Pinterest is exposed as the pinterest provider in the public CLI and skill bundle. Its main publish target is board-centric, with support for standard pins, video pins, multi-image pins, board creation and section or catalog discovery, plus pin and account analytics. Product, collection, and idea surfaces should be treated as capability-gated or beta rather than assumed for every workspace.
TikTok supports one video or one photo gallery per post. Photo galleries can include up to 35 images and expose autoAddMusic plus photoCoverIndex; selecting a specific TikTok song or sound is not available through TikTok's Content Posting API. For photo galleries, normalize images before upload, preferably to 1080x1920 JPEGs for vertical slides or another standard TikTok-compatible aspect/size. Oversized or unusual image dimensions may pass SocialClaw validation and initial TikTok acceptance, then fail later with picture_size_check_failed; reconcile photo posts after publish to confirm TikTok reports PUBLISH_COMPLETE.
Publishing
Bump the version with npm version:
npm version patch
git push && git push --tags
npm publish --access public
To sync reference files manually after editing skill/references/:
npm run sync:references
Notes
- Users connect accounts inside the hosted SocialClaw dashboard.
- The dashboard and API live at
https://getsocialclaw.com. - The npm package ships the CLI, skill docs, Claude Code plugin, and command asset.
SocialClaw MCP 질문
SocialClaw MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'SOCIALCLAW_API_KEY=<YOUR_SOCIALCLAW_API_KEY>' socialclaw -- npx -y socialclaw를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
SocialClaw MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
어떤 소셜 미디어 플랫폼을 지원하나요?
X, Facebook Pages, Instagram, LinkedIn, Pinterest, TikTok, Discord, Telegram, YouTube, Reddit, WordPress를 지원합니다.
Claude Code에서 SocialClaw를 어떻게 사용하나요?
API key와 함께 'claude mcp add socialclaw' 명령어를 사용하거나, Claude Code marketplace를 통해 패키지된 플러그인을 설치할 수 있습니다.
CLI를 사용하려면 API key가 필요한가요?
네, CLI는 API key 인증을 통해 배포된 SocialClaw 워크스페이스와 연동되어 작동합니다.
server를 통해 미디어를 업로드할 수 있나요?
네, MCP server는 미디어 업로드 및 에셋 관리를 위한 도구를 제공합니다.