quicker-browser-script

quicker-browser-script

Pipeline: prototype script live → save as action → wire a trigger so the script runs automatically on matching pages/events.

Requires the Quicker browser extension (Quicker Connector) connected; uses the user's logged-in browser.

P1 — Prototype the script live

1. user_browser({ action: "tabs" }) — confirm extension connected; pick tabId
2. user_browser({ action: "run", operation: "RunScript", parameters: { tabId, script } }) — script runs in page context; return a JSON-serializable value as the result
3. Iterate until output is correct; reuse sessionId, tabId is auto-carried when omitted
4. Other operations (OpenUrl, GetTabInfo, GetElementInfo, …): schema via qkrpc_step_runner_get key=sys:chromecontrol + controlField = operation

CLI / MCP equivalents: qkrpc chrome tabs|run / qkrpc_chrome_tabs / qkrpc_chrome_control.

P2 — Save as a Quicker action

1. qkrpc_action_create → edit body with workspace_program (authoring-workflow P1–P7)
2. Steps use sys:chromecontrol — always qkrpc_step_runner_get key=sys:chromecontrol --control-field RunScript first; never guess inputParams
3. Full module doc: docs({ action: "get", topic: "chromecontrol-authoring" }); patch with reference: "examples/chromecontrol"
4. Verify with qkrpc_action_debug (step outputs), not plain run

P3 — Trigger setup (auto-run)

Full workflow: docs({ action: "get", topic: "trigger-workflow" }) (Tr0–Tr5). Summary:

1. quicker_trigger({ action: "events" }) — get exact eventType, fields[].key / helpText, and variables[].key. Always before add/update.
2. Add the rule:

quicker_trigger({
  action: "add",
  eventType: "BrowserUrlChanged",
  params: { UrlPattern: "https://github.com" },
  actionIdOrName: "<action guid>",
  note: "run page script on GitHub",
})

UrlPattern is a URL-prefix match (semicolon-separated for multiple); use a regex: prefix for regular expressions — not bare regex.

1. Manage: list (query keyword) / update / enable / disable; delete only on explicit user ask.
2. Optional: filter ($= bool on variables); delayMs to wait before running.