用途:通过 Typefully 在多个社交平台创建、排期和发布内容,并管理草稿、标签与媒体。
主要能力:支持多平台(x、linkedin、threads、bluesky、mastodon)草稿创建;可用 --platform x,linkedin 或 --all 一次覆盖多个平台;用 --- 单独一行拆分线程;支持 --schedule 指定时间或 next-free-slot、--schedule now;支持草稿列表、更新、追加、删除、发布;支持标签 tags:list / tags:create 与媒体 media:upload / media:status;支持 --file、--media、--reply-to、--community、--share、--scratchpad、--title。
必要用法:先配置 API Key,可在 https://typefully.com/?settings=api 获取;运行 <skill-path>/scripts/typefully.js setup,或设置 export TYPEFULLY_API_KEY=your_key。需要 Node.js 18+。配置优先级:环境变量 > ./.typefully/config.json > ~/.config/typefully/config.json。缺少 Key 时告知用户自行运行 setup 并等待,不要在 Keychain、.env 或系统目录中查找密钥。
典型命令:./scripts/typefully.js drafts:create --text "Hello, world!";./scripts/typefully.js drafts:create --platform x,linkedin --text "Big announcement!";./scripts/typefully.js drafts:create --text "Scheduled post" --schedule next-free-slot;./scripts/typefully.js media:upload ./image.jpg 后接 --media <media_id>。草稿的 social_set_id 可省略,使用默认社交集;单参数配合默认集合时需加 --use-default。草稿 URL 形如 https://typefully.com/?a=<social_set_id>&d=<draft_id>。
适用场景:需要统一管理和排期跨平台社交内容时;用草稿供用户复核而非直接公开,较安全。限制:发布不可逆,除用户明确要求“立即发布”外应先确认;不要在未授权情况下自动回复、刷量或跨账号重复内容;API 有速率限制;X 280、LinkedIn 3000、Threads 500、Bluesky 300、Mastodon 500 字符限制;标签按社交集隔离。资料未说明价格与完整平台细节。