# 開発者向けの質問と回答 正規URL： https://sosoapi.ai/ja/docs/developer-faq npmエイリアス、APIとMCPの選択、認証、メディア、安全な再試行、レート制限、「公開済み」の意味を直接説明します。 ## 四つのnpmパッケージは別々のSDKですか？ いいえ。sosoapiまたは@sosoapi/cli、sosoapi-cli、sosoapi-mcpのいずれか一つをインストールします。エイリアスは同じ特定バージョンのCLI・MCP実装を使用するため、一つだけで十分です。 - [インストールとパッケージ](https://sosoapi.ai/ja/docs/installation) ## HTTP・CLI・MCPのどれを使うべきですか？ サーバーではHTTP、シェル自動化・スキーマ確認ではCLI、対応エージェントではMCPを使用できます。同じ公開API契約を使います。MCPにはローカルアップロードと、メディア準備を代行する画像URL投稿ツールもあります。サーバー認証情報をブラウザーコードに含めないでください。 - [完全なAPIリファレンス](https://sosoapi.ai/ja/docs/api) - [MCPツールリファレンス](https://sosoapi.ai/ja/docs/mcp) ## 設定やOAuthへの同意で投稿が公開されますか？ いいえ。設定で公開は行いません。OAuthの同意は選択範囲の継続アクセスを付与し、書き込みごとのブラウザー承認はありません。確認待ちにするタイミングをエージェントに伝え、公開依頼前にアカウント、内容、日時を確認してください。 - [認証と権限](https://sosoapi.ai/ja/docs/authentication) ## HTTP 200や202は公開済みを意味しますか？ いいえ。要求は受理済み・予約済み・処理中かもしれません。IDを保存し、同じScheduled Postの公開確認まで追跡します。リンクがあれば添え、投稿先ごとに結果を報告してください。 - [公開結果](https://sosoapi.ai/ja/docs/publishing-api-reference) ## タイムアウト後に再試行できますか？ 先に既存操作を確認します。投稿IDを保持し、同じ要求には同じ冪等性キーを使います。内容が変われば別要求です。再試行・更新・キャンセルは現在のバージョンと、その状態でSosoAPIが提供する操作を使います。 - [安全なエラー処理](https://sosoapi.ai/ja/docs/troubleshooting) ## クライアントにツールが表示されないのはなぜですか？ プロファイル、接続種別、サーバー再読み込みを確認します。coreは管理ツールを非表示にし、HTTPにはローカルアップロードがありません。提供状況はツールリファレンスを確認してください。プロファイル変更で権限や適格性は変わりません。 - [MCPツールリファレンス](https://sosoapi.ai/ja/docs/mcp) ## リモートMCPでローカルファイルをアップロードできますか？ いいえ。許可フォルダーのローカルMCPアップロードか、HTTPで公開URLをインポートします。準備完了後に登録IDと正規URLを併用してください。インポートの受理は処理中です。 - [MCPツールリファレンス](https://sosoapi.ai/ja/docs/mcp) ## レート制限とプラン制限は？ 各スキーマでフィールド、一覧、ページ取得の制限を確認します。studio-apiは人のセッションで一ユーザーあたり毎分240リクエスト、同じユーザーのマシン認証情報には別枠で毎分480リクエストを許可します。429とRetry-Afterに従ってください。プランの利用枠、プロバイダー制限、アカウント適格性は別です。大量実行前に最新の請求・機能情報を確認してください。 - [投稿APIの制限](https://sosoapi.ai/ja/docs/publishing-api-reference) ## Markdownとスキーマはどこにありますか？ ガイド、API操作、MCPツールのURLに.mdを付けるとMarkdown版を開けます。API索引は公開JSON契約とOpenAPI 3.1にリンクしています。ページ索引はllms.txt、両言語の完全なリファレンスはllms-full.txtです。公開文書であり、アカウントデータや認証情報は含みません。 - [完全なAPIリファレンス](https://sosoapi.ai/ja/docs/api) - [LLMインデックス](https://sosoapi.ai/ja/llms.txt) ## このドキュメントは検索表示やAIによる引用を保証しますか？ いいえ。HTML、正規URL、構造化メタデータ、Markdownは読み取りを助けますが、何を登録・順位付け・引用するかは検索エンジンやAIが決めます。ページへのアクセス可否とは別に確認してください。