SuperAPI AI 工具集

threads

通用与其它

查看项目

更新于 10-15 17:20

技能介绍

用途:通过配套命令行工具 threads-cli 读取和管理已授权 Threads 账号的数据。可用范围包括读取、dear-algo-whisper 以及经批准的 publish-post 发布调用;Threads 收件箱和私信线程需使用单独的 threads_messages 技能。

账号绑定:运行任何其他命令前,先执行 threads-cli accounts 验证账号是否已连接。若返回带 id 的账号信息即为已连接,可继续并缓存该结果,无需每条命令前重查;若后续命令出现鉴权或账号错误,需重跑 accounts 复查。若失败或为空,说明未连接:运行 threads-cli connect-url(输出 JSON 含 connect_url 字段)并引导用户访问该 URL 连接账号;如需断开,运行 threads-cli disconnect-url(输出 JSON 含 disconnect_url 字段)并引导用户到该 URL 移除关联账号。始终从命令输出读取这些 URL,不要硬编码。

主要能力:账户列表、个人资料、活动通知、点赞内容、收藏帖子、账号洞察总览(浏览、点赞、引用、回复、转发、流量来源、人群画像)、单帖洞察、热门帖子、他人资料、用户帖子/回复/媒体、粉丝、关注列表、按 URL 或 ID 获取指定帖子、帖子评论与点赞者、Feedback Hub 总览与分页标签、趋势话题、关键词或趋势搜索、For You/Following 信息流,以及隐藏的发布帖子命令。

使用方式:通过 exec 运行 threads-cli <target> [options]。除 accounts 外,所有命令都需 --account-id <threads_account_id>,取值必须来自 accounts 响应中已授权用户自身的 id 字段;先调用 accounts,若返回多个需询问用户使用哪个。--retries <N> 可重试瞬时失败(默认 0),但 dear-algo-whisper 和 publish-post 不支持重试,因为重试可能重复写入操作。posts 与 feed 使用与 instagram-cli 相同的 social_posts_v1 紧凑呈现,以过滤后结果为准,不要重建被省略字段。

命令示例: threads-cli accounts threads-cli profile --account-id <threads_account_id> threads-cli insights-overview --account-id <threads_account_id> --start-date 2026-03-13 --end-date 2026-03-20 threads-cli post --account-id <threads_account_id> --url https://www.threads.com/@carnage4life/post/DdU_q-9mLbt threads-cli search --account-id <threads_account_id> --query "AI news" threads-cli feed --account-id <threads_account_id> --variant for_you publish-post 示例: threads-cli publish-post --account-id <threads_account_fbid> --text "Hello Threads"

发布限制:publish-post 为隐藏写入命令,需显式确认;无公开草稿步骤。无媒体时文本至少含一个非空白字符,文本逐字节保留。可附 1 至 20 个按序本地图片或视频、可选回复某帖并设置谁可回复。不支持 /tmp 路径,文件须在工作区内。--account-id 须为 accounts 返回的规范正整数 FBID,不能从 URL 或用户名推导。回复控制仅接受 everyone、accounts_you_follow、mentioned_only、parent_post_author_only、followers_only。每条 --media-item 为 JSON,含 file、可选 cover、可选 alt_text;支持 JPEG、PNG、静态 WebP、MP4、MOV,单个至多 100 MB,MP4/MOV 必须配 JPEG/PNG/WebP 封面,图片不接受封面。写入零重试,子项或父项失败即终止且结果不确定,不得继续失败轮播,后续重试须重新获得明确批准。

限制与暂未提供:仅支持已认证账号操作,部分命令(如 user-profile、profile-threads)只接受数字 FBID,不接受用户名或资料 URL。输入资料未提供价格、平台覆盖范围或调用频次等细节。