analytics
SpeedCurve CLI for Headless Automation
Use the SpeedCurve CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 6 read 1 write API key auth
SpeedCurve 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 SpeedCurve CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# SpeedCurve CLI for Headless Automation
kosmokrator integrations:configure speedcurve --set api_key="$SPEEDCURVE_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call speedcurve.speedcurve_list_sites '{}' --json Discovery Before Execution
Agents and scripts can inspect SpeedCurve docs and schemas before choosing a function.
kosmo integrations:docs speedcurve --json
kosmo integrations:docs speedcurve.speedcurve_list_sites --json
kosmo integrations:schema speedcurve.speedcurve_list_sites --json
kosmo integrations:search "SpeedCurve" --json
kosmo integrations:list --json Useful SpeedCurve CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
speedcurve.speedcurve_list_sites | Read | none | List all monitored sites in SpeedCurve. Returns site IDs, names, and URLs that you can use to query test results. |
speedcurve.speedcurve_get_site | Read | site_id | Get detailed information about a specific SpeedCurve site, including its URLs, test settings, and latest test results. |
speedcurve.speedcurve_list_tests | Read | site_id, url_id, browser, region, days | List recent synthetic test results from SpeedCurve. Optionally filter by site, browser, or region. |
speedcurve.speedcurve_get_test | Read | test_id | Get detailed results for a specific SpeedCurve synthetic test run, including Core Web Vitals, filmstrip data, and waterfall metrics. |
speedcurve.speedcurve_list_deployments | Read | site_id, limit | List recent deployments in SpeedCurve and their performance impact. Shows how each deploy affected Core Web Vitals and load times. |
speedcurve.speedcurve_create_deployment | Write | site_id, note, detail | Register a new deployment in SpeedCurve to trigger synthetic performance tests. Use this when deploying code changes to track their performance impact. |
speedcurve.speedcurve_get_current_user | Read | none | Get details about the currently authenticated SpeedCurve user. Useful for verifying API credentials and checking account information. |
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.