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

{
  "name": "instagram_search",
  "displayName": "Instagram 搜索",
  "description": "按关键词搜索 Instagram 用户/品牌账号，返回匹配的用户列表。用于竞品品牌 Instagram 账号发现、红人搜索。",
  "category": "social-media",
  "version": "1.0.0",
  "endpoint": {
    "method": "GET",
    "url": "https://server.fmode.cn/thapi/v1/instagram/v1/fetch_search",
    "headers": {
      "Authorization": "Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==",
      "Accept": "application/json"
    }
  },
  "parameters": {
    "type": "object",
    "required": ["query"],
    "properties": {
      "query": {
        "type": "string",
        "description": "搜索关键词，如品牌名 'NEST New York'、'Paddywax'、'SpaRoom'"
      },
      "select": {
        "type": "string",
        "description": "搜索类型: 'users'=搜索用户, 'hashtags'=搜索标签",
        "default": "users",
        "enum": ["users", "hashtags"]
      }
    }
  },
  "requestTransform": {
    "queryParams": {
      "query": "{{query}}",
      "select": "{{select}}"
    }
  },
  "response": {
    "type": "object",
    "description": "搜索结果",
    "properties": {
      "users": {
        "type": "array",
        "description": "匹配的用户列表",
        "items": {
          "type": "object",
          "properties": {
            "user": {
              "type": "object",
              "properties": {
                "pk": { "type": "string", "description": "用户数字 ID（用于获取帖子）" },
                "username": { "type": "string", "description": "用户名" },
                "full_name": { "type": "string", "description": "显示名称" },
                "is_verified": { "type": "boolean", "description": "是否认证" },
                "profile_pic_url": { "type": "string", "description": "头像 URL" },
                "follower_count": { "type": "integer", "description": "粉丝数" },
                "is_private": { "type": "boolean", "description": "是否私密账号" }
              }
            }
          }
        }
      }
    }
  },
  "notes": "搜索结果中的 user.pk 可用于 instagram_user_posts 接口获取帖子列表。username 可用于 instagram_user_info 获取详细资料。",
  "usageExamples": [
    {
      "name": "搜索 NEST New York 品牌",
      "input": { "query": "NEST New York", "select": "users" },
      "description": "搜索 NEST New York 的 Instagram 品牌账号"
    },
    {
      "name": "搜索 Paddywax 品牌",
      "input": { "query": "Paddywax", "select": "users" },
      "description": "搜索 Paddywax 的 Instagram 品牌账号"
    }
  ],
  "reportMapping": {
    "slides": ["竞品对标(Slide4)", "知识中心(Slide11)"],
    "dataPoints": ["品牌IG账号发现", "粉丝数初步数据"]
  }
}