social-media
Typefully CLI for Headless Automation
Use the Typefully CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
5 functions 4 read 1 write API key auth
Typefully CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Typefully CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Typefully CLI for Headless Automation
kosmokrator integrations:configure typefully --set api_key="$TYPEFULLY_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call typefully.typefully_create_draft '{"content":"example_content","type":"example_type","schedule_date":"example_schedule_date","thread_connector":true,"is_tweet_pin":true,"is_tweet_reply":true,"reply_to":"example_reply_to","mail_subject":"example_mail_subject"}' --json Discovery Before Execution
Agents and scripts can inspect Typefully docs and schemas before choosing a function.
kosmo integrations:docs typefully --json
kosmo integrations:docs typefully.typefully_create_draft --json
kosmo integrations:schema typefully.typefully_create_draft --json
kosmo integrations:search "Typefully" --json
kosmo integrations:list --json Useful Typefully CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
typefully.typefully_create_draft | Write | content, type, schedule_date, thread_connector, is_tweet_pin, is_tweet_reply, reply_to, mail_subject, mail_subtitle, audience_id, label_ids | Create a new draft in Typefully. Supports tweets, threads, and newsletter drafts. Separate individual tweets in a thread with four newlines (\\n\\n\\n\\n). |
typefully.typefully_list_scheduled | Read | limit, offset | List scheduled drafts in Typefully that are queued for publication. Returns draft content, scheduled dates, and metadata. |
typefully.typefully_list_published | Read | limit, offset | List published drafts in Typefully. Returns content, publication dates, engagement metrics, and metadata. |
typefully.typefully_get_draft | Read | id | Get details of a specific Typefully draft by its ID. Returns full content, scheduling info, and metadata. |
typefully.typefully_get_current_user | Read | none | Get the authenticated Typefully user's profile information, including handle, name, and account details. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.