Socialclaw

SocialClaw

AI エージェントが X、LinkedIn、Instagram、Facebook Pages、TikTok、Discord、Telegram、YouTube、Reddit、WordPress、Pinterest に投稿するための、ソーシャルメディア予約投稿 CLI と OpenClaw スキルです。

公式ウェブサイト：getsocialclaw.com · ダッシュボード · npm · スキルバンドル

getsocialclaw.com は SocialClaw の公式ウェブサイトです。ホスト型ダッシュボード、API、アカウント登録はすべてこちらで利用できます。

このリポジトリでは、次のものを公開しています。

• socialclaw npm CLI
• OpenClaw および ClawHub スキルバンドル
• Claude Code プラグインと /socialclaw コマンドアセット
• 公開されている使用方法のドキュメント、プロバイダー情報、スケジュール例

インストール

npm install -g socialclaw
socialclaw login
socialclaw accounts list --json

AI エージェントスキルとしてインストール（Claude Code、Cursor、Cline、Codex など）：

npx skills add ndesv21/socialclaw

CLI の機能

• ワークスペースの API キーでのログインと、ホスト型ダッシュボードの初期設定
• ブラウザー OAuth による接続、および Discord と Telegram の手動接続
• ホスト型アセットのアップロードと削除
• スケジュールの検証、キャンペーンのプレビュー、適用、確認、複製、下書きの公開
• 投稿、実行、試行、分析、ジョブ、使用状況、ヘルス状態の確認
• 対応する公開済み投稿のプロバイダー側での削除
• socialclaw install --claude による Claude Code コマンドのインストール

CLI の概要

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

デモを見る

_{画像をクリックするとデモ動画が開きます。}

エージェント主導の投稿向けに構築

認証とアクセス

API キーを指定せずに socialclaw login を実行すると、ホスト型ダッシュボードが開き、ユーザーは次の操作を行えます。

• Google でサインインする
• ソーシャルアカウントを接続する
• ワークスペースの API キーを作成またはコピーする
• CLI と API のアクセス用にトライアルまたは有料プランを有効にする

重要：

• CLI は API キー認証を使用して、デプロイ済みの SocialClaw ワークスペースに接続します
• API キーだけではエージェントを実行できません。ワークスペースで有効なトライアルまたは有料プランも必要です
• コマンドが plan_required または subscription_* を返した場合は、https://getsocialclaw.com/pricing または https://getsocialclaw.com/dashboard にアクセスしてください

クイックスタート

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

エージェント連携

MCP サーバー

このパッケージには Model Context Protocol サーバーが同梱されています。あらゆる MCP クライアント（Claude Code、Claude Desktop、Cursor など）で、接続済みのワークスペースアカウントを対象に、17 個の検証優先の公開ツールを利用できます。アカウントと機能の一覧表示、メディアのアップロード、スケジュールの検証とプレビュー、冪等性キーを使った適用、下書きの公開、投稿、試行、実行、分析、利用状況、ヘルス状態の確認が可能です。

Claude Code：

claude mcp add socialclaw \
  --env SOCIALCLAW_API_KEY=sc_live_your_key \
  -- npx -y socialclaw mcp

Claude Desktop、Cursor、その他の JSON 設定対応クライアント：

{
  "mcpServers": {
    "socialclaw": {
      "command": "npx",
      "args": ["-y", "socialclaw", "mcp"],
      "env": {
        "SOCIALCLAW_API_KEY": "sc_live_your_key"
      }
    }
  }
}

すでに socialclaw login --api-key <key> を実行済みの場合、サーバーは保存済みの認証情報を再利用するため、env ブロックは不要です。ツールの全一覧については、getsocialclaw.com/mcp をご覧ください。

Claude Code プラグイン

Claude Code 内から、パッケージ化された Claude Code プラグインをインストールします。

/plugin marketplace add ndesv21/socialclaw
/plugin install socialclaw@socialclaw

これにより、.claude-plugin/ のメタデータを使って、skills/socialclaw/ のマーケットプレイスプラグインがインストールされます。ユーザーがアカウント接続、メディアのアップロード、投稿のスケジュール設定、配信状況の確認、分析の確認を求めたときに、Claude が SocialClaw を自動的に呼び出すようにしたい場合に最適な方法です。

Claude のスラッシュコマンドとスキルファイル

プラグインの一連の機能ではなく、明示的な /socialclaw コマンドを使いたい場合：

socialclaw install --claude

これにより、同梱のコマンドファイル skill/claude/socialclaw.md が ~/.claude/commands/socialclaw.md にインストールされます。

次のような軽量な Claude Code セットアップを希望する場合は、この方法を使ってください。

• わかりやすい SocialClaw コマンドを 1 つ公開する
• ワークスペース API キーのフローを明示する
• それでも Claude が同じホスト型 SocialClaw API と CLI のワークフローを使えるようにする

OpenClaw と ClawHub

OpenClaw 互換のスキルバンドルは skill/ にあります。

これは、SKILL.md を読み込み、ワークスペース API キーを使って動作し、次のいずれかを呼び出せる OpenClaw やその他の互換エージェントランタイム向けに設計されています。

• SocialClaw HTTP API を直接呼び出す
• ホスト型サービスのクライアントとして socialclaw CLI を使う

OpenClaw で見つけられるように ClawHub へ公開するバンドルです。

その他のエージェント

SocialClaw は、特定の 1 つのエージェントフレームワークに限定されません。このリポジトリには skill/agents/openai.yaml のエージェントマニフェストも含まれており、シェルコマンドを実行したり HTTP リクエストを送信したりできるあらゆるランタイムで CLI を活用できます。

そのため、SocialClaw は次の用途に適しています。

• Codex やターミナルネイティブのエージェントワークフロー
• プラグインまたはコマンドファイルを使った Claude Code
• OpenClaw と ClawHub のスキル
• ソーシャルチャネル向けに安定した公開手段を 1 つ必要とするカスタムの社内エージェント

実際には、これらはすべて同じモデルを共有します。

• SocialClaw 内で顧客アカウントを接続する
• ワークスペース API キーを作成する
• ホスト型サービスを通じて、メディアのアップロード、検証、適用、確認、分析を行い、対応済みの投稿を必要に応じて削除する

対応プロバイダー

• X
• Facebook Pages
• Instagram Business
• Instagram standalone professional accounts
• LinkedIn profile
• LinkedIn page
• Pinterest
• TikTok
• Discord
• Telegram
• YouTube
• Reddit
• WordPress

Pinterest は、公開 CLI とスキルバンドルでは pinterest プロバイダーとして公開されています。主な公開先はボード中心で、標準ピン、動画ピン、複数画像のピン、ボードの作成、セクションやカタログの検索に加え、ピンとアカウントの分析に対応しています。商品、コレクション、アイデア関連の機能は、すべてのワークスペースで利用できるとは限らないため、機能の有効化が必要、またはベータ版として扱ってください。

TikTok では、1件の投稿につき動画1本または写真ギャラリー1つに対応しています。写真ギャラリーには最大35枚の画像を含めることができ、autoAddMusic と photoCoverIndex を指定できます。特定のTikTokの曲やサウンドの選択は、TikTok Content Posting API では利用できません。写真ギャラリーでは、アップロード前に画像を正規化してください。縦向きスライドには1080x1920のJPEGを推奨しますが、TikTokに対応する別の標準的なアスペクト比やサイズでも構いません。サイズが大きすぎる画像や特殊な寸法の画像は、SocialClawの検証とTikTokによる初期受け付けを通過した後で、picture_size_check_failed により失敗することがあります。公開後に写真投稿を照合し、TikTokが PUBLISH_COMPLETE と報告することを確認してください。

公開

npm version を使ってバージョンを更新します。

npm version patch
git push && git push --tags
npm publish --access public

skill/references/ の編集後に、参照ファイルを手動で同期するには、次を実行します。

npm run sync:references

注意事項

• ユーザーは、ホスト型のSocialClawダッシュボード内でアカウントを接続します。
• ダッシュボードとAPIは https://getsocialclaw.com にあります。
• npmパッケージには、CLI、スキルドキュメント、Claude Codeプラグイン、コマンドアセットが含まれています。