TokPortal

通过 TokPortal 平台统一管理大规模社交媒体账号创建、视频分发及数据分析。本技能通过专用 MCP 服务器暴露 30 个工具，使您的 AI 智能体能够规模化地全面控制 TikTok 和 Instagram 运营。

配置步骤

1. 获取您的 API 密钥

请访问 tokportal.com 注册账号，并在 app.tokportal.com/developer/api-keys 页面生成 API 密钥。

2. 安装 MCP 服务器

推荐通过 MCP 服务器方式将 TokPortal 与 OpenClaw 集成：

npm install -g tokportal-mcp

3. 配置 OpenClaw

在您的 ~/.openclaw/openclaw.json 中添加以下内容：

{
  "skills": {
    "entries": {
      "tokportal": {
        "enabled": true,
        "apiKey": "tok_live_your_key_here"
      }
    }
  }
}

或设置环境变量：

export TOKPORTAL_API_KEY="tok_live_your_key_here"

4. 添加 MCP 服务器配置

在您的 MCP 配置文件中添加（Cursor 对应 .cursor/mcp.json，Claude Desktop 对应 claude_desktop_config.json）：

{
  "mcpServers": {
    "tokportal": {
      "command": "npx",
      "args": ["-y", "tokportal-mcp"],
      "env": {
        "TOKPORTAL_API_KEY": "tok_live_your_key_here"
      }
    }
  }
}

可用工具（共 30 个）

信息类（6 个工具）

• get_me — 获取您的个人资料、余额信息及 API 密钥详情
• get_credit_balance — 获取详细余额信息（含到期时间）
• get_credit_history — 获取余额交易历史（支持分页）
• get_countries — 获取支持账号创建的国家列表
• get_platforms — 获取支持的平台（TikTok、Instagram）及其功能特性
• get_credit_costs — 获取全部操作对应的完整积分消耗对照表

套餐类（8 个工具）

• create_bundle — 创建一个套餐（仅账号、账号+视频、或仅视频）
• create_bulk_bundles — 性能最大化：一次性批量创建多个套餐
• list_bundles — 按状态/平台等条件筛选并列出所有套餐
• get_bundle — 获取套餐完整状态，包括账号配置与视频详情
• publish_bundle — 发布已配置完成的套餐（提交至账号管理员上线）
• unpublish_bundle — 将已发布套餐撤回为草稿状态
• add_video_slots — 向已有套餐追加视频插槽（每插槽 2 积分）
• add_edit_slots — 向已有套餐追加编辑插槽（每插槽 3 积分）

账号配置类（4 个工具）

• get_account_config — 查看当前账号配置
• configure_account — 设置用户名、显示名称、简介、头像等基础信息
• finalize_account — 批准处于审核中的账号
• request_account_corrections — 针对特定字段发起修改请求

视频类（6 个工具）

• list_videos — 列出某套餐下的全部视频
• configure_video — 单条视频配置（标题文案、发布时间、媒体 URL、音效设置等）
• batch_configure_videos — 批量配置多条视频
• finalize_video — 批准处于审核中的视频
• request_video_corrections — 针对某条视频发起修改请求
• unschedule_video — 取消已排期的视频发布

已交付账号类（3 个工具）

• list_accounts — 按条件筛选并列出您已获得的所有账号
• get_account_detail — 获取指定账号的完整凭证及配套 TokMail 邮箱地址
• get_verification_code — 获取最新收到的 6 位验证码

数据分析类（4 个工具）

• get_analytics — 获取粉丝数、播放量、互动率等核心指标
• refresh_analytics — 手动触发数据刷新（冷却时间 48 小时，每月上限 500 次）
• can_refresh_analytics — 查询当前是否可执行数据刷新
• get_video_analytics — 获取单条视频的详细数据（播放量、点赞数、互动率等）

上传类（2 个工具 — 仅 MCP 支持）

• upload_video — 上传本地视频文件，返回公开可访问的 URL
• upload_image — 上传本地图片文件（用于轮播图或头像等场景）

典型工作流示例

创建一个带 5 条视频的 TikTok 账号

“在美国创建一个 TikTok 套餐，包含 5 条视频，并启用健身垂类预热（niche warming）”

智能体会调用 create_bundle 并传入相应参数，随后引导您完成账号与视频的配置流程。

查看账号数据分析

“展示我所有已交付账号的数据分析结果”

智能体会先调用 list_accounts 获取账号列表，再对每个账号依次调用 get_analytics。

批量视频分发

“在法国创建 10 个 TikTok 账号，每个账号配 3 条视频”

使用 create_bulk_bundles（Performance Max）接口，在单次调用中完成全部套餐创建。

API 参考文档

• 基础 URL： https://app.tokportal.com/api/ext
• 认证方式： 使用 X-API-Key 请求头
• 速率限制： 每个 API 密钥每分钟最多 120 次请求
• 完整文档： developers.tokportal.com

积分体系

TokPortal 采用基于积分的计费模型（1 积分 = 1 美元）：

• 账号创建：依国家而定，5–8 积分
• 视频上传：每条视频 2 积分
• 垂类预热（niche warming）：7 积分
• 深度预热（Instagram deep warming）：40 积分
• 评论审核（comment moderation）：25 积分
• 视频编辑（video editing）：每次编辑插槽 3 积分

技术支持

• 文档中心：developers.tokportal.com
• 联系支持：team@tokportal.com
• npm 包名：tokportal-mcp