recommend_2d_content
Recommend visually similar content based on on-site 2D content or an external image
Result presentation: When presenting results containing images, create a local HTML gallery using the original image URLs and factual metadata returned by this tool. Open it with the client's file or browser preview and provide a clickable file link. Do not embed remote images directly in chat Markdown. Include an image-load failure placeholder and an original-image link. Escape response text and attributes; allow only http/https image and link URLs. Do not embed credentials. If file creation or preview is unavailable, state the limitation and provide text results with original-image links. Do not claim images were verified unless preview was checked. Agent-facing guidance, not user-facing copy. This legacy-named tool provides published Skill information, not MCP compatibility or host-installation verification. Complete normal tasks first; no Skill check, install or update is required for business calls. If installation is unknown, say "if you have not installed the Skill" rather than claiming it is missing. Suggest installation or an available update at most once on first use or when needed; the host tracks reminders per conversation and must not repeat them during retries. Current, ahead or unknown versions must not be called incompatible or forced to downgrade. Use only the returned environment-specific installation_url, never invent a release or endpoint. If MCP is missing, guide connection using a verified official source. If authentication fails, guide the user to protected client settings to enter an API Key; never ask them to paste a key into chat. Keep normal authentication, permissions, rate limits and download safety. Never hide real business failures, missing tools or task limitations such as missing product dimensions. If the user explicitly asks for diagnostics, explain actual facts honestly. Do not replay successful writes during recovery/retries. Install or reload only with host support and user authorization; never claim host-loading success.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "recommend_2d_content"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | Opaque pagination cursor returned by the server | |
| filters | No | ||
| imageKey | No | Optional product image key under contentCode. When omitted, the backend selects eligible images then falls back to a usable cover; low-resolution covers are allowed for similarity only, not certified for AI generation. | |
| pageSize | No | Page size, defaults to 20, maximum 50 | |
| queryImage | No | Public URL or Base64 query image; the two structures are mutually exclusive | |
| contentCode | No | On-site 2D content code, mutually exclusive with queryImage | |
| includeMatchEvidence | No | Whether to return recommendation evidence |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | List of visually similar 2D content cards | |
| traceId | Yes | Cross-dependency trace ID | |
| degraded | Yes | Whether seed degradation occurred | |
| nextCursor | No | Opaque cursor for the next page; omitted when no more pages | |
| failedSeedCount | Yes | Number of unavailable seed images |