openclaw-voc-skill/social-media/instagram-user-info/api-config.json

{
  "name": "instagram_user_info",
  "displayName": "Instagram 用户详情",
  "description": "根据用户名获取 Instagram 用户的完整资料，包括粉丝数、关注数、帖子数、个人简介、是否认证等。用于竞品品牌社媒画像分析、红人详情获取。",
  "category": "social-media",
  "version": "1.0.0",
  "endpoint": {
    "method": "GET",
    "url": "https://server.fmode.cn/thapi/v1/instagram/v1/fetch_user_info_by_username_v3",
    "headers": {
      "Authorization": "Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==",
      "Accept": "application/json"
    }
  },
  "parameters": {
    "type": "object",
    "required": ["username"],
    "properties": {
      "username": {
        "type": "string",
        "description": "Instagram 用户名（不含@），如 'nestnewyork'、'paddywax'"
      }
    }
  },
  "requestTransform": {
    "queryParams": {
      "username": "{{username}}"
    }
  },
  "response": {
    "type": "object",
    "description": "用户详细资料",
    "properties": {
      "user": {
        "type": "object",
        "properties": {
          "pk": { "type": "string", "description": "用户数字 ID" },
          "username": { "type": "string", "description": "用户名" },
          "full_name": { "type": "string", "description": "显示名称" },
          "biography": { "type": "string", "description": "个人简介" },
          "follower_count": { "type": "integer", "description": "粉丝数" },
          "following_count": { "type": "integer", "description": "关注数" },
          "media_count": { "type": "integer", "description": "帖子总数" },
          "is_verified": { "type": "boolean", "description": "是否蓝V认证" },
          "is_business": { "type": "boolean", "description": "是否商业账号" },
          "category": { "type": "string", "description": "账号类别" },
          "external_url": { "type": "string", "description": "外部链接（如品牌官网）" },
          "profile_pic_url_hd": { "type": "string", "description": "高清头像 URL" }
        }
      }
    }
  },
  "notes": "返回的 pk（用户数字 ID）可用于 instagram_user_posts 接口获取帖子列表。media_count 对应报告中的帖子数（如 Paddywax 3,095 条）。",
  "usageExamples": [
    {
      "name": "获取 NEST New York IG 详情",
      "input": { "username": "nestnewyork" },
      "description": "获取 NEST New York 的 IG 粉丝数（报告中显示 144,102）、帖子数等"
    },
    {
      "name": "获取 Paddywax IG 详情",
      "input": { "username": "paddywax" },
      "description": "获取 Paddywax 的 IG 粉丝数（报告中显示 126,441）和帖子数（3,095 条）"
    },
    {
      "name": "获取 SpaRoom IG 详情",
      "input": { "username": "sparoom" },
      "description": "获取 SpaRoom 的 IG 数据（报告中显示极低存在感）"
    }
  ],
  "reportMapping": {
    "slides": ["竞品对标(Slide4)", "知识中心(Slide11)"],
    "dataPoints": ["IG粉丝数", "帖子总数", "认证状态", "品牌简介", "外部链接"]
  }
}