openclaw-voc-skill/social-media/tiktok-user-profile/api-config.json

{
  "name": "tiktok-user-profile",
  "displayName": "TikTok 用户详情",
  "description": "根据用户名获取 TikTok 用户的完整资料，包括粉丝数、获赞数、作品数、个人简介等。用于竞品品牌社媒画像、红人详情分析。",
  "category": "social-media",
  "version": "1.0.0",
  "endpoint": {
    "method": "GET",
    "url": "https://server.fmode.cn/thapi/v1/tiktok/web/fetch_user_profile",
    "headers": {
      "Authorization": "Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==",
      "Accept": "application/json"
    }
  },
  "parameters": {
    "type": "object",
    "required": [
      "uniqueId"
    ],
    "properties": {
      "uniqueId": {
        "type": "string",
        "description": "TikTok 用户名（不含@），如 'nestnewyork'、'dealwhisperer'"
      }
    }
  },
  "requestTransform": {
    "queryParams": {
      "uniqueId": "{{uniqueId}}"
    }
  },
  "response": {
    "type": "object",
    "description": "用户详情",
    "properties": {
      "user": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "用户 ID"
          },
          "uniqueId": {
            "type": "string",
            "description": "用户名"
          },
          "nickname": {
            "type": "string",
            "description": "昵称"
          },
          "signature": {
            "type": "string",
            "description": "个人简介"
          },
          "verified": {
            "type": "boolean",
            "description": "是否认证"
          },
          "avatarLarger": {
            "type": "string",
            "description": "头像 URL"
          },
          "secUid": {
            "type": "string",
            "description": "安全用户 ID（用于获取帖子）"
          }
        }
      },
      "stats": {
        "type": "object",
        "properties": {
          "followerCount": {
            "type": "integer",
            "description": "粉丝数"
          },
          "followingCount": {
            "type": "integer",
            "description": "关注数"
          },
          "heart": {
            "type": "integer",
            "description": "获赞总数"
          },
          "heartCount": {
            "type": "integer",
            "description": "获赞总数（别名）"
          },
          "videoCount": {
            "type": "integer",
            "description": "作品总数"
          },
          "diggCount": {
            "type": "integer",
            "description": "点赞数"
          }
        }
      }
    }
  },
  "notes": "返回的 secUid 可用于 tiktok_user_posts 接口获取用户发布的视频列表。",
  "usageExamples": [
    {
      "name": "查看竞品品牌 TikTok 账号",
      "input": {
        "uniqueId": "nestnewyork"
      },
      "description": "获取 NEST New York 的 TikTok 粉丝数和互动数据（报告中显示 12,700 粉丝）"
    },
    {
      "name": "查看达人详情",
      "input": {
        "uniqueId": "dealwhisperer"
      },
      "description": "获取达人 @dealwhisperer 的完整资料（报告中显示 2.1M 粉丝）"
    }
  ],
  "reportMapping": {
    "slides": [
      "竞品对标(Slide4)",
      "红人达人库(Slide11)"
    ],
    "dataPoints": [
      "TikTok粉丝数",
      "获赞总数",
      "作品数",
      "互动率"
    ]
  },
  "timeout": 15000,
  "retry": {
    "maxAttempts": 3,
    "delay": 1500,
    "backoffMultiplier": 2
  }
}