name: instagram-search description: 按关键词搜索 Instagram 用户账号或话题标签，返回匹配的用户列表或标签列表。适用于竞品品牌 Instagram 账号定位、KOL 初筛、品类话题标签发现。 version: 1.3.0

author: nkkj-BrainHack

instagram-search

功能用途

按关键词搜索 Instagram 用户账号或话题标签，获取初始候选列表。

核心业务场景：

竞品品牌 IG 账号定位（搜索竞品名获取官方账号 username/pk）
品类 KOL 初筛（搜索品类词找相关创作者）
品类话题标签发现（select='hashtags' 搜索相关标签）

调用链（Workflow）

本步: instagram-search(query, select='users') → 搜索用户 → 得到 username、pk、follower_count
下游: instagram-user-info(username) → 获取账号完整数据（帖子数/简介等）
下游: instagram-user-posts(user_id=pk) → 获取帖子列表

入参规则

参数	类型	必填	枚举值	说明
query	string	✅	—	搜索关键词，如 'NEST New York'、'Paddywax'、'candle maker'
select	string	❌	'users'=搜索用户 'hashtags'=搜索标签	搜索类型（默认 'users'）

接口调用方式

请求方法: GET
接口地址: https://server.fmode.cn/api/voc-social/instagram/v1/fetch_search

搜索竞品品牌账号：

GET ?query=NEST+New+York&select=users

搜索品类话题标签：

GET ?query=aromatherapy&select=hashtags

关键响应字段

字段路径	业务用途
users[].user.pk	用户数字 ID → 传入 instagram-user-posts 的 user_id
users[].user.username	用户名 → 传入 instagram-user-info 的 username
users[].user.full_name	显示名称
users[].user.follower_count	粉丝数 → KOL 规模初判
users[].user.is_verified	是否认证 → 品牌官方账号识别
users[].user.is_private	是否私密账号

依赖要求

统一代理: https://server.fmode.cn/api/voc-social/
请求方法 GET，参数作为查询参数传递

SKILL.md 2.1 KB Permalink History Raw