marketing
Bitly CLI for Headless Automation
Use the Bitly CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
8 functions 5 read 3 write Bearer token auth
Bitly 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 Bitly CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Bitly CLI for Headless Automation
kosmokrator integrations:configure bitly --set access_token="$BITLY_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call bitly.bitly_shorten_link '{"long_url":"example_long_url","domain":"example_domain","group_guid":"example_group_guid"}' --json Discovery Before Execution
Agents and scripts can inspect Bitly docs and schemas before choosing a function.
kosmo integrations:docs bitly --json
kosmo integrations:docs bitly.bitly_shorten_link --json
kosmo integrations:schema bitly.bitly_shorten_link --json
kosmo integrations:search "Bitly" --json
kosmo integrations:list --json Useful Bitly CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
bitly.bitly_shorten_link | Write | long_url, domain, group_guid | Shorten a long URL into a Bitlink. Returns the shortened URL and link details. |
bitly.bitly_get_link | Read | bitlink | Retrieve details for a Bitlink, including the long URL, title, tags, and timestamps. |
bitly.bitly_update_link | Write | bitlink, title, archived, tags | Update a Bitlink's metadata — set the title, archive/unarchive, or update tags. |
bitly.bitly_get_clicks | Read | bitlink, unit, units, unit_reference | Get click metrics for a Bitlink. Returns click counts by time unit (minute, hour, day, week, month). |
bitly.bitly_list_groups | Read | none | List all groups in the Bitly account. Groups organize links and are used when creating new Bitlinks. |
bitly.bitly_get_group | Read | group_guid | Retrieve details for a specific Bitly group by its GUID. |
bitly.bitly_create_bitlink | Write | long_url, title, tags, domain, group_guid | Create a new Bitlink with title, tags, and optional custom domain. More full-featured than shorten — use this when you need metadata. |
bitly.bitly_get_current_user | Read | none | Get the authenticated Bitly user's profile. Use this to verify the connection and see account info. |
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.