HYPD.AI for Feed Optimization

Pages through a shop's product feed with submitted attributes (titles, prices, availability, GTINs). Each row carries product_name — copy it into merchant_get_product or merchant_product_status. page_size defaults to 50, max 250; pass returned next_page_token as page_token. Each page reads live data without a stored-result id.

merchant_list_products

One product's approval state per destination plus its item-level issues — what is disapproved or demoted, where, and why. Takes the product resource name from merchant_list_products. For a shop-wide sweep use merchant_summarize_issues; for the disapproved subset use merchant_list_disapproved_products.

merchant_product_status

Shop-level problems: suspensions, policy warnings, and misconfigurations that affect the whole Merchant Center account rather than individual items. Relevant when everything seems disapproved at once: an account-level issue often explains it.

merchant_account_issues

Compare product prices with Google's market benchmark. price and benchmarkPrice are Price objects: divide amountMicros by 1000000 and retain currencyCode. Requires Market Insights enabled and a sub-account; advanced/multi-client parent accounts are unsupported. page_size defaults to 50, max 250. Pass the returned next_page_token as page_token for the next page; each call reads live data without a stored-result id.

merchant_price_competitiveness

Shopping visibility for a category, country and date range: competitors lists similar businesses, top_merchants the highest-ranked merchants, benchmark the shop's trend against the category average. Requires Market Insights enabled and a sub-account; advanced/multi-client parent accounts are unsupported. Pass report_category_id and report_country_code. traffic_source defaults to ALL; limit defaults to 50, max 250. This is a limited report, not a paginated full competitor inventory.

merchant_competitive_visibility

The user's connected Merchant Center shops — each with its name and the shop_id every other merchant_* tool takes. Every other merchant_* tool takes a shop_id from this list. An empty list means the user has not connected Google Merchant Center yet (they can do so at https://app.hypd.ai/sources?manage=merchant-center), and plan_notice explains shops held back by the user's plan.

merchant_list_shops

Products currently disapproved somewhere, one row per product with affected destinations. merchant_product_status gives an item's exact issues. Requires a sub-account; advanced/multi-client parent accounts are unsupported. page_size defaults to 50, max 250; pass returned next_page_token as page_token. Each page reads live data without a stored-result id.

merchant_list_disapproved_products

The Google Ads accounts this shop is linked to, with each link's state and whether that ads account is also connected in HYPD. Answers 'which campaigns can even use this feed?' — a missing or pending link is why Shopping ads show nothing despite a healthy feed.

merchant_ads_links

Returns the Merchant Center guide — call it first in a new conversation. Covers what each merchant_* tool reads, the audit workflow (list shops, check feed health and disapprovals, then performance, pricing, and competitive visibility), what to do when no shops are connected, and starter prompts.

init

One product's full submitted data — every attribute the feed carries for it (pricing, availability, identifiers, shipping, custom labels). Takes the product resource name from merchant_list_products. For approval state and item issues, use merchant_product_status instead.

merchant_get_product