Yapay zeka ajanlarını 11'den fazla sosyal platforma bağlayarak, bir hosted dashboard ve MCP server üzerinden gönderi planlaması, yayınlaması ve takibi yapın.
Ayrıca bilinen adı ndesv21/socialclaw
- Yıldızlar
- 110
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.1.20
- Son commit
- 12 Eki 2026
- Lisans
- MIT
SocialClaw MCP nedir?
Yapay zeka ajanlarını 11'den fazla sosyal platforma bağlayarak, bir hosted dashboard ve MCP server üzerinden gönderi planlaması, yayınlaması ve takibi yapın.
Özet, projenin README dosyasından oluşturuldu
SocialClaw MCP sunucusu hakkında
SocialClaw; X, LinkedIn, Instagram, TikTok ve YouTube dahil olmak üzere 11'den fazla sosyal medya platformu ile yapay zeka ajanları arasında bir köprü kurar. Geliştiricilerin sosyal medya içeriklerinin planlanmasını, yayınlanmasını ve takibini birleşik bir arayüz üzerinden otomatikleştirmesine olanak tanır. Sistem, kullanıcıların hesapları ve API anahtarlarını merkezi bir dashboard üzerinden yönettiği, hizmetle ise bir komut satırı arayüzü veya bir MCP server aracılığıyla etkileşime geçildiği hosted bir servis olarak çalışır.
Bu araç; Claude Code, Cursor veya Cline gibi yapay zeka istemcilerini kullanan geliştiriciler için tasarlanmıştır. SocialClaw MCP server'ını ekleyerek, bu ajanlar medya yükleme, planları doğrulama ve gönderi analitiklerini inceleme gibi görevler için 17 özel araca erişim sağlar. Kurulum için, ajan yürütmesini etkinleştirmek amacıyla bir workspace API key ve hosted dashboard üzerinden aktif bir abonelik veya deneme sürümü gereklidir. Basit gönderi silme işlemlerinden karmaşık kampanya önizlemelerine ve yayınlama workspace'inin sağlık kontrollerine kadar çeşitli iş akışlarını destekler.
Neler yapabilirsiniz
- 1Otomatik sosyal medya planlamasıBir yapay zeka ajanı, birden fazla platformda içerik yayınlamak için bir JSON veya YAML planını doğrulayabilir ve uygulayabilir.
- 2Medya varlık yönetimiGeliştiriciler, sosyal gönderilerde kullanılmak üzere görselleri veya videoları bir hosted workspace'e yüklemesi için bir ajana talimat verebilir.
- 3Sosyal medya performans takibiBir yapay zeka istemcisi, etkileşimi izlemek için belirli gönderilere ait detaylı analitik verilerini çekebilir.
- 4İçerik yaşam döngüsü yönetimiKullanıcılar, desteklenen sosyal sağlayıcılardan daha önce yayınlanmış gönderileri kaldırması için bir ajana komut verebilir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
SocialClaw MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleSocialClaw MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'SOCIALCLAW_API_KEY=<YOUR_SOCIALCLAW_API_KEY>' socialclaw -- npx -y socialclawSocialClaw MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"socialclaw": {
"command": "npx",
"args": [
"-y",
"socialclaw"
],
"env": {
"SOCIALCLAW_API_KEY": "<YOUR_SOCIALCLAW_API_KEY>"
}
}
}
}SocialClaw MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"socialclaw": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"socialclaw"
],
"env": {
"SOCIALCLAW_API_KEY": "<YOUR_SOCIALCLAW_API_KEY>"
}
}
}
}SocialClaw MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"socialclaw","type":"stdio","command":"npx","args":["-y","socialclaw"],"env":{"SOCIALCLAW_API_KEY":"<YOUR_SOCIALCLAW_API_KEY>"}}'SocialClaw MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"socialclaw": {
"command": "npx",
"args": [
"-y",
"socialclaw"
],
"env": {
"SOCIALCLAW_API_KEY": "<YOUR_SOCIALCLAW_API_KEY>"
}
}
}
}SocialClaw MCP'yi Codex içine yükleyin
$ codex mcp add socialclaw --env 'SOCIALCLAW_API_KEY=<YOUR_SOCIALCLAW_API_KEY>' -- npx -y socialclawSocialClaw MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.socialclaw] command = "npx" args = ["-y", "socialclaw"] [mcp_servers.socialclaw.env] SOCIALCLAW_API_KEY = "<YOUR_SOCIALCLAW_API_KEY>"
SocialClaw MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'SOCIALCLAW_API_KEY=<YOUR_SOCIALCLAW_API_KEY>' socialclaw npx -- -y socialclawSocialClaw MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"socialclaw": {
"command": "npx",
"args": [
"-y",
"socialclaw"
],
"env": {
"SOCIALCLAW_API_KEY": "<YOUR_SOCIALCLAW_API_KEY>"
}
}
}
}Yapılandırma
SOCIALCLAW_API_KEYGerekliGizliSocialClaw workspace API key from https://getsocialclaw.com/dashboard
| Ad | Açıklama | Sunucu |
|---|---|---|
| SOCIALCLAW_API_KEY | SocialClaw workspace API key from https://getsocialclaw.com/dashboard | GerekliGizli |
Otomatik kontroller
Çalıştırıldı 12 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
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 soruları
SocialClaw MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'SOCIALCLAW_API_KEY=<YOUR_SOCIALCLAW_API_KEY>' socialclaw -- npx -y socialclaw komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
SocialClaw MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Hangi sosyal medya platformları destekleniyor?
Desteklenen platformlar arasında X, Facebook Pages, Instagram, LinkedIn, Pinterest, TikTok, Discord, Telegram, YouTube, Reddit ve WordPress bulunmaktadır.
SocialClaw'ı Claude Code ile nasıl kullanabilirim?
API anahtarınızla birlikte 'claude mcp add socialclaw' komutunu kullanarak veya Claude Code marketplace üzerinden paketlenmiş eklentiyi yükleyerek ekleyebilirsiniz.
CLI kullanmak için bir API anahtarına ihtiyacım var mı?
Evet, CLI, API key kimlik doğrulaması aracılığıyla yayında olan bir SocialClaw workspace'ine bağlanarak çalışır.
Server üzerinden medya yükleyebilir miyim?
Evet, MCP server, medya yüklemek ve varlıkları yönetmek için araçlar sağlar.