@tokportal/cli

TokPortal es la API de infraestructura social gestionada: cuentas reales de TikTok, Instagram y YouTube creadas, calentadas y operadas por gestores de cuentas humanos en más de 16 países, expuestas como una API REST y un servidor MCP. Sin OAuth por cuenta, sin límite de 25 publicaciones/día, sin revisión de aplicaciones.

Documentación https://developers.tokportal.com · API base https://app.tokportal.com/api/ext · OpenAPI https://developers.tokportal.com/openapi.json · MCP remoto https://app.tokportal.com/api/ext/mcp · Obtén una clave API https://app.tokportal.com/developer/api-keys · llms.txt https://developers.tokportal.com/llms.txt

@tokportal/cli es la interfaz de línea de comandos oficial para la API de TokPortal. Un comando por operación de la API, generado a partir de OpenAPI, JSON de entrada / JSON de salida — ideal para scripts, CI y comprobaciones rápidas. Requiere Node 18+.

Instalar

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

Related MCP server: TikTapDown MCP

Inicio rápido en 30 segundos

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

Referencia

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

La CLI envía X-TokPortal-Client: tokportal-cli/0.1.2 en las solicitudes a la API para observabilidad y diagnóstico de soporte.

Los comandos de carga multiparte también se generan a partir de OpenAPI. Usa --file <ruta> para el campo binario y pasa los campos de formulario como --bundle_id o --auto_publish como banderas normales.

Las respuestas fallidas de la API se imprimen con un objeto diagnostics que contiene request_id, retry_after_seconds y rate_limit cuando esos encabezados están disponibles.

Usa --idempotency-key solo para mutaciones elegibles. La CLI lo rechaza localmente para revelación de credenciales, recuperación de código de verificación, creación de webhooks, creación de URL de carga de imágenes/videos firmados y creación de informes de análisis, porque esas respuestas contienen secretos y nunca se almacenan para reproducción.

La CLI se genera a partir del esquema OpenAPI público. Usa tokportal help para listar los comandos generados.

Fuente de veracidad

Este paquete se genera a partir del esquema OpenAPI público de TokPortal (https://developers.tokportal.com/openapi.json) en el monorepositorio privado de TokPortal. Los archivos generados (src/generated.ts) se sobrescriben en cada lanzamiento — no los edites manualmente. Consulta CONTRIBUTING.md para saber qué aceptamos como PRs y SECURITY.md para informar vulnerabilidades.

Enlaces

• Documentación: https://developers.tokportal.com

• Guía de SDKs y CLI: https://developers.tokportal.com/sdks-cli

• Servidor MCP: https://developers.tokportal.com/mcp · tokportal-mcp

• Referencia de la API (OpenAPI): https://developers.tokportal.com/openapi.json

• Otros paquetes: @tokportal/node · @tokportal/cli · tokportal (PyPI) · github.com/tokportal/tokportal-go

MIT © TokPortal