用途:通过 Instagram Graph API 访问帖子与媒体内容,适合在智能体或自动化流程中读取账号媒体、查询单条媒体详情、按话题标签搜索内容,以及发布图片帖子。
主要能力:拉取账号最近的媒体(照片、视频、Reels),返回 id、caption、media_type、media_url、permalink、timestamp 等字段;根据媒体 ID 获取更完整详情,包括 thumbnail_url、username;先通过 ig_hashtag_search 获取话题标签 ID,再取该标签的 recent_media;发布图片需两步,先创建媒体容器,再发布到动态流。
必要用法:需预先设置 INSTAGRAM_TOKEN 与 INSTAGRAM_BUSINESS_ACCOUNT_ID。由于 Graph API 被多个连接器共用,调用时需带上请求头 X-VM0-Connector-Intent: instagram,该头仅为 VM0 代理路由提示,不是认证或权限。发布图片时先将请求数据写入 /tmp/request.json,再分别向 media 与 media_publish 端点发起 POST。连接排查可运行 zero doctor check-connector --env-name INSTAGRAM_TOKEN 或 zero doctor check-connector --url https://graph.facebook.com/v21.0/me --method GET。
适用场景:读取与整理账号内容、抓取指定媒体元数据、按标签检索近期媒体、程序化发布单张图片帖子。
限制:多数功能要求 Business 或 Creator 账号并绑定 Facebook 主页;话题标签搜索需符合 Facebook/Instagram 规定的业务用途与权限;应用需通过审核并启用相应权限;INSTAGRAM_TOKEN 须为有效长期令牌;接口存在速率限制,批量操作需加延时;示例中的 ID 均为占位文本,需替换。token 敏感,不应写入日志或对话记录。