@tokportal/cli

TokPortal — это управляемый API социальной инфраструктуры: реальные аккаунты TikTok, Instagram и YouTube, созданные, прогретые и управляемые менеджерами аккаунтов в 16+ странах, предоставляемые как REST API и MCP-сервер. Никакого OAuth на аккаунт, никакого лимита в 25 постов в день, никакой проверки приложения.

Документация https://developers.tokportal.com · Базовый URL 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 — это официальный интерфейс командной строки для API TokPortal. Одна команда на каждую операцию API, сгенерированная из OpenAPI, JSON на входе / JSON на выходе — идеально подходит для скриптов, CI и быстрых проверок. Требуется Node 18+.

Install

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

Related MCP server: TikTapDown MCP

30-second quickstart

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

Reference

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 отправляет заголовок X-TokPortal-Client: tokportal-cli/0.1.2 в API-запросах для наблюдаемости и диагностики поддержки.

Команды многокомпонентной загрузки также генерируются из OpenAPI. Используйте --file <path> для бинарного поля и передавайте поля формы, такие как --bundle_id или --auto_publish, как обычные флаги.

Неудачные ответы API выводятся с объектом diagnostics, содержащим request_id, retry_after_seconds и rate_limit, когда эти заголовки доступны.

Используйте --idempotency-key только для подходящих мутаций. CLI отклоняет его локально для раскрытия учётных данных, получения кода подтверждения, создания вебхука, создания подписанного URL для загрузки изображений/видео и создания отчёта аналитики, поскольку эти ответы содержат секреты и никогда не сохраняются для повторного воспроизведения.

CLI генерируется из публичной схемы OpenAPI. Используйте tokportal help для вывода списка сгенерированных команд.

Source of truth

Этот пакет генерируется из публичной схемы OpenAPI TokPortal (https://developers.tokportal.com/openapi.json) в приватном монорепозитории TokPortal. Сгенерированные файлы (src/generated.ts) перезаписываются при каждом релизе — не редактируйте их вручную. Смотрите CONTRIBUTING.md о том, какие PR мы принимаем, и SECURITY.md для сообщения об уязвимостях.

Links

• Документация: https://developers.tokportal.com

• Руководство по SDK и CLI: https://developers.tokportal.com/sdks-cli

• MCP-сервер: https://developers.tokportal.com/mcp · tokportal-mcp

• Справочник API (OpenAPI): https://developers.tokportal.com/openapi.json

• Другие пакеты: @tokportal/node · @tokportal/cli · tokportal (PyPI) · github.com/tokportal/tokportal-go

MIT © TokPortal