mcpField
S
socialclaw

socialclaw

github.com/ndesv21マーケティング・グロース102112 回インストール9 週間前に更新
リポジトリ

socialclaw について

SocialClaw は、OpenClaw 対応エージェントにホスト型のソーシャル投稿サービスの操作方法を示すスキルです。アカウント接続、メディアのアップロード、投稿予約の検証・適用、対応サービスの投稿や分析データの確認を行えます。

主な機能

  1. 01ソーシャルアカウントの接続と確認
  2. 02メディア素材のアップロード
  3. 03投稿予約の検証とプレビュー
  4. 04予約投稿とキャンペーンの適用
  5. 05投稿、ジョブ、分析データの確認

活用シーン

  1. 01ワークスペースにソーシャルアカウントを接続
  2. 02予約投稿用のメディアを準備
  3. 03適用前にキャンペーン予定を確認
  4. 04投稿状況と分析データを確認

MCP 対応

このスキルは、エージェントにSocialClaw HTTP APIの利用方法を示し、別途提供される `socialclaw` CLIも任意のクライアントとして扱います。サービスは、これらのクライアントにソーシャル投稿とワークスペース操作機能を提供します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ndesv21/socialclaw --skill socialclaw

インストール後、Claude Code で/socialclawを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
claude/
socialclaw.md
references/
cli.md
providers.md
workflows.md

詳細

SocialClaw は、X、LinkedIn、Instagram、Facebook Pages、TikTok、Discord、Telegram、YouTube、Reddit、WordPress、Pinterest に投稿する AI エージェント向けのソーシャルメディア予約投稿スキルです

SocialClaw は、https://getsocialclaw.com で利用できる、ワークスペース単位のソーシャルメディア投稿サービスです。

このスキルについて

このスキルは、ホスト型 SocialClaw サービスを利用するための指示レイヤーです。

SocialClaw のバックエンドや各プロバイダーとの連携機能そのものは含まれていません。 このスキルは、OpenClaw 互換エージェントが次の操作を行えるようにします。

  • ワークスペース API キーを取得または使用する
  • SocialClaw HTTP API を呼び出す
  • プロバイダーやアカウントの種類に関する注意事項を理解する
  • すでにインストールされている場合、別途提供される socialclaw CLI を使用する

このスキルは CLI なしでも動作します。CLI は、同じホスト型サービスを利用するための任意のクライアントにすぎません。

ユーザーが次の操作を希望する場合は、このスキルを使用してください。

  • SocialClaw ワークスペースでソーシャルアカウントを接続または切断する
  • メディアをアップロードし、SocialClaw がホストする配信用 URL を取得する
  • 予約投稿やキャンペーンを検証、プレビュー、適用、または確認する
  • 接続済みアカウントの機能、投稿設定、アクション、ジョブ、ヘルス、または分析データを確認する

SocialClaw のコードベース自体を編集する場合は、このスキルを使用しないでください。このバンドルは、デプロイ済みの SocialClaw ワークスペースを操作するためのものです。

デフォルト設定

  • ベース URL：https://getsocialclaw.com
  • 認証：Authorization: Bearer <key> によるワークスペース API キー
  • 推奨インターフェース：インストール済みの場合は socialclaw CLI
  • 代替インターフェース：SocialClaw HTTP API

実行時の要件

  • 必須の環境変数：SC_API_KEY
  • ホスト型サービスのベース URL：https://getsocialclaw.com
  • 任意の CLI：すでにインストールされている場合は socialclaw（または social）
  • ワークスペースのステータス：ワークスペースキーを使って CLI／API を実行するには、有効なトライアルまたは有料プランが必要です

任意の CLI

SocialClaw には、socialclaw という名前の独立した npm CLI パッケージもあります。

すでにインストールされている場合や、ユーザーがコマンドラインの使用例を希望する場合は、CLI を優先してください。CLI は、ホスト型 SocialClaw サービスのクライアントです。次の操作ができます。

  • ワークスペース API キーをローカルに保存する
  • 接続フローを開始する
  • アセットをアップロードする
  • 予約投稿を検証、プレビュー、適用する
  • 投稿、実行履歴、分析データ、使用状況、ワークスペースのヘルスを確認する
  • socialclaw install --claude でパッケージ化された Claude Code コマンドをインストールする

CLI は任意です。このスキルの動作に CLI は必要ありません。

ユーザーが CLI を明示的に希望していて、まだインストールされていない場合：

npm install -g socialclaw

クイックスタート

ユーザーがまだワークスペース API キーを持っていない場合：

open https://getsocialclaw.com/dashboard

次に、以下を伝えてください。

  • Google でサインインする
  • API キーのセクションを開く
  • ワークスペース API キーを作成するか、コピーする

次を設定します。

export SC_API_KEY="<workspace-key>"

CLI がインストールされている場合は、CLI でログインします。

socialclaw login --api-key <workspace-key>

それ以外の場合は、HTTP 経由でキーを検証します。

curl -sS \
  -H "Authorization: Bearer $SC_API_KEY" \
  "https://getsocialclaw.com/v1/keys/validate"

実行が plan_required、subscription_inactive、subscription_past_due、subscription_paused、または subscription_canceled で失敗した場合は、ユーザーに以下を案内してください。

  • https://getsocialclaw.com/pricing
  • https://getsocialclaw.com/dashboard

運用ルール

  1. まず、ユーザーがSocialClawワークスペースAPIキーを持っていることを確認してください。
  2. まだキーを持っていない場合は、https://getsocialclaw.com/dashboard にアクセスし、Googleでサインインしてキーを作成するよう案内してください。
  3. ワークスペースAPIキーだけでは実行できません。請求に関するエラーが表示された場合は、コマンドを再試行するのではなく、料金ページまたはダッシュボードの請求ページに案内してください。
  4. プロバイダーアプリのシークレットをユーザーに尋ねないでください。エンドユーザーはSocialClaw内でアカウントを接続します。
  5. プロバイダーとアカウントの種類を明確に表現してください。
    • Facebookの個人プロフィールではなく、Facebookページ
    • FacebookページにリンクされたInstagramビジネスアカウント
    • Instagramの単独のプロフェッショナルアカウント
    • LinkedInのプロフィールとLinkedInページは別々のプロバイダー
    • Pinterestはボード中心です。セクション、カタログ、高度な機能があると決めつける前に、機能やアクションを確認してください
  6. プロバイダーのワークフローがサポートされていない場合は、回避策をでっち上げず、サポートされていないことを率直に伝えてください。
  7. アカウントの機能やアクションで明示的に利用可能と示されていない限り、Pinterestの商品、コレクション、アイデアの機能は、利用可否が制限されているか、ベータ版として扱ってください。
  8. APIキー全体をチャットにそのまま表示しないでください。

主なワークフロー

  1. ユーザーがワークスペースAPIキーを持っていることを確認します。
  2. 必要に応じて、ダッシュボードでGoogleにサインインし、キーを作成するよう案内します。
  3. ワークスペースへのアクセスを検証します。
  4. アカウントを一覧表示するか、接続フローを開始します。
  5. 対象アカウントの機能や設定を確認します。
  6. 必要に応じてメディアをアップロードします。
  7. 投稿やキャンペーンを検証するか、プレビューします。
  8. 適用します。
  9. 必要に応じて、投稿、実行履歴、分析情報を確認するか、再試行／再照合します。

プロバイダー別の公開に関する注意事項

TikTokの写真投稿

TikTokの写真／ギャラリー投稿は、動画投稿より制約が厳しくなっています。TikTokの写真投稿を予約または適用する前に、次の点を確認してください。

  • 投稿には画像のみのアセットを使用してください。画像と動画を混在させないでください。
  • 各ギャラリーの画像数は、接続済みアカウントの機能上限以内にしてください。通常は最大35枚です。
  • アップロード前に、写真をTikTokに適したサイズに調整してください。縦向きの写真スライドには1080x1920のJPEGを推奨します。または、TikTokに対応する標準的なアスペクト比／サイズを使用してください。サイズが大きすぎる画像や一般的でない寸法の画像は、SocialClawによる検証とTikTokの初期受け入れを通過した後に、picture_size_check_failedで失敗することがあります。
  • 写真ギャラリーでは、TikTokにおすすめの音楽を選んでもらう場合、settings.autoAddMusic: trueを設定してください。TikTokのContent Posting APIでは、特定のサウンドを選択できません。
  • ユーザーが明示的に希望しない限り、表示されるname／タイトルは設定しないでください。TikTokの投稿では、ユーザー向けのテキストはdescriptionに入力してください。そうしないと、ダッシュボードやプレビューに不要なタイトル欄が表示されることがあります。
  • TikTokの写真ギャラリーを投稿した後は、providerStatus: acceptedが表示されているからといって、公開済みだと判断しないでください。少し時間を置いてから投稿を再照合してください。
socialclaw posts reconcile --post-id <post-id> --json

providerStatus: publishedかつreconciliationStatus: confirmedであることを、より確実な成功のシグナルとして扱ってください。再照合でpicture_size_check_failedが返された場合は、サイズを変更した画像または余白を追加した画像を再生成し、修正済みアセットをアップロードして、スケジュールを設定し直してください。

重要な例

CLIがインストールされている場合は、次のようなコマンドを優先してください。

ワークスペースキーを保存します。

socialclaw login --api-key <workspace-key>

接続フローを開始します。

socialclaw accounts connect --provider youtube --open

PinterestのOAuth接続を開始します。

socialclaw accounts connect --provider pinterest --open

ボットトークンとチャットの宛先を指定して、Telegramを手動で接続します。

socialclaw accounts connect --provider telegram --bot-token <bot-token> --chat-id @yourchannel --json

チャンネルのWebhook URLを指定して、Discordを手動で接続します。

socialclaw accounts connect --provider discord --webhook-url <discord-webhook-url> --json

接続済みアカウントを一覧表示します。

socialclaw accounts list --json

メディアをアップロードします。

socialclaw assets upload --file ./image.png --json

スケジュールを検証します。

socialclaw validate -f schedule.json --json

スケジュールを適用します。

socialclaw apply -f schedule.json --json

Claude Codeのコマンドをインストールします。

socialclaw install --claude

投稿を確認します。

socialclaw posts get --post-id <post-id> --json

接続ワークフロー

ブラウザベースのアカウント連携の場合：

  • CLI：
    • socialclaw accounts connect --provider <provider> --open
    • 続いて socialclaw accounts status --connection-id <id> --json
  • API：
    • POST /v1/connections/start
    • 認証 URL をユーザーに返すか、ブラウザツールを利用できる場合は開きます
    • GET /v1/connections/:connectionId をポーリングします

対応プロバイダー：

  • x
  • facebook
  • instagram_business
  • instagram
  • linkedin
  • linkedin_page
  • pinterest
  • tiktok
  • discord
  • telegram
  • youtube
  • reddit
  • wordpress

Telegram と Discord は、ブラウザベースの OAuth フローの例外です。

Telegram は次の情報を使って手動で接続します：

  • Telegram ボットトークン
  • 対象の chat_id または @channelusername

Telegram の場合：

  • CLI：
    • socialclaw accounts connect --provider telegram --bot-token <token> --chat-id <@channel|chat_id> --json
  • API：
    • POST /v1/connections/start に {"provider":"telegram","botToken":"...","chatId":"..." } を指定します

Discord は次の情報を使って手動で接続します：

  • Discord チャンネルのウェブフック URL

Discord の場合：

  • CLI：
    • socialclaw accounts connect --provider discord --webhook-url <discord-webhook-url> --json
  • API：
    • POST /v1/connections/start に {"provider":"discord","webhookUrl":"..." } を指定します

次に読む

  • HTTP フォールバックの手順については、references/workflows.md をお読みください。
  • オプションの CLI とコマンド例については、references/cli.md をお読みください。
  • プロバイダー／アカウント種別に関する注意事項については、references/providers.md をお読みください。

コメント

Markdown 対応