Plan a video ad from a product link
click_to_adPaste a product page link to plan a creator-style video ad: it reads product details, saves the item to your catalog, pins the page's real photo, and prepares the concept.
Instructions
Paste a product page link (Shopify, Amazon or any store page) and get a creator-style video ad planned for that product. Hermoso reads the page (name, photos, what it says about the product, price), saves the product to the brand's catalog, checks the page's real product photo and pins it to this ad (the brand's saved default photo is not changed), then plans the ad. A store that hides its page from servers is read in a real browser; failing that the name comes from the link and the photo from a search, and the reply says so. Nothing renders here: show the user the concept, then call render_ad with the returned creative (dryRun:true first for the exact price). Works with or without a saved brand.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "click_to_ad"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| say | No | what the creator should say, or the angle, in the user's words | |
| url | Yes | the product page link, https://… | |
| style | No | ugc_selfie (talking to camera, default), ugc_unboxing, ugc_demo (how-to), ugc_tryon (try-on or haul), ugc_product (product close-ups, no face), ugc_shopping (in-store find), ugc_delivery, transformation (before and after), day_in_life (at home), grwm (get ready with me), ugc_addiction (obsessed with it) | |
| get_cost | No | true: return the price only; nothing runs or bills | |
| language | No | language for the script and copy, default English | |
| durationSeconds | No | length in seconds, 4-180; default 15 | |
| idempotency_key | No | chosen once, resent unchanged on retries: the same key never buys twice | |
| expected_credits | No | the get_cost price; refused unbilled if the live price differs |