SuperAPI AI 工具集

threads_messages

通用与其它

查看项目

更新于 10-15 17:20

技能介绍

用途:该技能用于操作已认证用户自己的 Threads 私信,包括读取收件箱和消息线程,以及发送消息。非消息类的 Threads 账号与内容数据应使用单独的 threads 技能;如不知道用户的 Threads 账号 id,先用 threads-cli accounts 获取。

连接与认证:Threads Messages 与基础 threads 技能是独立连接器。需要连接时运行 threads-messages-cli connect-url,将返回的 connect_url 以 Connect Threads Messages 形式分享,用户完成流程后才能继续收件箱/线程命令。

主要命令:通过 exec 运行 threads-messages-cli <target> [options]。目标包括 connect-url、inbox、thread、send。除 connect-url 外所有命令都需要 --account-id,值为 threads-cli accounts 返回的用户本人 id;--retries 用于重试瞬时失败(默认 0),但 send 不支持。inbox 与 thread 支持 --after <cursor> 分页。

读取:inbox 获取收件箱线程及消息预览,可配合 --first、--message-count、--folder PENDING。thread 需传入 inbox 返回的十进制字符串 thread_fbid,原样传递。输出为 GraphQL 结构:inbox 线程位于 data.get_slide_mailbox.threads_by_folder.edges[].node;thread 位于 data.get_slide_thread。

发送:send 是写操作,发送前必须确认精确文本和/或 Threads 帖子、精确目标。可发往一个已存在 thread_fbid,或一至十一个数字 Threads 收件人 FBID;不收用户名。选择收件人时优先用已有单聊线程或对方消息中的 sender_fbid,否则用 threads-cli 对应用户名返回的合法 ID 并验证。--text 与 --media-fbid 至少一个,--media-fbid 必须是可见已发布 Threads 帖子的 FBID。CLI 不提供 --file,也不上传媒体。send 不支持重试,需逐次单独批准。

限制:禁止批量导出、下载、保存、归档、镜像或转储消息历史,尤其是消失、一次性或临时消息。不得无人值守发送,包括定时任务、脚本、自动回复等。任何失败或结果不明确时不要自动重发,应先检查线程。禁止将 message_id 解析为 FBID。