- name
- typefully
- description
- |
- metadata
Typefully Skill
Schedule and publish content to X, LinkedIn, Mastodon, Threads, and Bluesky through the Typefully API.
Setup
- Create a Typefully account at https://typefully.com
- Connect social media accounts in Typefully
- Generate an API key in Typefully settings
- Set the environment variable
export TYPEFULLY_API_KEY="your-typefully-api-key"
Environment Variables
| Variable | Required | Description |
|---|
| TYPEFULLY_API_KEY | Yes | Your Typefully API key |
Commands
User and Accounts
typefully me # Get current user info
typefully social-sets # List connected social accounts
typefully social-set <id> # Get details for a specific account
Drafts
typefully drafts # List all drafts for an account
typefully draft <id> # Get a specific draft
typefully create-draft "content" # Create a new draft
typefully update-draft <id> "text" # Update a draft
typefully delete-draft <id> # Delete a draft
Draft Options
| Option | Description |
|---|
| --social-set-id <id> | Account ID required for drafts |
| --schedule <time> | ISO 8601 datetime |
| --now | Publish immediately after creating |
| --next-free-slot | Schedule for optimal posting time |
| --title <text> | Internal draft title |
| --share | Generate public share URL |
| --thread | Treat content as multi-line thread |
| --reply-to <url> | Reply to an existing post URL |
| --community <id> | Post to a community |
Filtering Drafts
typefully drafts # Default 10 drafts sorted by updated
typefully drafts --status draft # Only draft status
typefully drafts --status scheduled # Only scheduled
typefully drafts --status published # Only published
typefully drafts --limit 25 # More results per page
typefully drafts --offset 10 # Skip first 10 results
typefully drafts --order-by created_at # Sort by date
Tags
typefully tags # List tags for an account
typefully create-tag "name" # Create a new tag
typefully delete-tag "slug" # Delete a tag
Media
typefully upload-media <filename> # Get upload URL for media
typefully media-status <id> # Check media processing status
Examples
Create a Simple Post
# Get your account ID
typefully social-sets
# Create a draft
typefully create-draft "Hello world! This is my first post." \
--social-set-id 12345
# Create and publish immediately
typefully create-draft "Breaking news!" \
--social-set-id 12345 --now
Create a Thread
typefully create-draft "1/ I am excited to share some updates...
2/ We have been working hard on new features...
3/ Here is what we have been building...
4/ Stay tuned for more!" \
--social-set-id 12345 --thread
Schedule for Later
# Schedule for specific time
typefully create-draft "Mark your calendars! Launching next week." \
--social-set-id 12345 \
--schedule "2025-01-25T09:00:00Z"
# Schedule for optimal posting time
typefully create-draft "Best time to post..." \
--social-set-id 12345 \
--next-free-slot
Reply to a Post
typefully create-draft "Great thread! I completely agree." \
--social-set-id 12345 \
--reply-to "https://x.com/username/status/1234567890"
Post to a Community
typefully create-draft "Sharing with the community..." \
--social-set-id 12345 \
--community 1493446837214187523
Work with Tags
# List available tags
typefully tags --social-set-id 12345
# Create a tag
typefully create-tag "announcements" --social-set-id 12345
# Create draft with tag
typefully create-draft "Big announcement!" \
--social-set-id 12345 \
--tags announcements
Upload Media
# Get upload URL
typefully upload-media screenshot.png --social-set-id 12345
# Check status
typefully media-status <media-id> --social-set-id 12345
API Endpoints
| Method | Endpoint | Description |
|---|
| GET | /v2/me | Get current user |
| GET | /v2/social-sets | List social sets |
| GET | /v2/social-sets/{id} | Get social set details |
| GET | /v2/social-sets/{id}/drafts | List drafts |
| POST | /v2/social-sets/{id}/drafts | Create draft |
| GET | /v2/social-sets/{id}/drafts/{id} | Get draft |
| PATCH | /v2/social-sets/{id}/drafts/{id} | Update draft |
| DELETE | /v2/social-sets/{id}/drafts/{id} | Delete draft |
| GET | /v2/social-sets/{id}/tags | List tags |
| POST | /v2/social-sets/{id}/tags | Create tag |
| DELETE | /v2/social-sets/{id}/tags/{slug} | Delete tag |
| POST | /v2/social-sets/{id}/media/upload | Get upload URL |
| GET | /v2/social-sets/{id}/media/{id} | Check media status |
Supported Platforms
- X
- LinkedIn
- Mastodon
- Threads
- Bluesky
X Automation Compliance
Adhere to the X Automation Rules when using this skill with X:
- Do not post similar content across multiple accounts.
- Do not use automation to manipulate trending topics.
- Send automated replies only to users who have opted in.
- Send only one automated response per user interaction.
- Automated likes and bulk following are prohibited.
- Automated bulk adding to lists is prohibited.
- Follow the X media policy for all automated content.
- Mark accounts as sensitive if posting graphic media.
- Do not use automation to impersonate others.
- Do not post misleading links.
Notes
- All requests require the TYPEFULLY_API_KEY environment variable.
- Drafts are private by default.
- Use --share for a public URL.
- The --now flag publishes immediately without saving a draft.
- Drafts are saved for review when you do not use --now.
- Rate limits apply per user and per social set.
- Do not attempt to bypass rate limits.
Resources
- Typefully at https://typefully.com
- Typefully API Docs at https://docs.typefully.com
- X Automation Rules at https://help.x.com/en/rules-and-policies/x-automation
