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账号发现",
      "粉丝数初步数据"
    ]
  },
  "timeout": 15000,
  "retry": {
    "maxAttempts": 3,
    "delay": 1500,
    "backoffMultiplier": 2
  }
}