Find image

• Type phone.findImage
• Group MZBase
• Role action
• Risk reads only
• Side effect safe to repeat
• Runs once per item
• Needs phone, media

Finds a reference image on the phone screen

Also available to AI agents and over MCP as a tool.

Parameters

phoneId

Phone · string · optional

The phone to use. Empty = the phone of the run’s target.

templateSource

Reference image from · string · required · default binary · one of binary, media

The picture to look for on the screen: a file on the item or a media library image.

templateBinaryProperty

Reference image property · string · optional · default data

Shown when templateSource is binary.

templateMediaId

Reference image (media) · string · optional

Shown when templateSource is media.

threshold

Match threshold · number · optional · default 0.85 · range 0.5 – 1

How close a match must be, 0–1. Lower finds more but may match the wrong place.

scales

Scales · array · optional · default [1]

region

Region · json · optional

failIfMissing

Fail if not found · boolean · optional · default false

keepScreenshot

Keep the screenshot · boolean · optional · default false

into

Into field · string · optional · default match

Outputs

• main

← All nodes