GClimb

    Tools

    MCP GClimb tools, their parameters and their credit cost. Your assistant only sees the tools open to your account: a closed tool does not show up.

    lookup

    Cost: Free

    Resolves a brand name, a domain or a page URL into stores of the GClimb index (shop_id, domain, name, country). Call it first when the user names a store: the other tools take a shop_id. Searches every country; at most 5 results.

    ParameterTypeRequiredDescription
    qstringyesBrand, domain (store.com) or URL (https://…).

    search_shops

    Cost: 1 credit per row returned (at most 25 per call)

    Lists the e-commerce stores of the GClimb index for a country, with estimated visits, Google ads (active, launched over 7 and 30 days) and niche. Filters: niche, name or domain, thresholds. Sort “new_30d” = stores that launched the most ads over 30 days.

    ParameterTypeRequiredDescription
    countrystringyesCountry code.FR, US, UK, DE, ES, IT, NL, BE, CA
    querystringnoStore name or domain (searches every country).
    nichestringnoNiche slug (list_niches).
    sortstringnoSort order.active, new_30d, visits, growth, niche_volume, traffic_value, avg_cpc, main_keyword_volume, products, created
    min_visitsintegernoMinimum estimated monthly visits.
    min_new_30dintegernoMinimum ads launched over 30 days.
    min_activeintegernoMinimum active ads.
    pageintegernoPage (default 1).1–40
    per_pageintegernoRows per page.1–25

    get_shop

    Cost: 5 credits per call

    Full profile of a store: products, best sellers, apps and pixels, social networks, customer reviews, visits and Google ads by country (launch pace over 12 weeks), niche and main keywords (when country is given).

    ParameterTypeRequiredDescription
    shop_idstringyesStore identifier (lookup or search_shops).
    countrystringnoCountry code.FR, US, UK, DE, ES, IT, NL, BE, CA

    get_shop_ads

    Cost: 1 credit per row returned (at most 36 per call)

    Google ads of a store, most recently shown first: format, type (Shopping, Search…), title, price, first and last seen dates, estimated impressions by EU country when measured. 36 ads per page; next_cursor gives the next page.

    ParameterTypeRequiredDescription
    shop_idstringyesStore identifier (lookup or search_shops).
    countrystringnoCountry code.FR, US, UK, DE, ES, IT, NL, BE, CA
    cursorstringnonext_cursor from the previous page.

    search_ads

    Cost: 1 credit per row returned (at most 36 per call)

    Library of Google ads shown in an EU country (FR, DE, ES, IT, NL, BE), all stores together. Sort: last, first, shown, running. Filters: niche, format, active ads, minimum running time. 36 per page.

    ParameterTypeRequiredDescription
    countrystringyesCountry code.FR, DE, ES, IT, NL, BE
    sortstringnoSort order.last, first, shown, running
    nichestringnoNiche slug (list_niches).
    formatstringnoAd format.text, image, video
    active_onlybooleannoOnly ads shown in the last few days.
    min_daysintegernoMinimum running time, in days.1–3650
    cursorstringnonext_cursor from the previous page.

    list_niches

    Cost: Free

    Lists the e-commerce niches GClimb follows in a country, with total monthly search volume, median CPC and number of keywords. The slug filters search_shops, search_ads and get_niche.

    ParameterTypeRequiredDescription
    countrystringyesCountry code.FR, US, UK, DE, ES, IT, NL, BE, CA

    get_niche

    Cost: 5 credits per call

    Profile of a niche in a country: search volume, median CPC and bids, competition, purchase intent share, trend and seasonality, measured keywords and the stores that capture the most traffic. Amounts in the country’s currency.

    ParameterTypeRequiredDescription
    slugstringyesNiche slug (list_niches).
    countrystringyesCountry code.FR, US, UK, DE, ES, IT, NL, BE, CA

    get_shop_keywords

    Cost: 1 credit per row returned (at most 100 per call)

    Google keywords that bring organic traffic to a store in a country: volume, CPC, position, estimated traffic. measured = false: not measured yet for this country. Paginated with page and per_page.

    ParameterTypeRequiredDescription
    shop_idstringyesStore identifier (lookup or search_shops).
    countrystringyesCountry code.FR, US, UK, DE, ES, IT, NL, BE, CA
    pageintegernoPage (default 1).1–100
    per_pageintegernoRows per page.1–100

    get_shop_ad_keywords

    Cost: 1 credit per row returned (at most 25 per call)

    Google searches where a store was seen, by family: organic results, Search ads, Shopping ads (best position, first and last seen), with each search’s volume and CPC.

    ParameterTypeRequiredDescription
    shop_idstringyesStore identifier (lookup or search_shops).
    countrystringyesCountry code.FR, US, UK, DE, ES, IT, NL, BE, CA

    similar_shops

    Cost: 1 credit per row returned (at most 25 per call)

    Stores close to a store of the index (neighbouring catalogue and positioning, every country), with estimated visits, active ads and main keyword.

    ParameterTypeRequiredDescription
    shop_idstringyesStore identifier (lookup or search_shops).

    my_watchlist

    Cost: 1 credit per row returned (at most 100 per call)

    The competitors your account follows: active ads, ads launched over 30 days (by week), estimated traffic and trend, Shopping / Search share, number of products.

    No parameters.

    compare_competitors

    Cost: 1 credit per row returned (at most 5 per call)

    Compares 2 to 5 followed competitors side by side (by shop_id or domain): active ads, ads launched over 30 days, estimated traffic and trend, Shopping / Search share, number of products.

    ParameterTypeRequiredDescription
    shopsarrayyesshop_id or domains of the followed competitors to compare.2 to 5 items

    watch_activity

    Cost: 1 credit per row returned (at most 60 per call)

    What your followed competitors did over a period, day by day: ads launched (titles and prices), new products, price changes, estimated traffic changes.

    ParameterTypeRequiredDescription
    periodstringnoPeriod. Default: 7d.24h, 7d, 14d, 30d

    watch_products

    Cost: 1 credit per row returned (at most 50 per call)

    Products your followed competitors push in Shopping ads: the most shown and the new ones over the period (title, price, number of ads, dates).

    ParameterTypeRequiredDescription
    daysintegernoPeriod in days. Default: 7.7, 14, 30

    my_markets

    Cost: 1 credit per row returned (at most 25 per call)

    The niches your account follows, with their latest snapshot: stores in the niche, stores advertising, new stores, search volume, growing stores and most shown ads.

    No parameters.

    my_audits

    Cost: 1 credit per row returned (at most 25 per call)

    Your latest Merchant Center audits: audited site, date, status, score out of 100, number of blocking issues.

    ParameterTypeRequiredDescription
    limitintegernoNumber of audits (default 10).1–20

    get_quotas

    Cost: Free

    What your GClimb account has left this month: MCP credits (used, remaining, limit), audits, keyword searches, followed stores, followed niches, and the reset date.

    No parameters.