コマンド一覧
SNS Creator Studio が提供するコマンドとオプションの一覧です。 手順に沿った説明は 使い方 をご覧ください。
ttops [--format json|table] [--account <name>] <command>
--format の既定は json です。人が読む場合は --format table を指定します。
複数のアカウントを登録している場合は --account <name> で対象を切り替えます。
認証
| コマンド | 内容 |
|---|---|
auth login [--scopes <groups>] [--no-open] |
ブラウザで TikTok の認可画面を開き、アカウントを連携する |
auth whoami |
現在連携しているアカウントを表示する |
auth list |
登録済みのアカウントを一覧する |
auth switch <account> |
既定で使うアカウントを切り替える |
auth logout |
TikTokトークンを失効させ、サーバーと端末の認証情報を削除する |
--scopes はカンマ区切りで指定します。basic は常に付与されます。
| 値 | スコープ | 用途 |
|---|---|---|
basic |
user.info.basic |
アカウントの識別と表示名の取得 |
video |
video.list |
自分の投稿と実績の取得 |
upload |
video.upload |
下書きへの送信 |
publish |
video.publish |
公開まで行う投稿 |
投稿の確認
| コマンド | 内容 |
|---|---|
video list [--limit <n>] [--since <YYYY-MM-DD>] [--no-stats] |
自分の投稿を一覧する |
video get <ids...> [--no-stats] |
指定した投稿を取得する |
video profile |
連携しているアカウントの表示名とアバターを取得する |
取得できる指標は view_count（再生数）、like_count（いいね数）、comment_count（コメント数）、share_count（シェア数）の4つです。
動画の投稿
| コマンド | 内容 |
|---|---|
post creator-info |
そのアカウントで選べる公開範囲と、許可されている操作を取得する |
post video <file> [options] |
動画を投稿する。--apply が無い場合は確認のみ |
post status <publishId> |
投稿の処理状況を確認する |
post uploads |
中断した投稿の再開情報を一覧する |
post video のオプション
| オプション | 内容 |
|---|---|
--privacy <level> |
公開範囲。直接投稿では必須（既定値なし） |
--title <text> |
タイトル |
--draft |
公開せず TikTok アプリの下書きに送る |
--allow-comment |
コメントを許可する（既定はオフ） |
--allow-duet |
デュエットを許可する（既定はオフ） |
--allow-stitch |
ステッチを許可する（既定はオフ） |
--cover-ms <ms> |
カバー画像に使う位置をミリ秒で指定する |
--brand-organic |
自社の宣伝であることを開示する |
--brand-content |
第三者からの対価を伴う宣伝であることを開示する |
--aigc |
AI 生成コンテンツであることを開示する |
--chunk-size <bytes> |
分割送信のチャンクサイズ |
--resume <publishId> |
中断した投稿を続きから再開する |
--apply |
実際に投稿する。付けない場合は確認画面を表示して終了する |
--apply を付けない限り投稿されません。
付けない場合は、投稿先アカウント・ファイル・公開範囲・許可する操作・開示の設定を表示して終了します。
出力
標準出力は機械可読なデータ専用です。進捗や警告は標準エラー出力に分けています。
--format table を指定すると人が読みやすい表形式になります。環境変数 TTOPS_FORMAT=table でも同じ指定ができます。
エラーは標準エラー出力に 1 行の JSON として出ます。
{"error":{"code":"AUTH_REQUIRED","message":"not authenticated. Run: ttops auth login","retryable":false,"retryAfter":null}}
| 終了コード | 意味 |
|---|---|
| 0 | 成功 |
| 1 | 内部エラー |
| 2 | 引数が不正 |
| 3 | 未認証、または認証に失敗 |
| 4 | レート制限 |
| 5 | TikTok API のエラー |
設定ファイルの保存先
端末側の設定は、次の優先順位で利用者のコンピュータに保存されます。
$TTOPS_CONFIG_DIR → $XDG_CONFIG_HOME/ttops → ~/.config/ttops の順に解決します。
| ファイル | 内容 |
|---|---|
tokens.json |
アカウントごとの短期Access Tokenと認証サーバー用セッション資格情報 |
uploads.json |
中断した投稿の再開情報（24 時間で失効） |
TikTokのRefresh TokenとClient Secretは利用者のコンピュータには保存されません。秘匿情報を含むファイルはパーミッション 0600 で保存し、書き込みは一時ファイルからの原子的な置換で行います。
これらのファイルを削除すれば、手元のデータは完全に消去されます。