ziniao-page

Page operations (ZClaw)

CRITICAL — Before starting, MUST first use the Read tool to read ../ziniao-shared/SKILL.md CRITICAL — Before executing Shortcuts, be sure to first read the corresponding references/ documentation. CRITICAL — When calling the ZClaw local interface, you must use the ziniao-cli command from this skill; do not use the ziniao-assistant skill to call it yourself.

Prerequisite: The Ziniao browser client must be started, and the store must be open. All page commands require --store-id(except the running mode of extract).

ZClaw authentication failure troubleshooting: If API Key authentication still fails after initializing the application, remind the user to go to https://open.ziniao.com to check whether the user application's "Terminal Management" has bound the current terminal identification code (the identification code can be viewed in the Ziniao browser settings).

Common optional parameters

All page operations support the following optional parameters:

Parameter	Description
--timeout	Timeout in milliseconds (passed as timeoutMs)
--target-id	Target page ID (specified when there are multiple tabs)

Core scenarios

Page operation workflow

Typical workflow: open store -> navigate -> wait -> operate -> screenshot to confirm

ziniao-cli store open --name "MyStore" --url "https://target.com"
ziniao-cli page wait-nav --store-id <id>
ziniao-cli page click --store-id <id> --selector "#btn"
ziniao-cli page input --store-id <id> --selector "#field" --text "value" --clear
ziniao-cli page screenshot --store-id <id> --full-page

Multi-step automation

ziniao-cli automation run --steps '[
  {"type": "visit", "url": "https://example.com"},
  {"type": "click", "selector": "#login"},
  {"type": "input", "selector": "#username", "text": "admin"},
  {"type": "screenshot"}
]'

Shortcuts

Command	Description	Detailed documentation
page visit	Navigate to URL	references/ziniao-page-visit.md
page screenshot	Screenshot	references/ziniao-page-screenshot.md
page content	Get page content	--store-id xxx --content-format text|html|structured
page query	Query DOM elements	--store-id xxx --selector "css"
page click	Click element	--store-id xxx --selector "css" --wait-nav
page input	Input text	--store-id xxx --selector "css" --text "val" --clear --submit
page scroll	Scroll page	--store-id xxx --x 0 --y 300 --behavior smooth
page exec	Execute JS	--store-id xxx --script "code"
page extract	Extract data	--mode running|store|plugin|page --payload '{}'
page wait-element	Wait for element	--store-id xxx --selector "css"
page wait-nav	Wait for navigation	--store-id xxx
automation run	Multi-step automation	references/ziniao-page-automation.md

Utility tools

Command	Description
utility download	Write content to the download directory:--content "..." --filename "file.txt"
utility debug-compare	Compare account/list with store/list:--limit 10