用途
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 命令获取。
暂未提供的信息
资料未说明该技能的具体收费、价格、支持平台、性能指标或效果承诺。