用途:通过配套命令行工具 instagram-messages-cli 读取和发送已认证用户本人的 Instagram 私信。非消息类的 Instagram 账号与内容数据应使用单独的 instagram 技能。
主要能力:accounts 列出账号及消息连接状态;inbox 获取收件箱会话(支持 inbox、pending、spam 文件夹);thread 获取指定会话消息;top-recipients 查看高频收件人;keyword-search、contact-search、temporal-search 分别按关键词、联系人、时间范围搜索私信;filtered-inbox 按未读、未回复、星标、群聊、认证账号等条件筛选,仅限专业账号(创作者或企业);react 添加表情回应;send 发送消息,支持文本、媒体 ID 或文件,可指定会话或收件人,并支持回复某条消息。
使用方式:先运行 instagram-messages-cli accounts 查看账号及 connected 状态;未连接时用 instagram-messages-cli connect-url 获取授权链接,完成授权后再执行消息命令。除 connect-url 和 accounts 外,命令均需 --account-id <user_own_fbid>,该值须为已连接账号的本人 user_fbid。分页用 --after <cursor>,重试用 --retries <N>。发送文件前须确保文件位于工作区路径,不可使用 /tmp;--file 最大 40 MiB,仅支持 JPEG、PNG、WebP、GIF、MP4、MOV,且不可与 --media-fbid 同用,发送文件时不可使用 --retries。
限制:仅限已认证用户本人的私信;发送与回应前须确认明确意图和具体内容、对象,不得虚构收件人、会话或内容;不得批量导出、下载、保存、归档、镜像或转储消息历史,尤其禁止针对阅后即焚、一次性查看、消失模式等临时消息;避免频繁轮询;不要向用户暴露 FBID、游标、Unix 时间戳等实现细节。输出为解码后的 JSON,时间仅表示消息传输时间,不代表消息所述事件的发生时间。