openclaw-voc-skill/openclaw-skills/douyin/douyin-user-posts/api-config.json

{
  "name": "douyin-user-posts",
  "displayName": "抖音账号近期作品列表",
  "description": "根据 sec_user_id 获取抖音账号近期发布作品，用于对标账号监听和口播爆款内容拆解。已验证 user_id/sec_user_id 可返回近期作品。",
  "category": "douyin",
  "version": "0.1.0",
  "endpoint": {
    "method": "GET",
    "url": "https://server.fmode.cn/api/voc-social/douyin/app/v3/fetch_user_post_videos",
    "headers": {
      "Authorization": "Bearer ${vocToken}",
      "Accept": "application/json"
    }
  },
  "parameters": {
    "type": "object",
    "required": ["sec_user_id"],
    "properties": {
      "sec_user_id": {
        "type": "string",
        "description": "抖音账号 sec_user_id"
      },
      "max_cursor": {
        "type": "integer",
        "default": 0,
        "description": "翻页游标，首次请求传 0"
      },
      "count": {
        "type": "integer",
        "default": 10,
        "description": "单页作品数量"
      }
    }
  },
  "requestTransform": {
    "queryParams": {
      "sec_user_id": "{{sec_user_id}}",
      "max_cursor": "{{max_cursor}}",
      "count": "{{count}}"
    }
  },
  "response": {
    "type": "object",
    "description": "账号近期作品列表（顶层 {code, data}，作品通常在 data.aweme_list 内）",
    "properties": {
      "code": { "type": "integer" },
      "data": {
        "type": "object",
        "properties": {
          "aweme_list": { "type": "array" },
          "has_more": { "type": "integer" },
          "max_cursor": { "type": "integer" }
        }
      }
    },
    "keyFields": {
      "data.aweme_list[].aweme_id": "作品 ID",
      "data.aweme_list[].desc": "作品描述",
      "data.aweme_list[].author.sec_uid": "作者 sec_user_id",
      "data.aweme_list[].author.nickname": "作者昵称",
      "data.aweme_list[].statistics.digg_count": "点赞数",
      "data.aweme_list[].statistics.comment_count": "评论数",
      "data.aweme_list[].statistics.share_count": "分享数",
      "data.aweme_list[].statistics.play_count": "播放数",
      "data.aweme_list[].create_time": "发布时间"
    }
  },
  "workflow": {
    "description": "推荐调用链",
    "steps": [
      "上游: 用户提供 sec_user_id，或 douyin-user-search(keyword) → 用户确认候选账号 → 取 user_id/sec_uid",
      "本步: douyin-user-posts(sec_user_id) → 拉取账号近期作品",
      "下游: douyin-video-detail / douyin-video-comments / douyin-comment-replies → 内容拆解与日报"
    ]
  },
  "timeout": 60000,
  "retry": { "maxAttempts": 2, "delay": 1500, "backoffMultiplier": 2 },
  "tokenConfig": {
    "type": "bearer",
    "configFile": "~/.openclaw/voc-credentials.json",
    "tokenField": "vocToken",
    "resolutionOrder": ["configFile"],
    "apigId": "Vo3ROWEvDy"
  },
  "verification": {
    "status": "verified",
    "source": "scripts/tools/probe-douyin-share.js uses TikHub /api/v1/douyin/app/v3/fetch_user_post_videos",
    "lastChecked": "2026-05-08",
    "note": "server.fmode.cn /api/voc-social/douyin/app/v3/fetch_user_post_videos with douyin-user-search user_id returned aweme_list successfully.",
    "hardStopOnFailure": true
  }
}