Typefully Skill

这是基于Typefully v2 API的草稿管理工具，核心功能包括创建、列表、编辑、删除、调度单条或线程式社交帖子草稿，支持X、LinkedIn等多平台。典型场景：快速生成跨平台内容线程、调度帖子至指定时间/空闲时段、查看不同状态的草稿。通过bash命令调用，输入为指令与参数，输出JSON格式结果；需配置Typefully API密钥，支持环境变量或密码存储设置，可管理关联社交账号集。

chapati23

热度 57.97

最近更新 2026-05-11 17:27:12

分类：营销依赖：代码执行 / 第三方 API应用场景：社交媒体 / 日程安排 / 任务管理 / 文案创作

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add typefully-drafts

Metadata

name: typefully
description: Create, schedule, list, edit, and delete drafts on Typefully. Supports single tweets, threads, and multi-platform posts (X, LinkedIn, Threads, Bluesky, Mastodon). Use when user wants to draft, schedule, or manage social media posts via Typefully.
version: 1.2.0
homepage: https://github.com/gisk0/typefully-skill
requires: {"env":["TYPEFULLY_API_KEY"],"tools":["curl","python3"]}

Typefully Skill

Manage Typefully drafts via the v2 API.

Setup

Set your API key via one of:
- Environment variable: export TYPEFULLY_API_KEY=your-key
- Password store: pass insert typefully/api-key
(Optional) Set your social set ID:
- Environment variable: export TYPEFULLY_SOCIAL_SET_ID=123456
- Password store: pass insert typefully/social-set-id
- If not set, the script auto-detects (errors if multiple accounts exist — use list-social-sets to find yours)
Enable "Development mode" in Typefully Settings → API to see draft IDs in the UI.

Script Usage

bash scripts/typefully.sh <command> [options]

Commands

Command	Description
`list-drafts [status] [limit]`	List drafts. Status: `draft`, `scheduled`, `published` (default: all). Limit default: 10.
`create-draft <text> [--thread] [--platform x,linkedin,...] [--schedule <iso8601\|next-free-slot>]`	Create a draft. For threads, separate posts with `\n---\n`. Use `-` or omit text to read from stdin. Default platform: x.
`get-draft <draft_id>`	Get a single draft with full details.
`edit-draft <draft_id> <text> [--thread] [--platform x,linkedin]`	Update draft content. Supports `--thread` for thread editing.
`schedule-draft <draft_id> <iso8601\|next-free-slot\|now>`	Schedule or publish a draft.
`delete-draft <draft_id>`	Delete a draft.
`list-social-sets`	List available social sets (accounts).

Examples

Create a simple tweet draft:

bash scripts/typefully.sh create-draft "Just shipped a new feature 🚀"

Create a thread:

bash scripts/typefully.sh create-draft "First tweet of the thread\n---\nSecond tweet\n---\nThird tweet" --thread

Create a thread from stdin (for longer content):

cat <<'EOF' | bash scripts/typefully.sh create-draft - --thread
First tweet of the thread\n---\nSecond tweet\n---\nThird tweet with the punchline
EOF

Create cross-platform draft (X + LinkedIn):

bash scripts/typefully.sh create-draft "Exciting update!" --platform x,linkedin

Schedule a draft for a specific time:

bash scripts/typefully.sh create-draft "Morning thoughts ☀️" --schedule "2026-03-01T09:00:00Z"

Schedule to next free slot:

bash scripts/typefully.sh schedule-draft 8196074 next-free-slot

List recent drafts:

bash scripts/typefully.sh list-drafts draft 5

Notes

publish_at: "now" publishes immediately — use with caution
publish_at: "next-free-slot" uses the user's Typefully queue schedule
Thread posts are separated by \n---\n in the text argument
The script outputs JSON; pipe through jq for formatting
All API errors surface meaningful messages (401, 404, 429, etc.)