SuperAPI AI 工具集

connect-ai-instagram

数据与分析

查看项目

更新于 10-15 20:11

技能介绍

用途:该技能为通过 CData Connect AI 查询 Instagram 数据提供专门指引,构建在 connect-ai-base 技能之上,后者负责发现流程、错误恢复、SQL 方言与查询命名约定。使用前必须先定位并读取 connect-ai-base 技能;若当前环境未加载、未启用或未安装,应立即停止任务,告知用户需先安装并启用该技能。该技能取代 Instagram 驱动的 getInstructions,不要调用它,识别连接后直接进行模式发现(getTables / getColumns)。

主要能力:Instagram 为单模式驱动,模式名为 Instagram。核心表包括 InstagramBusinessProfile(账号元数据)、Media(已发布媒体及点赞/评论数)、IGMedia(含 ShortCode、PermanentURL 等标识)、Comments 与 Replies(可写)、MediaInsights(单媒体表现)、AccountInsights(账号级表现,受 Period 与 MetricType 控制列驱动)、AudienceInsights(粉丝人口统计,受 AudienceType 与 Timeframe 驱动)、Stories(仅当前有效时返回)、各类媒体面洞察视图、账号细分视图、InstagramPages / Pages、Permissions、Tags。关系上 Media.Id = IGMedia.Id = MediaInsights.MediaId,Comments.MediaId 指向 Media.Id,Replies.CommentId 指向 Comments.Id。

使用方式:先查账号,再列媒体,再深入互动或表现。示例:SELECT * FROM [YourConnection].[Instagram].[Media] LIMIT 10。可按 Created 过滤并排序,按 MediaType 过滤,按 MediaId 查评论,或将 Media 与 MediaInsights 按 Id = MediaId 连接。写入仅支持 Comments 与 Replies 的 INSERT,需 instagram_manage_comments 权限,无 DELETE。

限制:Media、profile 与洞察表只读;AudienceInsights 在粉丝数低于约 100 时无返回;Stories 仅当前有效;Tags 需更高权限,否则报权限错误;写入被阻止时需在连接设置中启用写访问。