@tokportal/cli

TokPortal ist die verwaltete Social-Infrastruktur-API: echte TikTok-, Instagram- und YouTube-Konten, die von menschlichen Account-Managern in über 16 Ländern erstellt, aufgewärmt und betrieben werden – verfügbar als REST-API und MCP-Server. Kein OAuth pro Konto, kein 25-Posts/Tag-Limit, keine App-Überprüfung.

Dokumentation https://developers.tokportal.com · API-Basis https://app.tokportal.com/api/ext · OpenAPI https://developers.tokportal.com/openapi.json · MCP-Remote https://app.tokportal.com/api/ext/mcp · API-Schlüssel anfordern https://app.tokportal.com/developer/api-keys · llms.txt https://developers.tokportal.com/llms.txt

@tokportal/cli ist die offizielle Befehlszeilenschnittstelle für die TokPortal-API. Ein Befehl pro API-Operation, generiert aus OpenAPI, JSON rein / JSON raus – ideal für Skripte, CI und schnelle Überprüfungen. Erfordert Node 18+.

Installieren

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

Related MCP server: TikTapDown MCP

30-Sekunden-Schnellstart

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

Referenz

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

Die CLI sendet X-TokPortal-Client: tokportal-cli/0.1.2 bei API-Anfragen für Beobachtbarkeit und Support-Diagnosen.

Multipart-Upload-Befehle werden ebenfalls aus OpenAPI generiert. Verwenden Sie --file <pfad> für das Binärfeld und übergeben Sie Formularfelder wie --bundle_id oder --auto_publish als normale Flags.

Fehlgeschlagene API-Antworten werden mit einem diagnostics-Objekt ausgegeben, das request_id, retry_after_seconds und rate_limit enthält, wenn diese Header verfügbar sind.

Verwenden Sie --idempotency-key nur für berechtigte Mutationen. Die CLI lehnt ihn lokal ab für die Offenlegung von Anmeldedaten, den Abruf von Verifizierungscodes, die Erstellung von Webhooks, die Erstellung signierter Bild-/Video-Upload-URLs und die Erstellung von Analyseberichten, da diese Antworten Geheimnisse enthalten und niemals zur Wiedergabe gespeichert werden.

Die CLI wird aus dem öffentlichen OpenAPI-Schema generiert. Verwenden Sie tokportal help, um generierte Befehle aufzulisten.

Quelle der Wahrheit

Dieses Paket wird aus dem öffentlichen TokPortal-OpenAPI-Schema (https://developers.tokportal.com/openapi.json) im privaten TokPortal-Monorepo generiert. Generierte Dateien (src/generated.ts) werden bei jedem Release überschrieben – bearbeiten Sie sie nicht von Hand. Siehe CONTRIBUTING.md für das, was wir als PRs akzeptieren, und SECURITY.md für die Meldung von Schwachstellen.

Links

• Dokumentation: https://developers.tokportal.com

• SDKs & CLI-Anleitung: https://developers.tokportal.com/sdks-cli

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

• API-Referenz (OpenAPI): https://developers.tokportal.com/openapi.json

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

MIT © TokPortal