核心用法
MaxHub Instagram 是一个只读型数据查询 skill,通过 MAXHUB_API_KEY 调用 MaxHub API(https://www.aconfig.cn),覆盖 Instagram 87 个端点,支持 V1/V2/V3 三版本并行。核心功能包括:
- 帖子数据:查询图文/Carousel/视频/Reels 详情、点赞列表、标记用户、短码↔媒体 ID 互转
- Reels 与 Stories:拉取用户 Reels 列表、系统推荐流、当日 Stories、Highlights 精选合集
- 评论与回复:一级评论翻页、二级回复链路、单条/批量翻译
- 用户画像:用户名/ID 查资料、粉丝/关注列表、About 信息、曾用名、相似账号
- 搜索探索:用户搜索、综合搜索、Hashtag、Location、坐标、Explore 页
调用遵循 recipes_first 策略:Agent 优先匹配预编排的 Chain Recipes,再按需加载 reference 文件;跨端点字段流由 param-mappings.md 字典约束,禁止自行拼接路径或臆造参数。
显著优点
- 功能覆盖全面:87 个端点涵盖帖子、用户、搜索、评论四大域,满足从单帖查询到批量账号分析的完整链路
- 多版本容错:V1/V2/V3 并行,单版本异常可降级切换,字段丰富度可按场景择优
- 防臆造设计:白名单硬校验 + 4/5/6 步分级自检 + 错误决策表,显著降低 Agent 幻觉风险
- 链式调用图谱:预定义 7 条高频链路(如「搜索用户→帖子→评论→回复」),字段自动传递,开发效率高
- 合规性考量:默认只读、明确声明第三方传输、建议独立测试账号、强调 GDPR/个人信息保护法合规
潜在缺点与局限
- 第三方依赖:所有数据经
aconfig.cn中转,存在服务可用性与数据时效性依赖 - 版本差异陷阱:V3 子评论需
media_id而非code,跨版本参数不互通,需严格按 reference 调用 - 无写入能力:仅支持公开/授权数据查询,无法执行关注、点赞、发帖等互动操作
- 隐私合规责任在用户:UGC 可能含个人信息,需使用方自行确保存储与发布合规
- Rate limit 未披露:未在文档中明确说明配额限制与定价,实际使用需与 MaxHub 确认
适合人群
- 海外网红营销(KOL 选号、粉丝画像、互动率量化)
- 跨境品牌社媒运营(舆情监控、Hashtag 热度、竞品跟踪)
- 内容运营与数据分析师(爆款素材库构建、选题规律提炼)
- 增长团队(粉丝结构分析、受众重合度研究)
常规风险
- 凭证泄露风险:
MAXHUB_API_KEY为敏感信息,需避免写入日志或对话;建议定期轮换 - 账号关联风险:若传入生产账号的 cookie/session,可能导致账号受限;文档明确建议使用独立测试账号
- 数据合规风险:拉取的评论/动态可能含个人敏感信息,违规存储或公开发布可能触发 GDPR/个人信息保护法责任
- API 稳定性风险:依赖第三方服务
aconfig.cn,存在服务变更、端点废弃或 410 等不可控因素
---
评估版本:SKILL.md v3.8.0,评估日期:2025-01