Skip to main content
Glama
tokportal

tokportal-cli

Official
by tokportal

@tokportal/cli

npm license

TokPortal 是托管式社交基础设施 API:由 16 个以上国家/地区的人类账户经理创建、预热和运营的真实 TikTok、Instagram 和 YouTube 账户——以 REST API 和 MCP 服务器形式提供。无需每个账户的 OAuth,没有每天 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 操作对应一个命令,基于 OpenAPI 生成,JSON 输入/JSON 输出——非常适合脚本、CI 和快速检查。需要 Node 18+。

安装

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

Related MCP server: TikTapDown 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 <路径>,并将表单字段(如 --bundle_id--auto_publish)作为常规标志传递。

失败的 API 响应会打印一个 diagnostics 对象,其中包含 request_idretry_after_secondsrate_limit(当这些标头可用时)。

仅对符合条件的变更操作使用 --idempotency-key。CLI 会在本地拒绝用于凭据泄露、验证码检索、Webhook 创建、签名图片/视频上传 URL 创建以及分析报告创建,因为这些响应包含机密信息且不会存储用于重放。

CLI 是从公共 OpenAPI 模式生成的。使用 tokportal help 列出生成的命令。

事实来源

此包是从 TokPortal 公共 OpenAPI 模式(https://developers.tokportal.com/openapi.json)在私有 TokPortal 单体仓库中生成的。生成的文件(src/generated.ts)会在每次发布时被覆盖——请勿手动编辑。有关我们接受的 PR 内容,请参阅 CONTRIBUTING.md;有关漏洞报告,请参阅 SECURITY.md

链接

MIT © TokPortal

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    C
    quality
    D
    maintenance
    MCP server for LamaTok TikTok data API — auto-generates 20+ tools from the live OpenAPI spec (users, videos, hashtags, music, comments). Local stdio via npx -y lamatok-mcp, requires only LAMATOK_KEY.
    19
    12
    1
    MIT
  • A
    license
    A
    quality
    A
    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
    41
    1
    MIT
  • A
    license
    B
    quality
    B
    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
    B
    quality
    C
    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
    1,163
    MIT

View all related MCP servers

Related MCP Connectors

  • Create, schedule and publish social posts to TikTok, Instagram, Facebook and YouTube.

  • Publish, schedule, and manage social media posts across major platforms via the Postproxy API.

  • Social media MCP: publish, schedule & analyze posts on TikTok, Instagram, YouTube, LinkedIn & X

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tokportal/tokportal-cli'

If you have feedback or need assistance with the MCP directory API, please join our Discord server