name: typefully
description: |
通过 Typefully API 在 X、LinkedIn、Mastodon、Threads 和 Bluesky 上安排发布内容。

创建草稿、安排帖子，并管理多个社交平台的内容。
metadata:
{"clawdbot":{"emoji":"🐦","requires":{"env":["TYPEFULLY_API_KEY"]}}}

Typefully 技能

通过 Typefully API 在 X、LinkedIn、Mastodon、Threads 和 Bluesky 上安排和发布内容。

设置

1. 在 https://typefully.com 创建 Typefully 账户。
2. 在 Typefully 中关联你的社交媒体账户。
3. 在 Typefully 设置中生成 API 密钥。
4. 设置环境变量。

export TYPEFULLY_API_KEY="你的-typefully-api-密钥"

环境变量

命令

用户与账户

typefully me                    # 获取当前用户信息
typefully social-sets           # 列出已关联的社交账户
typefully social-set <id>       # 获取指定账户的详细信息

草稿

typefully drafts                     # 列出账户的所有草稿
typefully draft <id>                 # 获取指定草稿
typefully create-draft "内容"        # 创建新草稿
typefully update-draft <id> "文本"   # 更新草稿
typefully delete-draft <id>          # 删除草稿

草稿选项

筛选草稿

typefully drafts                  # 默认：按更新时间排序，显示10条草稿
typefully drafts --status draft   # 仅显示“草稿”状态的帖子
typefully drafts --status scheduled  # 仅显示“已安排”的帖子
typefully drafts --status published  # 仅显示“已发布”的帖子
typefully drafts --limit 25       # 每页显示更多结果
typefully drafts --offset 10      # 跳过前10条结果
typefully drafts --order-by created_at  # 按创建日期排序

标签

typefully tags                  # 列出账户的标签
typefully create-tag "名称"     # 创建新标签
typefully delete-tag "slug"     # 删除标签

媒体文件

typefully upload-media <文件名>    # 获取媒体文件上传 URL
typefully media-status <id>        # 检查媒体文件处理状态

示例

创建简单帖子

# 获取你的账户 ID
typefully social-sets

# 创建草稿
typefully create-draft "你好，世界！这是我的第一条帖子。" \
  --social-set-id 12345

# 创建并立即发布
typefully create-draft "突发新闻！" \
  --social-set-id 12345 --now

创建线程

typefully create-draft "1/ 我很高兴分享一些更新...
2/ 我们一直在努力开发新功能...
3/ 以下是我们一直在构建的内容...
4/ 敬请期待更多！" \
  --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/用户名/status/1234567890"

发布到社区

typefully create-draft "与社区分享..." \
  --social-set-id 12345 \
  --community 1493446837214187523

使用标签

# 列出可用标签
typefully tags --social-set-id 12345

# 创建标签
typefully create-tag "公告" --social-set-id 12345

# 创建带标签的草稿
typefully create-draft "重大公告！" \
  --social-set-id 12345 \
  --tags 公告

上传媒体文件

# 获取上传 URL
typefully upload-media screenshot.png --social-set-id 12345

# 检查状态
typefully media-status <媒体文件-id> --social-set-id 12345

API 端点

支持的平台

• X
• LinkedIn
• Mastodon
• Threads
• Bluesky

X 自动化合规性

使用此技能与 X 交互时，请遵守 X 自动化规则：
- 请勿在多个账户发布相似内容。
- 请勿使用自动化操纵热门话题。
- 仅向已选择加入的用户发送自动回复。
- 每次用户互动仅发送一条自动回复。
- 禁止自动点赞和批量关注。
- 禁止自动批量添加用户到列表。
- 所有自动化内容需遵守 X 媒体政策。
- 如果发布包含敏感内容的媒体，请将账户标记为敏感。
- 请勿使用自动化冒充他人。
- 请勿发布误导性链接。

注意事项

• 所有请求都需要设置 TYPEFULLY_API_KEY 环境变量。
• 草稿默认是私有的。
• 使用 --share 选项可生成公开 URL。
• --now 标志会立即发布，不保存草稿。
• 不使用 --now 时，草稿会被保存以供审阅。
• 存在针对每个用户和每个社交账户集的速率限制。
• 请勿尝试绕过速率限制。

资源

• Typefully: https://typefully.com
• Typefully API 文档: https://docs.typefully.com
• X 自动化规则: https://help.x.com/en/rules-and-policies/x-automation