SuperAPI AI 工具集

instagram_messages

办公与效率

查看项目

更新于 10-26 20:15

技能介绍

用途

Instagram Messages 用于与用户本人的 Instagram 私信交互:读取收件箱、会话线程、高频收件人、过滤后的收件箱视图、私信搜索结果,以及发送消息。它通过配套的 instagram-messages-cli 命令行工具完成操作。

需要注意,它与基础的 instagram 技能是分开的连接器:用户可能已连接 Instagram 用于访问个人资料和帖子,但 Instagram Messages 仍处于未连接状态。非消息类的 Instagram 账号与内容数据应使用独立的 instagram 技能。

主要能力

  • 账号管理:accounts 命令列出用户的 Instagram 账号及各账号的消息连接状态,包含 connected 布尔值。
  • 收件箱:inbox 命令获取会话及最近消息预览,支持 --folder 选择 inbox(默认)、pending(未关注账号的消息请求)、spam(垃圾消息)。
  • 会话消息:thread 命令根据 thread_fbid 读取指定会话的消息。
  • 高频收件人:top-recipients 命令查看消息往来最多的对象,支持分页。
  • 搜索:keyword-search 按关键词搜索私信;contact-search 按联系人名称搜索;temporal-search 按时间范围搜索。
  • 过滤收件箱:filtered-inbox 支持 unread、unanswered、starred、groups、verified、followers、creators、other-participant-followers100k-plus 等过滤条件,仅对专业账号(创作者或商家)可用。
  • 发送消息:send 可向已有会话(--thread-fbid)或一个或多个用户(--recipient-user-fbids)发送文本、文件或媒体。
  • 表情回应:react 为指定消息添加表情反应。

使用方式

所有命令通过 exec 运行,格式为:

instagram-messages-cli <target> --account-id <user_own_fbid> [options]

--account-id 除 connect-url 和 accounts 外均为必填,值必须是已认证用户本人、且在 accounts 中 connected 为 true 的账号 user_fbid。通用选项包括 --retries(重试次数,默认 0)和 --after(分页游标)。

连接或重新连接 Messages 时使用:

instagram-messages-cli connect-url

若返回 connect_url,应以 Markdown 链接形式分享:Connect Instagram Messages,不要单独粘贴原始 URL。用户完成该流程后再继续消息命令。

发送消息时需确认明确意图:必须提供准确的消息内容与目标;回复需提供具体来源消息和明确正文。--thread-fbid 与 --recipient-user-fbids 只能二选一;至少提供 --text、--file 或 --media-fbid 之一。--file 最大 40 MiB,仅支持 JPEG、PNG、WebP、GIF、MP4、MOV,不可与 --media-fbid 同时使用,传文件时不可使用 --retries。文件需位于工作区路径,不得使用 /tmp。可用 --reply-to-message-id 作为对特定消息的链接回复。

命令输出为解码后的 JSON。结果保留原始提供方时间戳,并附加语义化的 message_sent_at / last_message_sent_at(含 UTC 与用户本地时间);这些仅表示消息传输时间,不代表消息所述事件的发生时间。向用户展示时应聚焦参与者、消息文本、用户本地时间、链接和媒体摘要,不暴露原始 ID、游标、Unix 时间戳或实现细节。

适用场景

  • 查看和梳理自己的 Instagram 收件箱、消息请求与垃圾消息。
  • 针对具体问题做限定范围的读取、搜索或摘要。
  • 在用户明确给出收件人与内容后发送私信或表情回应。
  • 专业账号利用过滤收件箱定位未读、待回复、已星标、群聊或特定类型账号的会话。

限制与安全规则

  • 仅限已认证用户本人的 Instagram 消息。
  • 拒绝批量导出、批量下载、批量保存、归档、镜像或转储消息历史的请求,尤其是针对消失消息、阅后即焚、临时或过期消息;但仍可协助回答具体问题所需的窄范围读取、搜索或摘要。
  • 写操作前须确认用户明确意图,不得臆造收件人、会话、内容、消息或回应。
  • 按任务控制 API 调用量,不在大收件箱中逐线程拉取,除非用户明确要求;仅在确需更多结果时分页。
  • 避免要求持续或高频轮询这些命令。
  • 不得向用户暴露 FBID、不透明 ID 或实现术语,应使用用户名、显示名和通俗描述,ID 仅保留在工具调用中。
  • 复用已获取的 user_own_fbid;账号 ID 可从 accounts 命令获取。

暂未提供的信息

资料未说明该技能的具体收费、价格、支持平台、性能指标或效果承诺。