create-goal
ChatGPTCreate a goal for one of the team's apps with one or more measurable targets. metric_type is one of mrr, usage_revenue, active_installs, daily_installs, churn_rate, keyword_rank (call get-goals for the full catalog). direction defaults per metric (gte for revenue/installs, lte for churn/rank). A target can measure the current value (default) or a rolling average: pass mode=rolling_avg with window_days (7, 14 or 30), or pass window_days alone to infer rolling_avg. Averaging works for mrr, usage_revenue, daily_installs and churn_rate, uses completed calendar days ending yesterday, and hits only after the average meets the threshold for window_days consecutive completed days. Averaged MRR is reported as "MRR growth per day" in dollars per day. keyword_rank targets need a keyword. The goal is evaluated immediately and returned with its current progress.
customer-notes-create
ChatGPTCreate a private note on a customer. Accepts installation_id (numeric) or customer (store name or myshopify.com domain) to identify the customer, plus title and body. Optional remind_at (plus remind_user_id or remind_email, which must be a team member) creates a follow-up task due at that time. Returns the created note.
customer-notes-delete
ChatGPTDelete a note from a customer. Provide note_id to identify the note. Returns confirmation on success.
customer-notes-list
ChatGPTList all notes for a customer. Accepts installation_id (numeric) or customer (store name or myshopify.com domain). A store name or domain resolves to the newest installation, the one the web customer profile shows. Returns id, title, body, author, the follow-up reminder (remind_at, remind_user_id, task_id) and timestamps.
customer-notes-search
ChatGPTSearch across all customer notes for an app. Matches title and body. Returns matching notes with customer info (name, domain) and body excerpt.
customer-notes-update
ChatGPTUpdate an existing note on a customer. Provide note_id to identify the note, plus any fields to change (title, body, or both). Returns the updated note.
customer-tag-attach
ChatGPTAttach a customer tag to one installation for one of your apps. Creates the tag in that app namespace if missing.
customer-tag-detach
ChatGPTDetach one customer tag from one installation. The tag remains available in the app namespace.
customer-tag-sync
ChatGPTReplace all tags on one customer installation. Empty names arrays are rejected to prevent accidental wipes.
customers-filter-by-tags
ChatGPTFind customer installations that match any or all supplied tags for one of your apps, newest install first. Test stores are excluded unless include_test is true (same rows as the web Customers page and API v1).
customers-tags-list
ChatGPTList customer tags for one of your apps, scoped to that team app, sorted by usage count then name.
get-active-trials
ChatGPTGet the shops currently on trial for an app: the live active-trial count plus the list of those shops (plan, price, trial end date, days remaining), ordered by trial end date soonest-first. Uses the canonical Shopify on_trial definition — the same count the dashboard overview, Trials page and API report.
get-ad-keyword-performance
ChatGPTShow which ad (sponsored) keywords are performing vs wasting budget. Returns installs, pageviews, conversion rate, and organic rank comparison for each ad keyword.
get-ads-audience
ChatGPTWho the Shopify App Store ads of one of YOUR apps reach and convert: spend, impressions, clicks, installs, CTR, install rate, CPC and CPI split by country, by device (desktop, mobile) and by Shopify plan of the store, each with its share of spend, sorted by spend. Works for the whole app or one campaign, including category and homepage campaigns. Uploaded CSV reports exported without dimensions carry no split.
get-ads-goal
ChatGPTThe goal the Shopify App Store ads of one of YOUR apps are judged against: the target cost per install (target_cpi), and the target ROAS for members with revenue access. Also the blended CPI of the period (spend divided by installs), which the optimizer and the restructure plan fall back to when no target CPI is saved. When no target CPI is saved the result has needs_goal: true and a goal_question: ask the app developer that question, then save the answer with set-ads-goal. Call this FIRST in any ads review.
get-ads-keywords
ChatGPTKeyword performance of the Shopify App Store ads of one of YOUR apps (impressions, clicks, installs, spend, CTR, install rate, CPC, CPI, average position). With campaign: that campaign's keywords with bid, match type (broad or exact), status, the suggested bid range, where the bid sits against it (below, within, above) and flags such as spend_no_installs. Without campaign: keywords combined across all campaigns. Category and homepage campaigns have no keywords.
get-ads-organic-vs-paid
ChatGPTPaid Shopify App Store ads keywords of one of YOUR apps next to the app's organic rank for the same keyword, to see where it pays for traffic it already gets for free. Per keyword: verdict, organic rank, ad rank, organic and ad installs, ad spend and CPI. Spend and paid keywords follow the period; ranks and organic installs come from a rolling window of at least the last 30 days (up to 365 for older start dates). Needs rank tracking and Google Analytics search data on the app.
get-ads-overview
ChatGPTShopify App Store ads overview for one of YOUR apps: spend, impressions, clicks, installs, paying customers, CTR, CPC, CPI and CAC for the period (last 30 days by default), the funnel (impressions to clicks to installs to paying customers) with the conversion rate of each step, and one row per campaign (ad type search, category or homepage; status; daily budget; the funnel step where it falls furthest below the account). Pass compare=true to also get the previous equal-length period and how each funnel step moved. Start here, then drill into a campaign with get-ads-keywords or get-ads-search-terms.
get-ads-recommendations
ChatGPTThe Ranksy ads optimizer's ranked advice for the Shopify App Store ads of one of YOUR apps, the same list as the Optimizer page: add a keyword, add a negative, pause a keyword, raise or lower a bid, stop paying for an organic rank, exclude a country / plan / device, change a campaign budget. Each item has the action, the reason, the evidence, the monthly impact, a confidence (high, medium, low), and its state (done or dismissed, or null when still open). Rules are fixed and judged against the target CPI (see get-ads-goal); with no target saved they are judged against the period's blended CPI and the result says so with needs_goal: true. Money is scaled to a 30-day month. Mark advice with mark-ads-recommendation using the item key.
get-ads-restructure-plan
ChatGPTThe Ranksy campaign restructure plan for the Shopify App Store search ads of one of YOUR apps, the same plan as the Restructure view of the Optimizer page: the problems found in today's campaigns, the campaigns as they are, a proposed set of campaigns grouped by performance (not intent), a daily budget split that adds up to the current total, and the migration steps. status and the messages say in plain language whether a restructure is proposed, and if not, why (too little data, already well structured). It is judged against the target CPI (see get-ads-goal). The plan is computed from the ads data in the period and cached for a few minutes. Quote its numbers exactly; do not recalculate them.
get-ads-search-terms
ChatGPTThe actual searches that triggered the Shopify App Store ads of one of YOUR apps, with the keyword each one matched, spend, clicks, installs, CPI and average position, sorted by spend. Each term carries not_a_keyword (the app does not bid on this exact term), converting_not_yet_keyword (it earns installs but is not a keyword yet) and spending_no_installs. Filter with flag: not_a_keyword, no_installs or converting. Category and homepage campaigns have no search terms.
get-ads-strategy
ChatGPTThe newest AI strategist run for the Shopify App Store ads of one of YOUR apps in this period and with these filters, whatever its status (queued, generating, completed, failed). A completed run holds the strategy (summary, target architecture, campaign notes, critique of the restructure plan, keyword ideas, risks and a review checklist) and stale: true when the restructure plan has changed since it was written. run is null when none exists: start one with run-ads-strategist, then poll this tool. Needs the ai.access team permission, like the Optimizer page.
get-ads-trend
ChatGPTShopify App Store ads performance over time for one of YOUR apps: spend, impressions, clicks, installs, CTR, CPI and average position per day or per week, plus what changed in the same period so you can explain a shift. changes is the ads setup change log (bids, budgets, keywords added or removed, campaigns paused) in plain words; listing_events are app listing edits and new reviews. Days with no synced ads data are absent from the series.
get-ads-wasters
ChatGPTWhere the Shopify App Store ads of one of YOUR apps spend money without results, found with fixed rules. keyword_waste groups keywords into dead_spend, cannibalizing_organic, overpriced, click_no_install and impression_hogs (each keyword in at most one group, with the rule that matched and the spend involved). negative_keyword_candidates lists search terms with clicks but no installs, search terms with impressions but no clicks, and themes of irrelevant searches such as payments or shipping. This is data, not advice: check a term against the app before blocking it.
get-app-info
ChatGPTGet public listing information for any Shopify app(s). Works with any app slug for competitor research. Use search tool first to find slugs.
get-app-listing
ChatGPTGet the current Shopify App Store listing for an app including name, subtitle, introduction, details, features, and character counts. Use this to understand what needs improvement.
get-app-rankings
ChatGPTGet category and keyword rankings for ANY public app in the Shopify App Store. No ownership required.
get-attribution-data
ChatGPTGet marketing attribution data showing which channels drive revenue and conversions. Supports multiple attribution models. channel_attribution uses GA4 first-touch and matched paid-social last-click. The model affects keyword_attribution and model_comparison only; see channel_attribution_model.
get-cannibalization-report
ChatGPTIdentify keywords where organic and paid ads overlap (cannibalization), keywords where ads are essential, and irrelevant ad keywords wasting budget. Helps optimize ad spend.
get-categories-stats
ChatGPTGet statistics across all Shopify App Store categories. Find categories with best/worst ratings, most apps, most reviews. Use for market research and identifying opportunities.
get-category-apps
ChatGPTList all apps ranked in a Shopify App Store category with their positions. Use for market research and competitive analysis.
get-category-insights
ChatGPTAnalyze a Shopify App Store category - common complaints, feature gaps, ratings distribution, and sentiment analysis.
get-category-rankings
ChatGPTGet current category ranking positions for ANY app in the Shopify App Store. No ownership required — works with any public app slug.
get-channel-daily
ChatGPTGet the per-day, per-channel series for an app over a period: visitors, pageviews, installs, trials, trial conversions and MRR per (date, channel). Rows are sparse — only pairs with activity appear. Basis: pageviews/visitors use the event's own channel on that UTC day; installs are install-day, first-touch channel, reconciled to the real-only install truth; trials/paid use lifecycle event dates attributed to the shop's install channel (30-day lookback). Real merchants only.
get-churn-analysis
ChatGPTGet churn analysis including logo churn rate, revenue churn rate, and churned customer details from the Shopify Partner API.
get-churned-customers
ChatGPTGet per-shop churned customer list with lifetime revenue and last plan info.
get-cohort-retention
ChatGPTGet install or subscription cohort retention matrices for a Shopify app: for each acquisition cohort (day/week/month), the share of merchants still installed / still paying at each later period. Rows can also be grouped by first-touch traffic source (group_rows=source) to compare retention quality across acquisition channels.
get-competitor-listings
ChatGPTGet the full listing content (name, subtitle, introduction, details, features) from competitor apps. Use this to see what successful competitors are doing and find patterns to emulate.
get-conversion-funnel
ChatGPTGet the conversion funnel for an app over a period: installs, trial starts, and trial conversions, with stage conversion rates and revenue. Matches the attribution dashboard funnel. Also returns trial_conversion — THE trial conversion rate, converted / settled (converted + cancelled), excluding trials still running; is_provisional is true while the cohort has not fully ended, and a rate of 0 with settled=0 means no trial has ended yet (no signal), not a 0% conversion rate.
get-customer-lifecycle-events
ChatGPTGet per-shop customer lifecycle events (installed, trial started, subscribed, churned, etc.) from the customer_lifecycle_events table.
get-customer-ltv
ChatGPTGet per-customer lifetime value (LTV) ranking: the gross revenue actually collected from each shop over its lifetime, with plan, current MRR, and attribution. Lists the current paying customers.
get-customer-team-apps
ChatGPTList the other apps from the current team that this merchant (shop) has installed, split into active and churned. Use to spot multi-app merchants for cross-sell or churn-risk.
get-goals
ChatGPTList the team's goals with progress: each goal has status (active/achieved/missed/archived), deadline, overall progress_percent, and its targets (metric, target_value, current_value, direction, mode, window_days, hold_progress, hit_at). Optionally filter by app_slug or status, or pass goal_ulid to fetch one goal with freshly re-evaluated values. Also returns the metric_types a goal can target and the rolling-average modes/windows (use with create-goal); averaged MRR targets are labeled "MRR growth per day".
get-installations
ChatGPTGet installation metrics from the Shopify Partner API. summary.total_installs is new installs plus reinstalls (reactivations); summary.total_uninstalls is uninstalls plus deactivations (store frozen or closed); summary.breakdown lists each event {new_installs, reinstalls, uninstalls, deactivations}. Also total_reactivations, total_deactivations, net installations (total installs - total uninstalls), active installs at the end date, and a per-period breakdown (each period row has installs and uninstalls as the same sums, plus its own breakdown object). Real stores only unless include_test is true. meta.last_synced is the last successful end-to-end Partner pipeline completion, not a data-through timestamp; meta.partner_sync carries the sync health, last error, and the newest install row held (data_through).
get-installs-by-category
ChatGPTGet installation metrics broken down by app store categories from BigQuery analytics.
get-installs-by-keyword
ChatGPTGet installation metrics broken down by search keywords from BigQuery analytics.
get-keyword-apps-rankings
ChatGPTGet all apps ranking for a specific search keyword in the Shopify App Store. Use for keyword research and competitive analysis.
get-keyword-daily-trends
ChatGPTGet daily ranking + traffic data for a specific keyword. Shows organic and sponsored rank, pageviews, and installs per day. Useful for measuring the impact of listing changes on specific keywords.
get-keyword-focus
ChatGPTWhich of the user's TRACKED keywords to work on this week for one of their apps. Every tracked keyword gets a tier from its latest organic App Store rank (defend 1-3, push 4-10, striking 11-24, long_shot 25-50, off_radar) and a priority score from demand, how much the keyword's top 10 churns, 7-day momentum and 14-day installs. Returns the ordered focus list with a plain-language reason and the single action to take per keyword, tier counts, and the tracked keywords that share a results page (clusters) and move together. Use this before improve-listing to choose focus_keywords.
get-keyword-installs-by-source
ChatGPTGet keyword installation metrics split by organic vs sponsored (ad) source. Shows which keywords drive installs from organic search vs paid ads, with share percentages.
get-keyword-rankings
ChatGPTGet current keyword ranking positions for ANY app in Shopify App Store search. No ownership required — works with any public app slug.
get-outranked-keywords
ChatGPTGet keywords where competitors rank higher than the user's app. These represent opportunities to improve search visibility by optimizing listing content for these terms.
get-ranking-history
ChatGPTGet historical ranking data for ANY app in a category or keyword to see trends over time. No ownership required — works with any public app slug.
get-recent-reviews
ChatGPTGet recent reviews from the Shopify App Store - filter by category, app, rating, or sentiment. Use for market and sentiment research.
get-recent-updates
ChatGPTGet recent app listing changes in the Shopify App Store - pricing changes, feature updates, name changes, and more.
get-revenue-overview
ChatGPTGet revenue metrics including MRR, monthly revenue, growth rates, and revenue trends from the Shopify Partner API. Includes usage-based billing revenue: MRR figures are usage-inclusive, this_month carries the calendar-month usage_revenue/usage_shops split, and usage_history is the per-month usage revenue series. For a deeper usage drill-down (daily series, top usage-spending shops) use get-usage-revenue. meta.last_synced is the last successful end-to-end Partner pipeline completion; meta.partner_sync carries sync health and data_through.
get-reviews
ChatGPTGet user reviews from the Shopify App Store for any public app. Includes ratings, review content, country, and developer replies. For apps YOUR team owns, each review also carries a best-effort "domain" (the reviewer shop's myshopify domain) plus "shop_country" — these come from your own Partner API attribution and are omitted for apps you do not own. domain is null for reviews that could not be attributed to an installing shop (~6-33%); no reviewer email is available, so domain is the only join key. Domains are Shopify hashes (e.g. g9mjcy-je.myshopify.com) — match them exactly, never fuzzy-match against a store name.
get-scorecard
ChatGPTGet the competitive health scorecard for one of YOUR apps: a weighted overall score (0-100) plus four sub-scores — listing_quality, keyword_performance, reviews_reputation, visibility — each with its detailed breakdown, prioritised improvement opportunities, and a head-to-head competitor comparison. Team-scoped (requires app ownership). Reads the cached scorecard and only recomputes (no-AI, pure-DB) when it is missing, stale (>24h), or refresh=true. When the team follows no competitors, the score is computed against a PROVISIONAL set and is_provisional is true.
get-shopify-guidelines
ChatGPTGet Shopify App Store listing guidelines, character limits, best practices, and anti-patterns to avoid. Essential reference for creating compliant, high-quality listing content.
get-similar-apps
ChatGPTDiscover CATALOG-SIMILAR apps for ANY app — the same list as the app's Similar apps page in Ranksy: apps with similar functionality (listing descriptions), shared features and categories, ranked by similarity score. This is public market-research discovery and works with any app slug; ownership is NOT required. This is NOT your tracked/followed competitor set — for the competitors a team explicitly follows (with head-to-head intelligence), use get-tracked-competitors instead.
get-store-installs
ChatGPTGet per-store install list with install source (first-touch traffic channel, keyword, surface), uninstall reasons (canonical taxonomy + raw description), Shopify store profile (country, city, currency, plan, timezone), and current status. Use to analyze install attribution and churn per store and link with Mixpanel via shop_id.
get-subscriptions
ChatGPTGet subscription data from the Shopify Partner API: a canonical summary and plan distribution, PLUS a paginated per-subscriber list. Each subscriber row includes its activation and cancellation dates, plan, status, and amount. Filter the list by status (e.g. cancelled), plan, billing interval, and activation/cancellation date ranges (activated_after/before, cancelled_after/before), and sort by activated_at or cancelled_at. Use these to build monthly cohorts, net-adds curves, and churn analyses — e.g. which accounts on a given plan cancelled in a specific month.
get-team-app-details
ChatGPTGet detailed information about YOUR app including integration status (Partner API, Analytics). For competitor/market research, use get-app-info instead.
get-top-movers
ChatGPTFind apps with the biggest ranking changes (gainers and losers) in the Shopify App Store. Use to identify trending apps.
get-tracked-competitors
ChatGPTGet the team's TRACKED (followed) competitor set for one of YOUR apps, plus the head-to-head competitor intelligence the dashboard surfaces: keyword overlap, outranking win/loss stats, reviews comparison, pricing distribution, and advertising activity. Team-scoped — requires app ownership. When the team follows no competitors yet, a PROVISIONAL set (embedding-similar → top-category apps) is returned and is_provisional is true. This is NOT public market discovery — for catalog-similar apps for ANY slug, use get-similar-apps instead.
get-traffic-keywords
ChatGPTGet keywords that are driving installs for an app. These keywords should be incorporated into listing content to maintain and improve search visibility.
get-traffic-overview
ChatGPTGet traffic metrics including sessions, page views, installs, conversion rate, and traffic source / geographic breakdown. key_metrics.installs.value is total installs (new installs plus reinstalls) and key_metrics.installs.breakdown lists each event {new_installs, reinstalls, uninstalls, deactivations}. Headline metrics match the dashboard Traffic page. paid_social remains the combined total; its platform_breakdown contains Meta, Reddit, TikTok and unidentified networks. Defaults to the last 30 days.
get-traffic-source-trends
ChatGPTGet weekly or biweekly breakdown of traffic sources over time. Shows how each traffic source (direct, search, search_ads, etc.) trended across the period. Replaces the need for multiple get-traffic-overview calls.
get-transactions
ChatGPTGet transaction history including sales, refunds, credits, and metered usage charges from the Shopify Partner API. The summary breaks the headline gross_revenue down with a usage_revenue subtotal, and type=usage filters the list to usage-charge transactions only.
get-uninstall-reasons
ChatGPTGet aggregate breakdown of uninstall reason codes with counts and percentages. The survey is multi-select, so percentages are a share of uninstalls and can sum to more than 100%.
get-usage-metrics
ChatGPTGet per-event_handle aggregated app-event usage for an app: for each event handle in the period, the event count and the summed value (from the events the app reports to /track, including custom usage events like sms_sent), plus a bucketed trend series and the billed-usage total. Filter by event_handle (comma-separated) and/or a single shop (myshopify domain) to drill into one customer. This is the same data as the in-app Usage Events report and the /usage-metrics API.
get-usage-revenue
ChatGPTGet usage-based (metered) billing revenue for an app: daily usage revenue time series, summary totals (revenue, unique shops, charge count, usage ARPU, subscription MRR vs usage split), and the top usage-spending shops for the period. Only meaningful for apps billing on usage (subscription_plus_usage / pure_usage) — the same data as the web Usage tab. Real stores only unless include_test is set.
improve-landing-page
ChatGPTPrepare the copy for an app's Ranksy-hosted ad landing page. The page shows a headline, a description and feature cards. They use the App Store listing text unless the team sets custom copy, and custom copy helps the page pass ad review, because pages that repeat the listing can be flagged as low quality. This tool saves nothing and calls no model. It returns the copy the page shows now, the listing text, the character limits, the page URLs (preview_url renders the page without firing ad pixels) and a writing brief: instructions (the system prompt), prompt (the user prompt) and json_schema (the shape of the output). Workflow: 1. Call this tool with app_slug, and with brief when the user names an angle, an audience or points to stress. 2. Write the copy with instructions as the system prompt and prompt as the user prompt, in the shape of json_schema. Keep every field within its limit. 3. Show the draft to the user. After they approve it, call save-landing-page-copy.
improve-listing
ChatGPTPrepare a complete, ready-to-execute listing improvement brief that mirrors the in-app AI flow. The tool gathers all the context (app listing, traffic keywords, outranked keywords, ranking impact patterns, competitor listings, Shopify guidelines), creates a tracked ListingImprovement record, and returns per-field bundles containing the exact system instructions, user prompt, and JSON schema you must follow when generating each suggestion. Workflow: 1. Call this tool with app_slug (and optionally focus_keywords, selected_fields, competitor_app_ids, app_description). 2. For EACH field in the response, generate a structured suggestion using the bundle's instructions as the system prompt, prompt as the user prompt, and json_schema as the required output shape. Do not paraphrase the prompts — they encode character limits, anti-patterns, and ranking intelligence. 3. Validate every suggestion: character_count must be ≤ character_limit and the suggestion must use 90-100% of the character budget. 4. Call save-listing-improvement with the returned generation_id and the array of all generated improvements to finalize.
list-team-apps
ChatGPTLists YOUR Shopify apps (apps you own/manage via your teams). Returns app slugs with Partner API and Analytics integration status. Use for your own app data, not market research.
mark-ads-recommendation
ChatGPTMark one optimizer recommendation of one of YOUR apps as done (the app developer made the change), dismissed (not relevant), or open again (clears the mark). Identify it by the key from get-ads-recommendations. The mark is shared with the Optimizer page and survives recomputation. This does not change anything in Shopify. Needs the apps.manage team permission, like marking advice in the Ranksy app.
render-chart
ChatGPTRender a chart INLINE in the chat from data you already have. Use this whenever the user asks to "chart", "graph", "plot", or "visualize" a metric — e.g. MRR over time, installs by month, ranking history, churn trend, or a comparison across plans/categories. First fetch the numbers with the relevant data tool (get-revenue-overview, get-installations, get-ranking-history, get-churn-analysis, etc.), then call render-chart with those numbers. Provide labels (x-axis), one or more named series (y-values aligned to labels), and axis labels/units. Supports line (trends over time) and bar (comparisons).
rule-runs-list
ChatGPTList recent runs of one CRM automation rule (fired and skipped, with the reason). Use rules-list first to get the rule id. Read-only: this is how an agent explains why an automatic task exists.
rules-list
ChatGPTList the CRM automation rules of one app: trigger, conditions, actions, enabled state, and how many tasks they fired in the last 7 days. Read-only; use rule-runs-list to see why a task exists. Requires app_slug or team_app_ulid.
run-ads-strategist
ChatGPTStart the Ranksy AI strategist for the Shopify App Store ads of one of YOUR apps: it reviews the restructure plan for the period and writes a campaign strategy. It runs in the background for a few minutes and uses one of the app's limited daily strategist runs, so start it only when asked or when the plan changed. Needs the ai.access team permission. Only one run can be active per app. It starts nothing when there is no restructure plan to review. Returns the run id and status: poll get-ads-strategy with the same period and filters until the status is completed or failed.
save-landing-page-copy
ChatGPTSave the headline, description and feature cards shown on an app's Ranksy-hosted ad landing page. This replaces the copy on the live page, so call it only after the user has approved the text; improve-landing-page returns the current copy and a writing brief. Only the fields you pass change: omit a field to keep its current value, or pass null to show the App Store listing text instead. Limits: headline 120 characters, description 2000 characters, 1 to 6 features of 160 characters each. Needs the apps.manage team permission.
save-listing-improvement
ChatGPTSave generated listing improvements to the database. Call this after generating all improvements to persist them for the user to review and apply. When you started from improve-listing, pass the returned generation_id to finalize that prepared record instead of creating a new one.
score-listing-draft
ChatGPTPredict what a listing text change would do to one of the user's apps' App Store keyword ranks, before they publish it. Uses Ranksy's listing impact model, trained on 16,000 real listing edits: for every keyword the app ranks on, tracks, or targets, it estimates the rank 1 to 3 weeks after publishing compared with leaving the text alone. Pass up to 5 drafts to compare them. Each draft only needs the fields it changes (name, subtitle, introduction, details, features); missing fields stay as they are live. Optionally pass target_keywords to see each one's predicted rank. Each draft returns: value (higher is better; compare drafts by it), summary (keywords up, down, no clear change; lost_top10 = top-10 keywords that would drop out), warning "loses_rankings" when the draft drops keywords the app ranks on, moves (the biggest clear rank changes, "current_rank → predicted_rank"; null rank = not in the top 72), and targets. Each move carries pageviews and installs: the keyword's organic App Store search traffic over the last 30 days from the user's GA4 data (null when the app has no GA4 search data). at_risk sums that traffic over every keyword the draft drops; when a draft loses rankings, tell the user what traffic is at risk. Small effects are reported as no clear change on purpose. These are estimates, not promises.
search
ChatGPTSearch for apps or categories by name. Use this to find correct slugs before calling other tools.
set-ads-goal
ChatGPTSet the goal the Shopify App Store ads of one of YOUR apps are judged against: target_cpi (the most the app developer wants to pay per install, in dollars) and/or target_roas (return on ad spend, for members with revenue access only; without it the value is NOT saved and the result says so). Pass only the fields to change; pass null to clear one. Clearing target_cpi makes the optimizer fall back to the period's blended CPI. Changes the saved goal that the Optimizer page also uses, so ask the app developer for the number first (see get-ads-goal). Needs the apps.manage team permission, like editing the goal in the Ranksy app.
tasks-create
ChatGPTCreate a CRM follow-up task, optionally tied to a customer. Requires app_slug or team_app_ulid and a title. Identify the customer with installation_id or customer (store name or myshopify.com domain), or omit both for an app-level task. Optional: body, due_at (ISO 8601), priority (low|medium|high|highest), assignee_user_id or assignee_email (must be a team member; defaults to you), column or column_id (task board column; defaults to the first one). Returns the task.
tasks-list
ChatGPTList CRM follow-up tasks. With no arguments: all open tasks for the team across all apps, earliest due first; pass assignee=me for "what should I do today?". Narrow with app_slug/team_app_ulid, a customer (installation_id or customer, needs an app), status (open|done|all), and assignee (all|me|unassigned|<user id>). Each task has id (use with tasks-update), title, due_at, is_overdue, priority, assignee, customer, app and column (its task board column: id, name, is_done).
tasks-update
ChatGPTUpdate a CRM task by task_id (from tasks-list). Complete it with status "done", reopen with "open", dismiss with "cancelled", snooze/reschedule by passing a new due_at (ISO 8601). Move it on the team's task board with column (name) or column_id: the Done column completes it, any other column reopens it. Can also change title, body, priority (low|medium|high|highest) and assignee (assignee_user_id or assignee_email; must be a team member). Only the fields you pass change. Returns the task, including its board column.
update-goal
ChatGPTUpdate an existing goal by goal_ulid: change name, description or deadline, archive it (archived=true), and/or append new targets via add_targets (same shape as create-goal targets, including mode=rolling_avg with window_days 7/14/30, or window_days alone to infer rolling_avg). Only the fields you pass change. Returns the re-evaluated goal.