Skip to main content
Glama
tokportal-cli

tokportal-cli

Official
by tokportal

@tokportal/cli

npm license

TokPortal は、管理されたソーシャルインフラストラクチャ API です。16 か国以上の人間のアカウントマネージャーによって作成、ウォームアップ、運用される、実際の TikTok、Instagram、YouTube アカウントを REST API および MCP サーバーとして公開します。アカウントごとの OAuth は不要、1 日 25 投稿の制限なし、アプリレビューも不要です。

ドキュメント https://developers.tokportal.com · API ベース https://app.tokportal.com/api/ext · OpenAPI https://developers.tokportal.com/openapi.json · MCP リモート https://app.tokportal.com/api/ext/mcp · API キーを取得 https://app.tokportal.com/developer/api-keys · llms.txt https://developers.tokportal.com/llms.txt


@tokportal/cli は、TokPortal API の公式コマンドラインインターフェースです。API 操作ごとに 1 つのコマンド、OpenAPI から生成、JSON 入力/JSON 出力 — スクリプト、CI、およびクイックチェックに最適です。Node 18+ が必要です。

インストール

npm install -g @tokportal/cli
# or without installing:
npx @tokportal/cli get-current-user

Related MCP server: apollo-mcp

30 秒クイックスタート

export TOKPORTAL_API_KEY=sk_your_key_here

# who am I / credit balance
tokportal get-current-user
tokportal get-credit-balance

# create a 1-video TikTok bundle in the USA and capture its id (credits are debited here)
BUNDLE_ID=$(tokportal create-bundle --body '{"bundle_type":"account_and_videos","platform":"tiktok","country":"USA","title":"US launch","videos_quantity":1}' | jq -r .data.id)

# upload the video from disk -> public_url
VIDEO_URL=$(tokportal upload-video-direct --file ./launch.mp4 --bundle_id "$BUNDLE_ID" | jq -r .data.public_url)

# configure the account profile + video slot 1, then publish
tokportal configure-bundle-account --id "$BUNDLE_ID" --body '{"username":"mybrand.us","visible_name":"My Brand","biography":"Official account"}'
tokportal configure-bundle-video --id "$BUNDLE_ID" --position 1 --body "{\"video_type\":\"video\",\"video_url\":\"$VIDEO_URL\",\"description\":\"Day 1 #launch\",\"target_publish_date\":\"2026-09-01\"}"
tokportal get-bundle-publish-readiness --id "$BUNDLE_ID"
tokportal publish-bundle --id "$BUNDLE_ID"

# follow progress
tokportal get-bundle --id "$BUNDLE_ID"
tokportal help   # list every generated command

リファレンス

npm install -g @tokportal/cli
export TOKPORTAL_API_KEY=sk_your_key_here

tokportal get-current-user
tokportal list-bundles --page 1 --per_page 25
tokportal create-bundle --body '{"bundle_type":"account_and_videos","country":"USA","videos_quantity":5}'
tokportal upload-video-direct --file ./video.mp4 --bundle_id 00000000-0000-0000-0000-000000000000

CLI は、API リクエストに X-TokPortal-Client: tokportal-cli/0.1.2 を送信し、可観測性とサポート診断を実現します。

マルチパートアップロードコマンドも OpenAPI から生成されます。バイナリフィールドには --file <path> を使用し、--bundle_id や --auto_publish などのフォームフィールドは通常のフラグとして渡します。

API 応答が失敗した場合、diagnostics オブジェクトが出力されます。このオブジェクトには、それらのヘッダーが利用可能な場合、request_id、retry_after_seconds、rate_limit が含まれます。

--idempotency-key は、対象となる変更操作にのみ使用してください。CLI は、資格情報の開示、確認コードの取得、Webhook の作成、署名付き画像/動画アップロード URL の作成、分析レポートの作成に対してローカルで拒否します。これらの応答には機密情報が含まれており、再生用に保存されることはないためです。

CLI は公開 OpenAPI スキーマから生成されます。tokportal help を使用して、生成されたコマンドを一覧表示します。

信頼できる情報源

このパッケージは、TokPortal のプライベートモノレポ内の TokPortal 公開 OpenAPI スキーマ (https://developers.tokportal.com/openapi.json) から生成されています。生成されたファイル (src/generated.ts) はリリースのたびに上書きされます。手動で編集しないでください。PR として受け入れられる内容については CONTRIBUTING.md を、脆弱性の報告については SECURITY.md を参照してください。

リンク

MIT © TokPortal

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      TikTok creator toolkit for AI assistants. Four tools: download watermark-free videos by URL, look up curated 15-hashtag sets for 15 niches with strategy tips, retrieve best posting times for 12 countries, and generate viral hook formulas across 8 categories. Stdio transport, runs via npx -y tiktapdown-mcp, no API keys, no signup, free. MIT license.
      10
      82 npm
      1
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Provides 45 MCP tools to search, enrich, and manage Apollo.io B2B data (people, companies, CRM, deals, tasks, sequences, etc.) via stdio or HTTP transport.
      45
      1
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Official MCP server for the TokPortal API, exposing 91 tools to create bundles, upload and publish videos, configure accounts, read analytics, and manage webhooks for real TikTok, Instagram, and YouTube accounts in any MCP client.
      91
      2,085 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables downloading TikTok videos and photos without watermarks, extracting metadata and analytics, and performing bulk downloads of user profiles via CLI or as an MCP server for AI assistants.
      5
      1
      MIT