Typefully Skill 用于通过 Typefully API 在多个社交平台上安排和发布内容,支持的平台包括 X、LinkedIn、Mastodon、Threads 和 Bluesky。
用途 该技能面向需要在多个社交平台统一管理内容发布流程的场景,可通过命令行创建草稿、定时发布、管理标签与媒体,并查看账号与草稿状态。
主要能力
- 用户与账号:获取当前用户信息、列出已连接的社交账号、查看指定账号详情。
- 草稿管理:列出、获取、创建、更新和删除草稿;草稿默认私密,可使用 --share 生成公开分享链接。
- 发布控制:支持 --schedule 指定 ISO 8601 时间定时发布、--now 立即发布、--next-free-slot 安排在最佳发布时段。
- 内容形式:支持 --thread 将内容作为多行线程发布、--reply-to 回复已有帖子、--community 发布到社区、--title 设置内部草稿标题。
- 草稿筛选:可按状态(draft、scheduled、published)筛选,支持 --limit、--offset、--order-by 分页与排序。
- 标签:列出、创建和删除账号下的标签,创建草稿时可指定标签。
- 媒体:获取媒体上传 URL,并查询媒体处理状态。
使用方式
- 在 https://typefully.com 创建 Typefully 账号。
- 在 Typefully 中连接社交账号。
- 在 Typefully 设置中生成 API 密钥。
- 设置环境变量:export TYPEFULLY_API_KEY="your-typefully-api-key"。
- 使用命令行执行操作,例如:
- typefully me
- typefully social-sets
- typefully create-draft "content" --social-set-id 12345
- typefully create-draft "Breaking news!" --social-set-id 12345 --now
- typefully create-draft "..." --social-set-id 12345 --thread
- typefully create-draft "..." --social-set-id 12345 --schedule "2025-01-25T09:00:00Z"
- typefully create-draft "..." --social-set-id 12345 --next-free-slot
- typefully create-draft "..." --social-set-id 12345 --reply-to "https://x.com/username/status/1234567890"
- typefully create-draft "..." --social-set-id 12345 --community 1493446837214187523
- typefully tags --social-set-id 12345
- typefully create-tag "announcements" --social-set-id 12345
- typefully upload-media screenshot.png --social-set-id 12345
- typefully media-status <media-id> --social-set-id 12345
API 端点
- GET /v2/me:获取当前用户
- GET /v2/social-sets:列出社交账号集合
- GET /v2/social-sets/{id}:获取社交账号集合详情
- GET /v2/social-sets/{id}/drafts:列出草稿
- POST /v2/social-sets/{id}/drafts:创建草稿
- GET /v2/social-sets/{id}/drafts/{id}:获取草稿
- PATCH /v2/social-sets/{id}/drafts/{id}:更新草稿
- DELETE /v2/social-sets/{id}/drafts/{id}:删除草稿
- GET /v2/social-sets/{id}/tags:列出标签
- POST /v2/social-sets/{id}/tags:创建标签
- DELETE /v2/social-sets/{id}/tags/{slug}:删除标签
- POST /v2/social-sets/{id}/media/upload:获取上传 URL
- GET /v2/social-sets/{id}/media/{id}:检查媒体状态
适用场景 适合需要跨多个社交平台统一创建、排期和发布内容的个人或团队,尤其是希望通过命令行或自动化方式管理草稿、线程、标签和媒体的用户。
限制与注意事项
- 所有请求都需要 TYPEFULLY_API_KEY 环境变量。
- 草稿默认私密,需使用 --share 生成公开 URL。
- 使用 --now 会立即发布而不保存草稿;不使用 --now 时草稿会保存以供审核。
- 速率限制按用户和社交账号集合分别适用,不应尝试绕过速率限制。
- 与 X 配合使用时需遵守 X 自动化规则,包括:不得在多个账号发布相似内容;不得利用自动化操纵热门话题;仅向已选择接收的用户发送自动回复;每次用户互动只发送一条自动回复;禁止自动点赞和批量关注;禁止自动批量添加到列表;所有自动内容需遵守 X 媒体政策;发布图形媒体时需将账号标记为敏感;不得利用自动化冒充他人;不得发布误导性链接。
资源
- Typefully:https://typefully.com
- Typefully API 文档:https://docs.typefully.com
- X 自动化规则:https://help.x.com/en/rules-and-policies/x-automation