# このアシスタントを使う本人のためにSosoAPIを設定する 本人の既存アシスタントを使い、元の作業、内容、 この会話のメディア参照情報を維持します。接続アカウントに一つのSosoAPI MCPを使用し、 ソーシャルアカウント。既存の接続を再利用するか、ローカルまたはホスト型アクセスを選びます： を参照してください。設定で投稿は公開されません。本人がログインし、許可する 本人のブラウザーで認可します。本人の認証情報の入力や同意の承認を代行せず、 を代行します。Freeにカードは不要です。 ## 1. このアシスタントを接続する 最初に現在のホストと既存のSosoAPI設定を確認します。既存の 正常な接続を再利用します。ログアウト、設定の上書き、別接続の作成は行いません。 このガイドを再び開いたという理由だけで接続を作り直さないでください。 ローカルシェルではNode.js 20以降とnpxが使えるか確認します。次を使用します： 既存の対応ランタイムを使います。なければ前提条件を平易な の言語で説明し、特権操作やシステム全体の変更を自動で行いません。 Claude Code: ```sh claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` Codex: ```sh codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` サーバー登録後、この会話でツールを呼べるか確認してください。 会話。ホストの再接続や再起動が必要な場合は、本人に対象を案内し、 必要な操作を案内します。ツールが動作するまで接続準備完了と伝えないでください。 新規接続は通常の投稿用に既存の28ツールcoreプロファイルを使い、 メディア、コメント、インサイト。正常なfullプロファイル接続は再利用してください。 必要な管理操作がない場合は、fullプロファイルが利用できることを説明し、 が利用できます。ツールを隠しても権限の付与・失効は行いません。 カスタムMCPアプリに対応するChatGPTなど、ブラウザー専用クライアントでは、次を追加します： リモートMCP URLを追加し、自動クライアント登録付きのOAuthを選びます： `https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp` APIキー、client ID、client secretの貼り付けは不要です。本人がログインし、 SosoAPIにログインしてワークスペースと操作を選びます。ChatGPTカスタムアプリは プランと開発者モードの提供状況を確認します。正常なローカル・リモート接続を再利用し、 設定済みの接続がある場合は再利用してください。 Xは独自テキストとリンクに対応します。各組織はFreeのXクレジット10を共有し、 を一度、Proは請求期間ごとに100を付与します。テキストは1、URL入り投稿は は10を消費します。次を確認してください： `sosoapi_get_x_usage` をworkspace_id付きで取得してからXの利用を計画します。 超過料金は自動請求しません。公開結果が不確かな場合はクレジットの予約枠を保持し、 予約枠があり、再送前に結果の照合が必要です。 ## 2. APIキーなしでログイン 最初の認証付きMCP呼び出しで、既存のブラウザーログインとエージェント 同意手順。Googleを使うか、メールアドレスを登録・認証できます。 本人にワークスペースと、アシスタントが準備のみ行えるか、それとも コンテンツの準備のみか、予約・公開も許可するかを選びます。認証情報をコピーするよう求めないでください。 公開への同意は選択範囲で継続し、投稿ごとの強制承認 投稿ごとの承認画面はありません。通常の投稿ではキー管理を無効にしてください。 メール登録・ログインは、バックグラウンドでのセキュリティ検証を使用し、 確認操作を説明します。検証に失敗した場合は、実際の エラーを報告し、使える再試行操作を利用します。本人に確認用チェックボックスを探す・クリックするよう求めません。 CAPTCHAのチェックボックスはありません。既存の**Googleで続行**も利用できます。 Googleを使いたい場合。Google独自の本人確認が必要なことがあります。 本人にアカウントを選び、アクセスを承認してもらう。 現在のログイン・承認リンクと戻り先を維持し、置き換えないでください。 単なる登録URLに置き換えたり、既存管理者のIDへ黙って切り替えたりしません。 一つのログインエラーだけで、すべてのログイン方法が使えないとは判断できません。 本人の認証・同意が必要な手順だけを一時停止します。本人が が完了する間に、インストール確認と元の下書き準備を進め、 アカウントやワークスペースを架空に作らず、準備済みのものと、本人が次に行う一つの 次に必要な操作を伝えます。ログイン後に認証済みコンテキストを再取得し、元の 同じ作業。CAPTCHAの無効化、管理者用登録API、トークンの要求は行わず、 実際の手順が終わる前に、アカウントや接続が準備済みと主張しないでください。 MCPツールにホストの再読み込みが必要なら、このアシスタントではローカルCLIも使えます。 アシスタント。次を実行します： `npx -y sosoapi auth status` を先に実行し、次を使います： `npx -y sosoapi auth login` ログインが必要な場合にのみ使用します。次の内容を読み取らないでください： 認証ファイルを読んだりトークンを表示したりしません。別プロフィールでログインが開いたら停止し、 保留ログインを止めてから、新しい `npx -y sosoapi auth login --no-open`. 本人が表示された新リンクを目的のプロフィールで開き、 承認前にログイン中の本人情報を確認してください。同じリンクを二つのプロフィールで同時に進めないでください。 使用するもの： `--help` で、インストールCLIにこの復旧フラグがあることを先に確認します。 なければ、架空のフラグを作らずバージョンの制限を説明します。 CLIから組み込みの契約を確認できます： ```sh npx -y sosoapi api contract --summary npx -y sosoapi api contract --route /studio-api/scheduled-posts/ ``` CLIリクエストの構文は `sosoapi api post < request.json`. ファイルツールでJSONを作り、ユーザー内容をシェルコマンドに直接展開しないでください。 コマンド。終了コードだけでなくhttp_statusとレスポンス本文を確認し、 コード。APIエラーは成功ではありません。次の正式なルートとスキーマのみを使います： 組み込み契約を確認します。名前の創作や不足権限の迂回は行いません。 ## 3. 本人のソーシャルアカウントを接続する SosoAPIのコンテキストから認証済みの組織とワークスペースを取得します。 IDを推測したり、黙って別のワークスペースを使ったりしないでください。もし 適切なブランドが複数ある場合は、本人の意図を確認します。 既存の接続が正常なら再利用し、それ以外は次を実行します： `npx -y sosoapi connect ` （instagram、threads、facebook、youtube、x） または本人に次を案内します： https://app.sosoapi.ai/connect. 本人がプロバイダーの 同意を進め、ブラウザーで正確なアカウントを確認します。本人が戻ったら、 アカウントと公開機能を再取得してください。接続コールバックは は公開権限の証拠ではありません。元の下書きを使い、本人に 内部IDをコピーしたり、コンテンツを作り直したりするよう本人に求めないでください。 ## 4. 元の投稿作業を完了する 本人の既存の依頼を使うか、宣伝したいものを尋ねます。次は行いません： テスト投稿を勝手に作りません。正確なアカウント、内容、メディア、 最初の送信前に現地日付・時刻を表示します。タイムゾーンが 不明です。最新のアカウント機能情報を取得してください。個人用Instagramアカウントや、不足している プロバイダーの権限には、対応アカウント種別や再接続が必要な場合があります。 Xは独自テキストとリンクのみです。mediaは空にします。Xのメディア、返信、 引用、リポスト、スレッド投稿には対応していません。 メディア対応の投稿先では先に登録します。ローカルファイルにはsosoapi_upload_assetを使い、 許可フォルダー内のファイルを使います。外部URLにはsosoapi_import_asset_urlを使い、 し、include_asset=trueでsosoapi_get_asset_import_statusを確認し、次の状態まで待ちます： 範囲を限定したインポートの準備が完了します。asset.idをmedia.asset_idに、 asset.asset_urlをmedia.urlに使用し、get_assetの別呼び出しは不要です。 同じインポートIDを維持し、再試行の案内に従い、最終状態で停止します： 失敗で停止します。要求の成功はデコード・インポート完了の証明ではありません。 停滞した場合は、このインポートのjob_idでsosoapi_job_statusを取得してから、 再び待つ前に確認します。保留中ジョブも実行エラーを持つ場合があります。サービス 設定エラーは運用担当者の対応が必要です。別のインポートや新たなソーシャル 接続または許可が必要です。完了したと主張せず、妨げている条件を報告します。 画像の準備が完了するまで確認します。 返された登録済みアセットIDと正規メディアURLを併用してください。次は行いません： 代わりに元の外部URLや一時的なプレビューURLで予約してはいけません。 既存の準備済みアセットは、ワークスペースと識別情報を確認してから再利用してください。 参考プレビューが役立つ場合はsosoapi_get_scheduled_post_eligibilityを使います。 任意であり、正規の作成・実行検証の代わりではありません。 正規のScheduled Postを使用 ツール。一つの投稿は一つの投稿先です。再試行には同じidempotency_keyを使います。 同じリクエストの再試行に使います。下書き変更は新しい要求です。タイムアウト後は、 別の操作をする前に既存の投稿を取得してください。不確かな書き込みを無条件に再送しないでください。 不確かなプロバイダー書き込みを再送しません。更新、キャンセル、明示的な再試行には、 現在のバージョンとサーバーの操作適格性。 結果では次を区別する必要があります： - 予約済み：指定日時で受理済み。まだ公開されていません。 - 処理中・照合中：最終結果は未確認です。再送しないでください。 - 公開済み：プロバイダーに裏付けられた最終結果が、その正確な投稿を確認した状態。 公開リンクが得られた場合に返します。 - 失敗・要対応：判明している事実と次に許可された操作を伝えます。 再度のアクセス許可が必要な場合のみ、該当するアカウントを再接続してください。 複数の投稿先は個別に報告します。一部成功で全体を 一部だけ成功したのに全体成功としません。将来の予約では次を返します： 投稿IDと受理された日時を返し、公開時刻まで会話を待機させないでください。 公開時刻まで待機させたり、ポーリングループを作ったりしません。戻った際に同じ投稿を再取得します。 本人は次の場所で同じ結果を再確認できます： https://app.sosoapi.ai/scheduled-posts/, 返された実際のIDを使用して SosoAPIによって提供されます。本人の認可済みログインが必要です。独自の 環境では、明示的に設定されたアプリのオリジンを使用します。 閉じたアシスタントの起動や、設定・確認されていない成功通知の送信を約束しないでください。 は設定・検証されていません。 ## 参照資料 - 人向けクイックスタート： https://app.sosoapi.ai/start - 製品ガイド： https://sosoapi.ai/ja/docs/quickstart - 対応範囲：Instagram、Threads、Facebookページ、YouTube、Xの独自 テキスト・リンク。形式と権限はアカウントで異なり、その他のプラットフォームは 本人が求めただけで利用可能と判断しないでください。