SuperAPI AI 工具集

typefully

营销与增长

查看项目

更新于 10-16 07:29

技能介绍

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,并查询媒体处理状态。

使用方式

  1. 在 https://typefully.com 创建 Typefully 账号。
  2. 在 Typefully 中连接社交账号。
  3. 在 Typefully 设置中生成 API 密钥。
  4. 设置环境变量:export TYPEFULLY_API_KEY="your-typefully-api-key"。
  5. 使用命令行执行操作,例如:
    • 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