Skill: buy — hand-off-only retailers¶
The buy skill's handoff-only.md, as the agent reads it. The skill links here from its hand-off-only section.
Hand-off-only retailers¶
Some retailers restrict automated agents in their terms of use. Portage treats them as hand-off only by default:
- Amazon, every marketplace (amazon.com, .co.uk, .de, .ca, .co.jp, …). Its Conditions of Use restrict robots and automated data extraction. In November 2025 it sued Perplexity over an agent that shopped through users' own logged-in sessions. Using the user's own browser and account was not a defence.
- Any host in
~/.portage/config.json'shandoff_only_hosts(portage doctor --json'shandofffinding shows the current list). Absent, that key defaults to every Amazon marketplace; once present, the user's list is the list — they can drop Amazon or add other hosts. Removing one only changes the message: Portage has no code that automates a site without UCP or WebMCP. - walmart.com, ebay.com and bestbuy.com, always — no adapter, no UCP, and no user setting turns this off (unlike the config list above, since it isn't a policy choice: there's no automation to opt back into). etsy.com too, unless the CLI process is configured with its own Etsy shop's seller credentials (
ETSY_ACCESS_TOKEN/ETSY_API_KEY/ETSY_SHOP_ID— a different thing from the buyer-side Etsy offer source below), in which caseportage-ucp-etsy's ordinary seller-adapter flow applies instead.
What portage buy does automatically¶
On a hand-off-only host, portage buy <url> --query "..." returns outcome handoff_only before making any request to that host — no UCP probe, no page fetch, no cart. The report carries:
checkout_url: for Amazon, a cart-add URL when a product ID is known, else its own search URL for the query, else its homepage. For walmart.com/ebay.com/bestbuy.com, and for etsy.com when no ordinary buyer credentials apply, it's the exact URL you passed toportage buy— the real product page, when it came from a retailer offer source (below) or fromfind. For any other host with no known pattern, its homepage. Always built, never fetched.legal_notice: the facts-only disclaimer below.handoff: how that URL was delivered — the same--handoff-targetrules as any other hand-off (defaultopens it,printjust reports it,agent:<name>passes it to an approved agent). See outcomes.md.
What you do¶
- Give the user the
checkout_urland say they'll complete the purchase themselves —portage buymay have already opened it for them via thedefaulthand-off target. - Explain in one line: "Amazon doesn't allow automated purchasing agents, so I've opened the page for you to buy it."
- Don't fetch the site's pages, scrape prices, drive a browser on it, or fill its forms, including with your own browser tools. The user editing the list doesn't make you the one who automates the site.
What's still fine¶
- Listing the retailer as a candidate the user already knows (from their bookmarks, history or index).
- Comparing it against a price the user reads out to you.
- Official retailer APIs that Portage integrates as offer sources (Walmart Affiliate, eBay Browse — Buy It Now only, Best Buy Products, Etsy Open API v3, Amazon Creators), where the user has enabled them via
portage setup's "Retailer offer sources" step. These still end in hand-off, same as Amazon — none of them has a checkoutportage buycan drive.
Disclaimer¶
Portage is open-source software provided as-is, without warranty of any kind (MIT licence). How it's used on any site, and compliance with that site's terms, is the user's responsibility. Say this when a user asks to automate a hand-off-only site.
The other big retailers¶
Walmart, Target, eBay, Best Buy, Etsy, Wayfair and Home Depot don't serve public UCP today (checked 2026-09-28). Their offers, where Portage can see them, end in hand-off too. Their checkouts are never automated through the page.