hypd_search_help
ChatGPTSearches HYPD's help center for articles that answer a question about HYPD itself: connecting or reconnecting ad accounts, plans, billing and credits, privacy and data access, what HYPD can do, and setting HYPD up in Claude, ChatGPT or other AI clients. Returns the matching articles' text and links; answer from them and cite them. Not for advertising advice or the user's account data; use the platform tools for those.
init
ChatGPTReturns 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.
merchant_account_issues
ChatGPTShop-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_ads_links
ChatGPTThe 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_competitive_visibility
ChatGPTShopping 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_get_product
ChatGPTOne 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_list_disapproved_products
ChatGPTProducts 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_products
ChatGPTPages 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_shops
ChatGPTThe 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_price_competitiveness
ChatGPTCompare 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_product_performance
ChatGPTProduct clicks, impressions, CTR, conversions and conversion value over a date range, segmented by up to four dimensions (offer, title, brand, category, date, week or marketing method). Rows use camelCase: clicks/impressions are int64 strings; clickThroughRate and conversions are numbers. conversionValue is {amountMicros, currencyCode}: divide amountMicros by 1000000 and retain currencyCode; never sum different currencies. Sort descending for top products, ascending for low traffic; limit defaults to 100, max 1000. Requires a sub-account; advanced/multi-client parent accounts are unsupported.
merchant_product_status
ChatGPTOne 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_summarize_issues
ChatGPTAggregates item-level issues by code and severity, with product counts, sample offer ids, suggested resolution and approval totals. Scans at most 5000 products: scanned_products is the number examined, and truncated=true means counts are partial. Use merchant_list_disapproved_products to browse affected products. Requires a sub-account; advanced/multi-client parent accounts are unsupported.
