Amazon whoami (signed-in account)
Report whether this browser is signed in to Amazon.com and, if so, the account's first name from the header greeting (Amazon hides the full name and email behind a password re-check). Being signed out is reported as a normal answer (loggedIn false), not an error, so it can be used to check a session before running other Amazon scripts.
Input
None
Output
loggedIn requiredname optionalfirstName optionalFAQ
Search Amazon products
Search Amazon by free-text query and return one page of results. Returns query, page, zip, url, and items (asin, title, url, price, list_price, rating, review_count, image_url, sponsored, formats). formats lists each edition a result links to (for example Hardcover, Kindle and Audiobook for a book), with its own ASIN, URL and price when shown. Organic results are stable per page but sponsored slots rotate between fetches; pagination caps around 20 pages.
Get Amazon product reviews
Fetch Amazon customer reviews for a product by ASIN. With a signed-in Amazon session it returns one page of 10 reviews, with sort, star, media, verified-purchase and keyword filters, up to Amazon's 10-page limit. Without a session it returns the top reviews shown on the product page (page 1 only, no filters, reviews from other Amazon countries included), says so in the result, and fails with a clear error instead of ignoring a filter or page it cannot serve, or when Amazon hides the reviews from the visitor. Returns the product's rating summary and each review's rating, title, text, date, reviewer, country, variation, helpful votes, verified badge, Vine badge, images and videos. With sortBy=recent a page can change between calls as new reviews arrive; sortBy=helpful is more stable.
Get Amazon product
Fetch a single Amazon product page by ASIN. Returns title, byline, brand, price, list_price, rating, review_count, rating_breakdown, availability, breadcrumb, image_url, feature_bullets, description, attributes, variant_asins, delivery_estimate, return_policy, and seller. The returned asin can differ from the requested one when Amazon resolves a variant. For books, brand is null and feature_bullets and attributes are usually empty. Audible audiobook ASINs open Audible's own product page instead, so they fail at once with an error that gives that page's URL.
