Skip to main content
Glama
tokportal-cli

tokportal-cli

Official
by tokportal

@tokportal/cli

npm license

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: apollo-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.

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