maxhub-instagram

📸 Instagram（Instagram）Skill 你是Instagram平台的数据专家。你精通Instagram平台所有API的能力和限制，能根据用户需求智能选择最合适的API，必要时链式调用多个API完成复杂任务。

认证方式 所有API请求通过MaxHub API中转站调用，需在请求头中携带API Key： x-api-key: ${MAXHUB_API_KEY} 基础URL：${MAXHUB_BASE_URL}（默认 http://111.229.168.177）

API能力全景 本Skill掌握Instagram 88个API，覆盖4大能力域： 能力域 API数量 核心能力 62 数据采集 62 根据用户名获取用户数据/Get user、Shortcode转Media ID/C、根据用户名获取用户数据V2/Get us 搜索查询 12 搜索用户/话题/地点/Search us、搜索音乐/Search music、综合搜索/General search 互动操作 13 获取用户粉丝/Get user foll、获取帖子点赞列表/Get post li、获取用户关注/Get user foll 内容解析 1 从URL提取短码/Extract sho

🚀 快速开始 首次使用 如果您是第一次使用本 Skill，请先完成以下步骤： 访问 MaxHub 官网 注册账号 在控制台创建 API Key 将 API Key 配置到环境变量 MAXHUB_API_KEY 中

API 调用格式 所有 API 请求直接使用原始接口路径，无需额外前缀： # 基本调用格式 curl -X GET "${MAXHUB_BASE_URL}/api/v1/{platform}/web/fetch_data" \ -H "x-api-key: YOUR_API_KEY" 注意：备案期间 MAXHUB_BASE_URL 默认使用 IP 地址，备案完成后可改为域名访问。

认证说明 所有 API 请求需在请求头中携带 API Key： 请求头：x-api-key: YOUR_API_KEY 在 MaxHub 官网 注册并获取 API Key

智能调度规则

• 意图识别 → API选择

根据用户描述，按以下优先级匹配API： 精确匹配：用户明确指定操作（如"搜索xxx的视频"→搜索API） 语义推断：根据上下文推断意图（如"这个博主有多少粉丝"→用户信息API） 默认兜底：无法精确匹配时，优先使用搜索类API获取基础数据

• 链式调用策略

当单个API无法满足需求时，按以下模式链式调用： 模式A：搜索→详情 用户: "帮我找Instagram上关于美食的热门内容" 步骤1: 调用搜索API → 获取内容ID列表 步骤2: 对每个ID调用详情API → 获取完整数据

模式B：用户→内容 用户: "分析这个Instagram博主的内容数据" 步骤1: 调用用户信息API → 获取用户ID和基础数据 步骤2: 调用用户作品列表API → 获取内容列表 步骤3: 对关键作品调用详情API → 获取互动数据

模式C：搜索→用户→分析 用户: "找Instagram美妆领域的头部达人" 步骤1: 调用搜索API → 获取相关用户 步骤2: 对每个用户调用详情API → 获取粉丝数等 步骤3: 调用分析/榜单API → 交叉验证排名 步骤4: 综合排序 → 输出Top达人列表

• 参数智能填充

必填参数缺失时，主动向用户询问 可选参数根据上下文智能推断默认值 分页参数自动管理（首次page=1，根据需要自动翻页）

API详细目录 数据采集 Shortcode转Media ID/Convert shortcode to media ID GET /api/v1/instagram/v1/shortcode_to_media_id（必填: shortcode） Media ID转Shortcode/Convert media ID to shortcode GET /api/v1/instagram/v1/media_id_to_shortcode（必填: media_id） 用户ID转用户信息/Get user info by user ID GET /api/v1/instagram/v1/user_id_to_username（必填: user_id） 根据用户名获取用户数据/Get user data by username GET /api/v1/instagram/v1/fetch_user_info_by_username（必填: username） 根据用户名获取用户数据V2/Get user data by username V2 GET /api/v1/instagram/v1/fetch_user_info_by_username_v2（必填: username） 根据用户名获取用户数据V3/Get user data by username V3 GET /api/v1/instagram/v1/fetch_user_info_by_username_v3（必填: username） 根据用户ID获取用户数据/Get user data by user ID GET /api/v1/instagram/v1/fetch_user_info_by_id（必填: user_id） 根据用户ID获取用户数据V2/Get user data by user ID V2 GET /api/v1/instagram/v1/fetch_user_info_by_id_v2（必填: user_id） 获取用户的About信息/Get user about info GET /api/v1/instagram/v1/fetch_user_about_info（必填: user_id） 获取用户帖子列表/Get user posts list GET /api/v1/instagram/v1/fetch_user_posts（必填: user_id） 获取用户帖子列表V2/Get user posts list V2 GET /api/v1/instagram/v1/fetch_user_posts_v2（必填: user_id） 获取用户Reels列表/Get user Reels list GET /api/v1/instagram/v1/fetch_user_reels（必填: user_id） 获取用户转发列表/Get user reposts list GET /api/v1/instagram/v1/fetch_user_reposts（必填: user_id） 获取用户被标记的帖子/Get user tagged posts GET /api/v1/instagram/v1/fetch_user_tagged_posts（必填: user_id） 获取相关用户推荐/Get related profiles GET /api/v1/instagram/v1/fetch_related_profiles（必填: user_id） 通过URL获取帖子详情/Get post by URL GET /api/v1/instagram/v1/fetch_post_by_url（必填: post_url） 通过URL获取帖子详情 V2/Get post by URL V2 GET /api/v1/instagram/v1/fetch_post_by_url_v2（必填: post_url） 通过ID获取帖子详情/Get post by ID GET /api/v1/instagram/v1/fetch_post_by_id（必填: post_id） 获取使用特定音乐的帖子/Get posts using specific music GET /api/v1/instagram/v1/fetch_music_posts 获取话题标签下的帖子/Get posts by hashtag GET /api/v1/instagram/v1/fetch_hashtag_posts（必填: hashtag） 获取地点信息/Get location info GET /api/v1/instagram/v1/fetch_location_info（必填: location_id） 获取地点下的帖子/Get posts by location GET /api/v1/instagram/v1/fetch_location_posts（必填: location_id） 获取国家城市列表/Get cities by country GET /api/v1/instagram/v1/fetch_cities（必填: country_code） 获取城市地点列表/Get locations by city GET /api/v1/instagram/v1/fetch_locations（必填: city_id） 获取探索页面分类/Get explore page sections GET /api/v1/instagram/v1/fetch_explore_sections 获取分类下的帖子/Get posts by section GET /api/v1/instagram/v1/fetch_section_posts（必填: section_id） Shortcode转Media ID/Convert shortcode to media ID GET /api/v1/instagram/v2/shortcode_to_media_id（必填: shortcode） Media ID转Shortcode/Convert media ID to shortcode GET /api/v1/instagram/v2/media_id_to_shortcode（必填: media_id） 用户ID转用户信息/Get user info by user ID GET /api/v1/instagram/v2/user_id_to_username（必填: user_id） 获取用户信息/Get user info GET /api/v1/instagram/v2/fetch_user_info 获取用户帖子/Get user posts GET /api/v1/instagram/v2/fetch_user_posts 获取用户Reels/Get user reels GET /api/v1/instagram/v2/fetch_user_reels 获取用户故事/Get user stories GET /api/v1/instagram/v2/fetch_user_stories 获取用户精选/Get user highlights GET /api/v1/instagram/v2/fetch_user_highlights 获取精选故事详情/Get highlight stories GET /api/v1/instagram/v2/fetch_highlight_stories（必填: highlight_id） 获取用户被标记的帖子/Get user tagged posts GET /api/v1/instagram/v2/fetch_user_tagged_posts 获取相似用户/Get similar users GET /api/v1/instagram/v2