中文EN
🚀 Product Announcement · AppGrowing Global

AppGrowing Officially Launches the MCP Service

Your Agent will be able to search and obtain rich global mobile ad creatives directly through MCP. MCP can be freely embedded into your existing Agent workflows to complement your existing Skills — used to build ad-strategy analytics agents that better meet your workflow and business needs.

📊 Tools Live21 🔥 Selling-Point Lexicon337,278 📄 Per Page100

IDifference between MCP and Skill

1. What is MCP?

MCP (Model Context Protocol) is a set of open protocols that allow AI applications to connect to external data and tools. Through MCP, AI agents can discover and invoke the tools and capabilities provided by AppGrowing Global.

After using MCP, users can directly call MCP in natural language to search and obtain rich global mobile advertising creatives in the daily use of AI Agent, without manually logging in to AppGrowing Global.

In shortMCP is a connector that can call many data and API interfaces at the same time. MCP is like an Agent's hand, helping the Agent to easily grasp the data outside.

2. What is a Skill

A Skill is usually a set of instructions, rules, and calling processes for AI agents to use tools. The AggClaw Skill, for example, tells the Agent:

  • Under what circumstances should AppGrowing Global be called
  • How to identify user intent for analysis
  • How to deal with new analysis and continuous questioning respectively
  • How to choose the analysis mode, language, and parameters
  • How to configure API Key
  • How to handle timeout, authentication failure, and creative download failure
In shortAggClaw Skill can be understood as a tutorial that guides the use of the Agent — guiding the Agent on how to better invoke AppGrowing's creative analysis capabilities and process creative data.

3. Relationship between MCP and Skill

To help you understand the agent/skill/mcp collaboration mode more vividly, I use the scenario of "Chef + Recipe" as an example:
MCP and Skill relationship
Fig. 1 MCP provides capabilities; Skill teaches AI how to use them

MCP = kitchen utensils and ingredients, providing various basic abilities.

Skill = recipe, which tells you what ingredients to use and in what order to make them.

For example:

MCP: egg, flour, milk, oven  ·  Skill: Cake Making Method

For AppGrowing:

MCP: Creative Data, launch data, competition data, market data  ·  Skill: Explosions Creative Analysis Method

In a word:

MCP provides "ingredients" and Skill provides "recipes for making a good dish".
MCP tells AI "what is there" and Skill tells AI "how to do it".
AppGrowing MCP tells AI "what data is there" and Skill tells AI "how to call data and use data for effective insight".
💡 MCP and Skill are not substitutes for each other and can be used in combination:
  1. MCP is responsible for connecting AppGrowing's capabilities to AI Agents.
  2. The Skill is responsible for helping the Agent understand the user's needs and choose the right Tool.
  3. MCP Tool performs search, filtering, analysis, or creative acquisition.
  4. The AI client organizes the results into a user-readable report and supports continued questioning.

For example, the user said "analyze the trend of creative for SLG games in the US market in the past 30 days":

  • MCP is responsible for enabling AI clients to call AppGrowing's creative analysis tools.
  • Skill is responsible for identifying what data is passed to MCP for conditions such as "US market, SLG, nearly 30 days, trend analysis", and teaching AI how to use the data for analysis.
  • The MCP Tool is responsible for searching the data and generating analysis results.
  • The AI Agent is responsible for displaying the report and saving the session context for subsequent questioning.

IIBasic Information of AppGrowing MCP

2.1 What tools does AppGrowing MCP have now?

AppGrowing MCP now exposes 21 tools, grouped into four modules: Creative & Selling Points (5), Charts & Product Intelligence (4), Brand Advertising Analysis (10), and Publisher & Developer Intelligence (2).

Creative and selling points remain the differentiator (🔥 a 330,000+ dynamically updated selling-point lexicon); the chart, delivery-analysis and publisher modules let your Agent trace the full path from "who is advertising, and how much" to "which creative, and why it works".
ToolEffectOne-line scenario
Module 1 · Creative & Selling Points (5) — the differentiating core of AppGrowing MCP
materialListCreative search (filtered by media/region/selling point/audience/cashing method, etc.)Nearly 30 days of role-playing creatives on TikTok
creativeMarketingWordList💡 Creative selling-point word trends (330,000+ lexicon, sorted by number of creatives / advertisements / popularity)What selling points is everyone playing in the role-playing category?
resourceMarketingWordCreative selling point of a single creativeExtract the selling points of a product's popular creatives in the past 7 days
filterListReturn all optional filter values (media/region/category/style/selling-point category)What is the media ID of TikTok?
downloadResourceUrlRefresh the download link of the creative's original video/cover. The link has a validity period.Get the original image/video of a creative
Module 2 · Charts & Product Intelligence (4) — decide "who to look at" first
promoteAppListApp promotion ranking (brand level; includes live ad count, creative count, audience profile, publisher and developer ids)Which games bought the most volume in the US over the last 7 days
appStoreDownloadListiOS App Store download chartWhich new puzzle titles are breaking into the Japan download chart
gpAppDownloadListGoogle Play download chartWho tops US Android downloads in the tools category
appRelatedAndSimilarListSimilar / related products (sortable by similarity or lifetime downloads)Find 10 direct benchmarks for this SLG
Module 3 · Brand Advertising Analysis (10) — who is advertising, how much, and where
mediaLaunchMedia mix overview: volume and share by media channelIs this product leaning on Meta or TikTok
regionLaunchRegional overview: volume and share by country / regionWhich markets does its budget concentrate in
mediaTimelineMedia timeline: how each channel's volume changes over timeWhen did it start scaling up on TikTok
regionTimelineRegional timeline: how each market's volume changes over timeHow the market focus shifts from launch to steady state
formatOverviewAd-format overview: playable / rewarded / in-feed and other formatsAre rivals already running playable ads at scale
creativeTypeOverviewCreative-type overview: image / video / vertical video distributionIs this category fighting with images or with video
materialRatioAspect-ratio overview: portrait / landscape and size distributionHow many size variants do we need to cover placements
advertTrendDaily volume trend curves for ads and creativesHow many creatives does the rival ship per week, at what cadence
appAgeRangeCntBrand audience by age × genderWhich age band and gender should creatives target
appCycleTimeProduct lifecycle / version / festival milestone timingHow its buying rhythm shifts around a major version
Module 4 · Publisher & Developer Intelligence (2) — roll products up to company level
appBrandStatusListAll products under a publisher (live ads, creatives, running days, version count, region count)How many products does this publisher run, and how hard
developerAppBrandProducts under a developerWhat other clone packages does the same developer run

2.2 🔥 The Most Unique Capability of AppGrowing MCP — Creative Selling-Point System

AppGrowing MCP not only provides creative search "Know What", but also the ability to understand creatives "Know Why". AGG has turned the "creative selling point" into an operational asset, which can be directly used for creative mining and creative strategy analysis, greatly reducing the time for dismantling creatives.
HierarchyToolCapabilityExample
① Picture elementsmaterialList.resourceElementInline return of screen element labels (with description)Realistic style, 3D, cartoon characters, science-fiction style, real person
② Selling-point screeningmaterialList.marketingWordFilter creatives by 🔥330,000+ creative selling-point wordsHigh-saturation effect color, easy decompression, overlooking lens, sense of achievement, fragmentary time
③ Selling-point trendcreativeMarketingWordListSelling-point word trend list (sorted by creatives / ads / popularity)Find the recent hottest selling-point words Top N of a category

Up to now, creativeMarketingWordList in AppGrowing MCP has returned 337,278 selling-point words.

Unlike a fixed tag system, AGG's creative selling points are automatically identified from massive creatives through AI algorithms — the selling-point lexicon updates dynamically and continuously generates new creative selling points.

Covering visual style (high-saturation effect color / warm-tone main tone), lens language (medium-scene close-up / overhead angle), audience motivation (casual players / sense of achievement / easy decompression), scene layout (beautiful life scene / vertical list layout), etc. — the granularity is extremely fine.

In the picture element creative.resourceElement[].description, each label carries a genuinely informative judgment-caliber description that tells you why the label is tagged this way. For example:

Tag NameDescription (judgment caliber)
Cartoon charactersJapanese-style anime or domestic anime-based character types, excluding anthropomorphic animals (such as Monkey King / Pig).
3DCharacters and objects have no black/thin line stroke, the light and shadow effect is obvious, and the overlapping part of the object has no stroke to count as 3D. Mixed types do not count.
Anime styleSources include Japanese-Korean style (Eastern) and European-American style (Western) animation. Pictures are divided into Q-version cute style and Japanese / European-American cartoon animation as representative animation images.
Realistic style3D modeling style, vivid picture (including extremely simulated people and objects) with powerful light and shadow effects, common in games such as Dynasty Warriors, NBA2K, FIFA, etc.
European and American styleEurope / North America / South America and other historical & modern unique elements, common in medieval armor, castles, western cowboys, American uncles, etc.
Real sceneReal-world scenes appear in the creative, such as offices, seaside, cars, etc.
Real personA real natural person or a highly realistic CG character.
Minimalist styleThe picture is simple, generally no more than three elements, and the elements are flat — common in Stickman games.
Pixel styleImage processing with pixel style, emphasizing clear outlines, bright colors, granular pixels composing a unique picture style.
AnimalsCattle, horses, sheep and other poultry / animals.

2.3 AppGrowing MCP Tool Details

The 21 tools below are organised into four modules. Each tool's parameter table shows only the first 5 parameters by default — click "Show remaining parameters" under a table to expand it; all parameters expand automatically when the page is exported to PDF.

Module 1 · Creative & Selling Points5 tools · the differentiating core — answers "which creative, and why it works"

2.3.1 materialList — Creative retrieval capability (core Tool)

ParameterTypeRequired (✅ required, — optional)Explain
purposeint✅Promotional Type: 1-Game / 2-Application / 3-Website
orderstr(enum)✅Sort (see table below): _score_desc / max_dt_desc / max_dt / min_dt_desc / min_dt / cnt_ad_id_desc / cnt_dt_desc / cnt_dt / impression_inc_2y_desc / similar_cnt_desc
startDate / endDatedate—Delivery Time Range (YYYY-MM-DD)
isAllDateint—Check all times (1-Yes / 0-No)
categoryint[]—Store category (ID taken from filterList)
resourceElementint[]—Creative tags / screen elements (games/apps only)
appStyleint[]—App style (games/apps only)
mediaint[]—Media (ID taken from filterList)
areastr[]—Delivery Region (country code array)
formatint[]—Ad form (ID taken from filterList)
platformint[]—Promotion platform (games/apps only)
languagestr[]—The language of the creative
videoTimeint—Video duration (ID taken from filterList)
minDuration / maxDurationstr (number)—Delivery days range
accurateSearchint—Exact match (1/0)
isNew / isNewAdint—New creatives / New Ads (1/0)
resolutionint—HD creative (1/0)
keywordstr—Search keyword
isCreativeint—Innovative creatives (1/0, only games/applications)
genderint[]—Gender (1-Male / 2-Female / 3-Unknown, Game/App only)
ageRangestr[]—Age: 13-17 / 18-24 / 25-34 / 35-44 / 45-54 / 55-64 / 65+
isW2a / excludeW2aint—W2A website promotion judgment
campaignTypeCombineint—Whether to filter promotion type (1 / not)
campaignTypeint[]—Promotion type: App Download (101,201,298,295) / W2Apk(299) / PWA & H5(297)
platformCampaignTypeint[]—Promotion platform: GooglePlay(201) / Galaxy(295) / RuStore(298) / APK(299) / AppStore(101)
appCashWaystr—Method of realization: iaa / iap / iaa_iap / subscribable
creativeRatiostr[]—Proportion of creative (e.g. horizontal and vertical screen)
blockIdsstr[]—Shielding creative id
blockAppIdsstr[]—Shielding generalization
isPreint—Appointment / pre-registration game (1/0, game only)
asrint—Is there a narration (1/0)
asrLanguagestr—Narration language
searchDslobj[]—Advanced Search: {key, type, value}, see below
isViolationint—Violation ads (1/0, games/apps only)
hasCooperateint—Partner Talent Advertising (1/0)
marketingWordstr—Creative selling words (games/apps only)
singleAreaint—Just look at a certain area (1/0)
postpageint—Whether the original post of advertisement (1/0)
hasPpidint—Is there a CPP custom product page (games/apps only)

order sort parameters

order parameterSort meaningApplicable scenarios
_score_descDescending by search relevance (only valid when keyword/searchDsl is passed)Keyword search ranked by matching degree
max_dt_descDescending by last delivery time (latest creative first)Look at the creatives that are still being cast recently
max_dtAscending by last delivery time (oldest first)—
min_dt_descDescending by first discovery time (the latest captured creative first)Look at the latest warehousing / emerging creatives
min_dtAscending by time of first discovery (first caught)—
cnt_ad_id_descDescending by number of related ads (most widely cast creative first)Looking for large-scale creatives
cnt_dt_descDescending by number of days of delivery (the creative with the longest delivery first)Looking for "evergreen" creatives / long-distance running type
cnt_dtAscending by Delivery Days—
impression_inc_2y_descDescending by ExposureFind head explosive creatives (e.g. Top10 / Top5)
similar_cnt_descDescending by number of approximate creativesFind "explosive master" creatives (the more approximate creatives, the more it is worth copying)

searchDsl object fields

  • key (enum): campaign_name (game / application / domain name) / appid / slogan (copy) / asr (narration) / brands_name (short play) / developer_name / website
  • type (enum): contain / exclude / equal / notEqual
  • value (str): retrieval content

2.3.2 creativeMarketingWordList — Creative selling-point capability (core Tool)

ParameterTypeRequiredExplain
purposeint✅1-Games / 2-Apps
categoryint[]—Store Category
appStyleint[]—Application style
areastr[]—Deployment Region
wordAttrstr[]—Selling-Point Classification
keywordstr—Keyword
orderstr(enum)—adverts_desc / material_cnt_desc / shot_cnt_desc / product_cnt_desc / ratio_desc
pageint—Page number

2.3.3 resourceMarketingWord — The creative selling point of a single creative

ParameterTypeRequiredExplain
idstr✅Resource ID (in materialList: creative.resource.id)
purposeint✅Promotional type (must be consistent with the materialList call)

2.3.4 filterList (no input parameters, only returns constant filter values)

ParameterTypeRequiredExplain
(None)——No input parameter, returns all constant filter values

2.3.5 downloadResourceUrl — Returns downloadable creative links

ParameterTypeRequiredExplain
keystr✅ (actual required)key = creative.resource.path returned by materialList, or the file name + suffix intercepted from that link
Module 2 · Charts & Product Intelligence4 tools · locate "who to look at" first and produce the brand / app ids every later module needs

2.3.6 promoteAppList — App promotion ranking (main entry for brand data)

Returns AppBrand-level rankings. One record already carries the brand id, its linked single-app ids, the publisher id, the developer id and the audience profile, so this is the id source for all tools in modules 3 and 4. Every page returns exactly 20 records.

ParameterTypeRequiredExplain
purposeint✅Promotional type: 1-Game / 2-Application
orderstr(enum)✅adverts_desc ads / duration_desc running days / material_cnt_desc creatives / _score_desc search relevance
pageint✅Page number (20 records per page)
startDatedate✅Start date (YYYY-MM-DD)
endDatedate✅End date (YYYY-MM-DD)
areastr[]—Delivery regions (country-code array)
mediaint[]—Media channels (ids from filterList)
categoryint[]—Store categories (ids from filterList)
appStyleint[]—Application styles (ids from filterList)
developerAreastr[]—Developer home regions (country codes)
isNewint—Newly promoted game / app (1/0); order=adverts_desc + isNew=1 gives the new-title chart
isPreint—Games with pre-registration (1/0, games only)
keywordstr—Keyword (matches app / brand names only)
accurateSearchint—Exact match (1/0)
appCashWaystr[]—Monetisation: iaa / iap / iaa_iap / subscribable
ageRangestr—Audience age band (games / apps only)
genderint[]—Audience gender: 1-male / 2-female / 3-unknown

2.3.7 appStoreDownloadList — App Store download chart

Returns single-platform App-level records (not brand-merged). The end date can be no later than yesterday; today is not queryable.

ParameterTypeRequiredExplain
purposeint✅Promotional type: 1-Game / 2-Application
orderstr(enum)✅download_cnt downloads / ad_cnt ads / material_cnt creatives / change_rate change rate
pageint✅Page number
startDatedate—Start date, defaults to the last 7 days
endDatedate—End date, defaults to yesterday
timeTypestr(enum)—daterange (last 7/15/30 days only) / month (current month unsupported)
areastr[]—Delivery regions (country codes)
category / appStyleint[]—Store category and application style (ids from filterList)
developerAreastr[]—Developer home regions
preAdditionalint—Pre-registration plus additional release (1/0)
keyword / accurateSearchstr / int—Keyword and whether to match exactly

2.3.8 gpAppDownloadList — Google Play download chart

Parameters are identical to appStoreDownloadList; only the source platform differs. Also queryable no later than yesterday.

ParameterTypeRequiredExplain
purposeint✅Promotional type: 1-Game / 2-Application
orderstr(enum)✅download_cnt / ad_cnt / material_cnt / change_rate
pageint✅Page number
startDate / endDatedate—Defaults to the last 7 days; end date no later than yesterday
timeTypestr(enum)—daterange / month
areastr[]—Delivery regions (country codes)
category / appStyleint[]—Store category, application style
developerAreastr[]—Developer home regions
preAdditionalint—Pre-registration plus additional release (1/0)
keyword / accurateSearchstr / int—Keyword and exact-match switch

2.3.9 appRelatedAndSimilarList — Similar / related products

Given one product or one brand, retrieves its similar competitors and related pool. appId and appBrandId cannot both be empty; passing appId queries the single-package view, otherwise the brand view.

ParameterTypeRequiredExplain
appBrandIdstr—Brand id (either this or appId)
appIdstr—Product id; presence switches to the single-package view
typeint—Promotional type, required whenever appId is passed
keystr[]—Which result sets: site / global / similar; all when omitted
sortstr(enum)—similar_desc / new_desc / old_desc / gp_download_desc / ios_download_desc
appCategoryint—Category filter: 0-all / 1-same / 2-different
limitint—Result cap when requesting similar
has_advertbool—Whether global / dual-platform packages also fetch ad data
Module 3 · Brand Advertising Analysis10 tools · who is advertising, how much, in which media, market and format

2.3.10 mediaLaunch — Media mix overview

ParameterTypeRequiredExplain
purposeint✅Promotional type: 1-Game / 2-Application
brandIdstr✅ (scope)App brand id
idsstr[]—Brand scope: all single-app ids linked to the brand
idstr—Single-app scope: the app id; brand scope: the brand id
typeint—Single-app scope only: that app's type; omit for brands
startDate / endDatedate—Defaults to the last 30 days
isAllDateint—Query all time (1/0)
dimensionstr(enum)—adverts deduped by ad id / material deduped by resource
area / media / format / creativeTypearrays—Region, media, ad format and creative type filters (ids from filterList)

2.3.11 regionLaunch — Regional overview

ParameterTypeRequiredExplain
purposeint✅Promotional type
brandIdstr✅ (scope)App brand id
typeint—Single-app scope: the app's type; omit for brands
startDate / endDatedate—Defaults to the last 30 days
isAllDateint—Query all time (1/0)
area / media / format / creativeTypearrays—Shared filters (ids from filterList)
dimensionstr(enum)—adverts / material

2.3.12 regionTimeline — Regional timeline

Same parameters as regionLaunch, returned as per-region volume over time.

ParameterTypeRequiredExplain
purposeint✅Promotional type
brandIdstr✅ (scope)App brand id
typeint—Single-app scope: the app's type
startDate / endDatedate—Defaults to the last 30 days
isAllDateint—Query all time (1/0)
area / media / format / creativeTypearrays—Shared filters
dimensionstr(enum)—adverts / material

2.3.13 mediaTimeline — Media timeline

Same family as mediaLaunch, but it does not accept id / ids; the brand vs single-app scope comes from brandId (+ type).

ParameterTypeRequiredExplain
purposeint✅Promotional type
brandIdstr✅ (scope)App brand id
typeint—Single-app scope: the app's type; omit for brands
startDate / endDatedate—Defaults to the last 30 days
isAllDateint—Query all time (1/0)
area / media / format / creativeTypearrays—Shared filters
dimensionstr(enum)—adverts / material

2.3.14 formatOverview — Ad-format overview

ParameterTypeRequiredExplain
purposeint✅Promotional type
brandIdstr✅ (scope)App brand id
typeint—Single-app scope: the app's type
startDate / endDatedate—Defaults to the last 30 days
isAllDateint—Query all time (1/0)
area / media / format / creativeTypearrays—Shared filters; format ids come from the format group in filterList
dimensionstr(enum)—adverts / material

2.3.15 creativeTypeOverview — Creative-type overview

ParameterTypeRequiredExplain
purposeint✅Promotional type
brandIdstr✅ (scope)App brand id
typeint—Single-app scope: the app's type
startDate / endDatedate—Defaults to the last 30 days
isAllDateint—Query all time (1/0)
area / media / format / creativeTypearrays—Shared filters; type ids come from the creativeType group in filterList
dimensionstr(enum)—adverts / material

2.3.16 materialRatio — Aspect-ratio overview

Returns ad count, creative count and share per aspect ratio — used to plan portrait / landscape coverage.

ParameterTypeRequiredExplain
brandIdstr✅ (scope)App brand id
typeint—Single-app scope: the app's type
startDate / endDatedate—Defaults to the last 30 days
isAllDateint—Query all time (1/0)
area / media / format / creativeTypearrays—Shared filters (ids from filterList)
dimensionstr(enum)—adverts / material

2.3.17 advertTrend — Ad / creative volume trend

Returns daily aggregated volume curves (ad-delivery volume / creative-delivery volume). brandId and id cannot both be empty.

ParameterTypeRequiredExplain
purposeint✅Promotional type
brandIdstr✅ (scope)App brand id
idstr—Brand scope: the brand id; single-app scope: the app id
idsstr[]—Brand scope: all single-app ids linked to the brand
typeint—Single-app scope: that app's type
startDate / endDatedate—Defaults to the last 30 days
isAllDateint—Query all time (1/0)
dimensionstr(enum)—adverts returns the ad curve / material the creative curve
area / media / format / creativeTypearrays—Shared filters

2.3.18 appAgeRangeCnt — Audience age × gender

Brand scope only — single apps are not supported. Both dates are mandatory and cannot be omitted.

ParameterTypeRequiredExplain
startDatedate✅Start date, defaults to the last 30 days
endDatedate✅End date, defaults to today
appBrandIdstr✅ (scope)App brand id, copied verbatim from promoteAppList

2.3.19 appCycleTime — Product lifecycle milestones

ParameterTypeRequiredExplain
propIdstr✅ (scope)App brand id
appCycleTypestr(enum)—product_lifecycle / app_version version milestones / festivals festival milestones
Module 4 · Publisher & Developer Intelligence2 tools · roll products up to company level for portfolio and clone-matrix checks

2.3.20 appBrandStatusList — Products under a publisher

Fetches live ad count, creative count, running days, version count and region count for every product of a publisher in one pass — suited to portfolio reviews. Pass the publisher id returned by promoteAppList.

ParameterTypeRequiredExplain
idstr✅Publisher id (the publisher.id on the brand record)
orderstr(enum)—adverts_desc / material_cnt_desc
pageint—Page number

2.3.21 developerAppBrand — Products under a developer

Pass the developer id returned by promoteAppList or the download charts, to map a developer's product matrix.

ParameterTypeRequiredExplain
idstr✅Developer id (the developer.id on the brand record)
pageint✅Page number
orderstr(enum)✅adverts_desc (currently the only option)

IIIConfiguration and Calling of AppGrowing MCP

3.1 How to configure AppGrowing MCP

Copy the following command and enter it directly in the Agent dialog box for the Agent to execute. Replace the API Key in the command with your own API Key — you can find it in "Personal Center → Enterprise Information". accept-language can be replaced with your language: zh for Chinese, en for English.

Install the MCP:
{
  "mcpServers": {
    "AppGrowing-Global-MCP": {
      "url": "https://api-appgrowing-global.youcloud.com/mcp",
      "headers": {
        "Authorization": "Bearer API Key",
        "accept-language": "zh"
      }
    }
  }
}

Wait for the installation to be completed and try to call the dialog. If a result is returned, the configuration is successful.

✨ Access demo — take Codex as an example
  1. Enter the command to send to Codex
  2. Test whether the MCP connection is normal. If a normal result is returned, the MCP service connection is successful.
Codex step 1
Step 1 Enter the command and send it to Codex
Codex step 1 continued
Step 1 · cont. Codex writes the MCP configuration
Codex step 2
Step 2 Test whether the MCP connection works normally

3.2 Calling MCP via Natural Language

After normal access, users do not need to provide parameters — directly use natural language to describe the target, scope and analysis focus. You can refer to the following typical call examples.

Ex.1Find recent popular creatives for an App/Game
💬 PromptRetrieve the top 10 ad creatives for Vita Mahjong based on impressions over the past 30 days and provide download links for them.

Call chain:

① materialList (purpose = 1, order = impression_inc_2y_desc, date window, searchDsl.campaign_name⊇'Vita Mahjong') ↓ Take the first 10 creatives in descending order of impressions, extract each creative.resource[0].path ② downloadResourceUrl × 10 (key = resource.path of the previous step) ↓ Exchange the latest download URL with aging signature one by one Output: Top10 creative table + download links
Example 1 result 1
Result Top10 creatives for Vita Mahjong
Example 1 result 2
Result Ranked table with download links
Ex.2Find the hot creative selling points of a category
💬 PromptLook up popular creative selling points for casual games from the past 30 days.

Call chain:

① filterList (no parameter) -> locate leisure id in category group ▼ ② creativeMarketingWordList (purpose = 1, category = [Leisure id], order = ratio_desc, page = 1) ▼ Return the list of creative selling words for casual games (descending by month-on-month popularity)
Example 2 result 1
Result Popular creative selling points for casual games
Example 2 result 2
Result Selling-point list (continued)
Example 2 result 3
Result Selling-point list (continued)
Ex.3Analyze the creative selling points of an App/Game's creatives
💬 PromptSearch for Vita Mahjong's recently trending ad creatives and extract the key selling points from each one.

Call chain:

① materialList (purpose=1, order=impression_inc_2y_desc, date window, searchDsl.campaign_name⊇'Vita Mahjong') ↓ Take Top5, extract each creative.resource[0].id (note: resource ID, not creative ID) ② resourceMarketingWord × 5 (id = creative.resource.id of the previous step, purpose=1) ↓ Exchange the selling-point tags of the creative one by one Output: Top5 creatives + respective creative selling points
Example 3 result 1
Result Top5 creatives with extracted selling points
Example 3 result 2
Result Selling-point details (continued)
Example 3 result 3
Result Selling-point details (continued)

IVBasic Use Cases

C1Explosive Creative Inspiration + Selling-Point Positioning

Demand: Find the rising creative direction in a certain category and lock in what selling points to play.

💬 Example PromptI am looking for high-impression video creatives for RPG categories in the US and Japanese markets from July to August 2026. First help me see what the mainstream selling words in this category are, then around the two selling points of 'character formation' and 'plot', pull the TOP 20 creatives by impressions, and output the creative ID, copywriting slogan and creative detail-page link of each one.
C2Benchmark / Competitor App Creative Inquiry

Requirement: Lock a competitor App and disassemble its recent creative play and launch intensity.

💬 Example PromptHelp me disassemble the competitor App (app name / package name XXX) buying creatives on all media in the last 90 days, and pull the TOP 30 video creatives sorted by delivery days. And parse the first 10 resource original films into downloadable links, convenient for me to review one by one.
C3Localized Remake Creative Case Extraction

Requirement: Collect referable original films in batches for the target market and remake them for the localization team.

💬 Example PromptI want to give the team a reference for the localization of the Japanese-market action App. Filter out the action creatives with narration placed on the Japanese market, and take TOP 15 by the number of similar creatives. Then parse all 15 picture/video resources into the latest download links and package them for me.
C4Creative Selling-Point Theme Scanning

Requirement: Scan the current mainstream selling-point themes of a category and the heat of their creatives to guide creative topics.

💬 Example PromptScan the most mainstream creative selling themes of strategy game Apps currently in Southeast Asia. First list the selling points of the category, then search the selling points one by one, count the creative volume under each selling point and the high-exposure representative creatives, and output the list of 'selling point → creative volume → TOP3 reference link'.
C5Differentiated Collection by Channel / Format

Demand: Compare the creative style differences of the same category across different channels / formats.

💬 Example PromptCompare the best-performing casual game creatives on TikTok and Meta in the North American market. Screen the casual game ads of the TikTok and Meta channels in North America respectively, and take the 15 videos with the highest impressions from each. And parse the download links of the creatives on both sides, easy to compare the creative styles of the two platforms.
C6New-Market Cold-Start Creative Benchmark

Demand: Before entering a new market, pull the benchmark creatives of the same category in that market for cold-start reference.

💬 Example PromptWe are going to enter the Brazilian market with a tool App. Take the TOP 20 benchmark creatives with the highest impressions in Brazil's tools category in the past 60 days and the recent creative selling points of Brazil's tools category as a cold-start reference, and parse the first 10 download links.

Remaining Cases

Case studyCommon problemSupporting Tool
Monetization approach benchmarkingIAA vs IAP game creative differences?materialList (supports IAA/IAP cashing-method filtering)
Audience positioning researchCreatives targeting 25-34 women?materialList (supports gender and age-range filtering)
Website / W2A promotion analysisHow to play Web-promotion creatives?materialList (supports searching creatives promoting websites)

VAdvanced Use Scenarios

S1Timed Report of Single-Product Creative Strategy Analysis

Business goal: Automatically produce a weekly creative strategy briefing for a certain product: take stock of the creatives being cast, identify the rising selling points, and give suggestions on the creative direction for next week. Suitable for scheduled tasks (e.g. 9:00 every Monday). filterList → creativeMarketingWordList → materialList (campaign_name advanced search + selling-point filtering).

User-Triggered Prompt Reference:

💬 Trigger PromptHelp me systematically diagnose the creative play of our XX game in the past month: which creatives should be added, which should be changed and which should be cut? Are there any signs of creative fatigue?
📄 SKILL Reference (agg-single-product-report) — click to collapse
---
name: agg-single-product-report
description: This skill is applicable to: when the overseas mobile advertisement creative data of **single product/App** obtained based on AGG-MCP (materialList, creativeMarketingWordList, filterList, downloadResourceUrl) is required, when the Single Product Creative Strategy Diagnostic Report is produced. It focuses on a specific product (its own App or a single competitor), diagnoses its creative engine activity, selling-point focus, TOP creatives, creative life cycle and recession signal, and gives "amplification / iteration / elimination" creative asset disposal suggestions. Trigger scene: single product creative review meeting, own product creative health diagnosis, single competitor deep dismantling; or the user asked "help me systematically diagnose our XX game's creative play in the past month, which creatives should be added, changed or cut" / "deeply dismantle competitor YY's creative strategy in Japan".
agent_created: true
---

# AGG Single Product Creative Strategy Report

## Overview
AGG-MCP × Skill × Automation **single-scenario** analysis skill. It takes a normalized creative data set for a given product, converted into a structured **single-product creative strategy diagnostic report** (new scenario "F · Single-Product Creative Strategy Report"). Unlike "agg-category-report" (category level, cross-product), this skill only focuses on **one product** and does an in-depth physical examination of creative assets. This skill is decoupled from the MCP fetching layer: it consumes the `CreativeRecord[]` that is pulled and normalized by the MCP/orchestration layer in advance (recommended to use `searchDsl.campaign_name` to lock a single product), and does not call any tools by itself.

## When to call
- Single product creative review / own product creative health diagnosis (manual or Automation).
- Do a deep disassembly of one competitor (rather than a side-by-side comparison across competitors, which uses "agg-competitor-compare").
- Users ask questions such as "systematically diagnose the creative playing methods of our XX game in the past month, which should be added, changed, and cut" and "deeply dismantle competitor YY's creative strategy in Japan".

**Don't** use it to fetch data. If the `CreativeRecord` dataset is not available, run AGG-MCP first (filterList + creativeMarketingWordList to lock dimensions → use `searchDsl.campaign_name` to lock a single product and pull materialList, preferably covering multiple time slices), then return to this skill.

## Core Workflow
1. **Load contract**: Read `references/data_contract.md`, confirm required fields (`app_name`, `selling_points`, `format`, `ratio`, `language`, `impression`, `similar_cnt`, `advertising_days`, `max_dt`; ≥20 items in the product window).
2. **Issue analysis prompt**: Copy `references/analysis_prompt.md` and replace `<DATASET_SUMMARY>` / `<PARAMS>` (product name, region, time window), execute it.
3. **Apply deterministic rules** (see below, strictly as such):
   - **Creative engine activity**: total amount, number of new window items, `new_ratio`, and median of advertising_days.
   - **Selling-point focus**: TOP1 selling-point percentage; ≥40% judged "focused", <20% judged "scattered".
   - **TOP creatives**: impression / similar_cnt each take TOP5, mark "benchmark creative".
   - **Creative life cycle**: advertising_days distribution → distinguish evergreen (long cast) vs short-lived creatives; recession signal = few recent new items and old creatives still dominant.
   - **Disposal recommendations in three categories**: amplify (high performance and still worth casting), iterate (mediocre performance but form/selling points can be optimized), eliminate (low performance, long cast or declined).
4. **Delivery by envelope**: Fixed envelope (conclusion → evidence → recommendation → boundary). Recommendations given in "amplify / iterate / eliminate" three columns, each corresponding to specific creatives or selling points.
5. **Processing gaps**: When the sample is insufficient or a dimension is missing, only omit the corresponding subsection and mark at the boundary; no estimation allowed.

## Input/Output Contract (Abstract)
- **Input**: the `CreativeRecord[]` of a single product (time slices recommended to view evolution). Optionally with the same-category baseline for deviation comparison.
- **Output**: fixed-envelope Markdown insight block. Numbers must be calculated from the data set; if not available, write "insufficient data".

## Boundary Statement (key — must inform stakeholders)
This analysis uses **creative-side proxy metrics** (creative magnitude, similarity, exposure proxy, delivery days). It **is not** real delivery magnitude / consumption data (the latter requires `advertTrend` / `regionLaunch`). Each deliverable must be marked with: *"This analysis is based on creative-side proxy metrics, not true delivery magnitude."*

Automated Task Prompt Reference:

⏰ Automation PromptOn the 1st of each month, call the agg-single-product-report skill: first use AGG-MCP filterList and creativeMarketingWordList to lock the dimensions, then use materialList with searchDsl.campaign_name to lock the target product (e.g. XX Game) and pull the creatives of the past 30 days (including this-month / last-month slices). Call the agg-single-product-report Skill to diagnose its creative engine activity (total / new-up ratio / median delivery days), selling-point focus (TOP1 ratio), TOP creatives (impression / similar_cnt each TOP5), creative life cycle and recession signal; output the product creative strategy diagnostic report HTML and push it to me.

Report Reference:📊 Doomsday Creative Strategy Weekly (open in new window)

🖼️ Embedded preview: Doomsday Creative Strategy Weekly (click to expand / collapse)
S2Regular Comparison of Competing Products' Launch Strategies

Business goal: Compare the delivery-strategy differences of two products in the same category (e.g. two SLGs): selling-point focus, media selection, regional focus, creative style — and give differentiated competitive suggestions.

Tool chain:materialList × 2 (lock the two products respectively by campaign_name) → horizontal comparison

User-Triggered Prompt Reference:

💬 Trigger PromptCompare this week's competitors XX and YY buying creatives in North America SLG: who is more radical? What selling points does each emphasize? What are the differences in channel and form?
📄 SKILL Reference (agg-competitor-compare) — click to collapse
---
name: agg-competitor-compare
description: This skill is applicable to: when you need to obtain the overseas mobile advertising creative data of multiple competing apps through AGG-MCP (materialList, creativeMarketingWordList, filterList, downloadResourceUrl), when making a horizontal comparison of competitive creative delivery strategies. After normalizing the competitors' creative records, it produces structured cross-competitor comparisons — creative magnitude, new-launch rhythm (new ratio), media/format/language ratios, TOP selling points — and classifies each competitor as "adding party / changing party / keeping party" by hard rules, giving actionable follow-up recommendations for our side. Trigger scenario: competitor-monitoring weekly push (Automation) before the UA weekly meeting; or the user proposes "compare competitors XX and YY's buying creative methods this week" / "who is more radical, what selling points each promotes, and what are the channel and form differences".
agent_created: true
---

# AGG Competitor Creative Strategy Comparison

## Overview
Analysis skill for **single scenarios** within the AGG-MCP × Skill × Automation framework. It takes the normalized multi-competitor creative data set and converts it into a **competitor creative strategy comparison** report ready for the weekly meeting (scenario "A · Competitor launch strategy comparison push"). This skill is decoupled from the MCP fetching layer: it consumes the `CreativeRecord[]` pulled and normalized by the MCP/orchestration layer in advance; it does not call any tools by itself.

## When to Call
- Scheduled competitor-monitoring weekly push (Automation), used to synchronize intelligence before UA / buying weekly meetings.
- Users ask to compare competitors' creative buying methods, e.g. "Compare competitors XX and YY's buying methods in North America SLG: who is more radical? What selling points does each emphasize? What are the channel and form differences?"
- Any task that requires a side-by-side comparison of creative gestures for ≥2 competitors, rather than a single-brand perspective.

**Do not** use it to retrieve data. If there is no `CreativeRecord` data set, run AGG-MCP first (filterList → use `searchDsl.campaign_name` to pull materialList for each competitor), then return to this skill.

## Core Workflow
1. **Load Contract**: Read `references/data_contract.md` and confirm the input matches the schema and this skill's required fields (`app_name`, `advertising_days`, `selling_points`, `media`, `format`, `language`, `similar_cnt`; at least 1 competitor ≥10 records).
2. **Issue the analysis prompt**: Copy `references/analysis_prompt.md`, replace `<DATASET_SUMMARY>` / `<PARAMS>` (competitor list, time window, target region), and execute it.
3. **Apply deterministic classification**: Compute `new_ratio = new-in-window count / total` per competitor; classify by hard rules — adding party `new_ratio ≥ 0.40` or highest absolute new count in the set; changing party `0.15 ≤ new_ratio < 0.40` with newer creatives; keeping party `new_ratio < 0.15`. Strictly follow this and do not invent categories.
4. **Delivery by envelope**: Wrap the output in the fixed envelope of `references/data_contract.md` (conclusion → evidence table → suggestion → boundary). Evidence table columns: "Competitor | Total | New ratio | Main media/format | TOP selling point | Classification". Give exactly 3 follow-up suggestions for our side.
5. **Processing gaps**: When a competitor's sample is below the lower limit, still output based on existing data and mark it in the boundary; no estimation allowed.

## Input/Output Contract (Summary)
- **Input**: `dict[app_name, CreativeRecord[]]` or flat `CreativeRecord[]` with `app_name`.
- **Output**: a fixed-envelope Markdown insight block. Numbers must be calculated from the data set; if unavailable, write "insufficient data".

## Boundary Statement (key — must be communicated to stakeholders)
This analysis uses creative-side proxy metrics (creative magnitude, new-launch rhythm, media/format/language ratios). It **is not** real delivery magnitude / consumption data (the latter requires `advertTrend` / `regionLaunch`, not in the current MVP). Each deliverable must be labeled: *"This analysis is based on creative-side proxy metrics and does not reflect actual ad-spend levels."*

Automation Task Prompt Reference:

⏰ Automation PromptAt 09:00 every Monday, call the agg-competitor-compare skill. For the competitor Apps (A/B/C) in the monitoring list, call AGG-MCP materialList respectively: use searchDsl to lock each App by campaign_name, time window of the past 7 days, sorted by delivery days (cnt_dt_desc), each pulling TOP 30 creatives. Then horizontally compare their creative magnitude, selling-point word distribution, media and form ratios, and new-launch rhythm; output the competitor launch-strategy weekly report (HTML + executable recommendations) and push notifications to users.

Report Reference:📊 Doomsday vs Whiteout Paid Strategy Comparison (open in new window)

🖼️ Embedded preview: Doomsday vs Whiteout Strategy Comparison (click to expand / collapse)
S3Regular Summary Analysis of Category Creative Selling Points

Business goal: Not focused on a single product, but summarizing the selling-point trend of an entire category (e.g. 4X SLG), answering "what selling points are popular in this category now" to provide a basis for new-product projects / creative direction.

Tool chain:filterList (take category) → creativeMarketingWordList (filter by category) → materialList (pull sample verification by Top selling points)

User-Triggered Prompt Reference:

💬 Trigger PromptHelp me look at the creative selling-point trend of strategy games last month: which selling points are rising and which are falling? What angle should I push next month?
📄 SKILL Reference (agg-sellingpoint-trend) — click to collapse
---
name: agg-sellingpoint-trend
description: This skill is applicable to: when you need to obtain a category of overseas mobile ad creative data across two time slices based on AGG-MCP (materialList, creativeMarketingWordList, filterList, downloadResourceUrl), when summarizing "selling-point trend changes". It calculates the month-on-month ranking of selling points, marks emerging / declining selling points by fixed thresholds, and outputs a priority list for next month's creative topics. Trigger scenario: monthly creative topic-selection meeting; or the user asked "help me look at the creative selling-point trend of cross-border e-commerce last month: which selling points are rising and which are falling? What angle should I push next month".
agent_created: true
---

# AGG Category Selling-Point Trend Summary

## Overview
Analysis skill for **single scenarios** within the AGG-MCP × Skill × Automation framework. It converts two time-sliced category data sets into a structured **selling-point trend summary** (scenario "C · Category creative selling-point trend summary"). This skill is decoupled from the MCP fetch layer: it consumes the normalized `CreativeRecord[]` pulled in advance by the MCP/orchestration layer and sliced in time; it does not invoke any tools itself.

## When to Call
- Scheduled monthly trend briefing (Automation), used before creative topic selection.
- Users ask for selling-point heat trends, such as "last month's cross-border e-commerce selling-point trends: which are rising and which are falling? What should we push next month".
- Any task that needs to compare the changes of a category's selling-point pattern across two cycles.

**Do not** use it to retrieve data. If there is no data set, first run creativeMarketingWordList (list all selling points) → materialList for this category this month and last month respectively, then return to this skill.

## Core Workflow
1. **Load the contract**: Read `references/data_contract.md`, confirm required fields (`selling_points` and `impression` must cover **two** slices; ≥2 slices with ≥20 items each).
2. **Generate the analysis prompt**: Copy `references/analysis_prompt.md`, replace `<DATASET_SUMMARY>` / `<PARAMS>` (category, two slice definitions), and execute it.
3. **Apply deterministic labels**: Compute month-on-month creative-volume and ranking changes per selling point. Emerging selling point = growth ≥50% and last month's base <20; declining selling point = decline ≥30%. Combine emerging selling points with high-base steady-growth selling points to rank P0/P1/P2 priorities. Strictly follow the thresholds.
4. **Delivery by envelope**: Fixed envelope (conclusion → evidence table → recommendation → boundary). Evidence table columns: "Selling point | Last-month volume | This-month volume | Month-on-month | Ranking change | Label".
5. **Processing gaps**: When a slice is below the lower limit, still output based on existing data and mark at the boundary; missing slices cannot be estimated.

## Input/Output Contract (Summary)
- **Input**: category selling-point data grouped by two time slices (this month / last month).
- **Output**: a fixed-envelope Markdown insight block. Numbers must be calculated from the data set; if unavailable, write "insufficient data".

## Boundary Statement (key — must be communicated to stakeholders)
This analysis uses **creative-side proxy metrics** (creative volume, exposure proxy). It is not real delivery-level data (the latter requires `advertTrend`). Each deliverable must be labeled: *"This analysis is based on creative-side proxy metrics and does not reflect actual ad-spend levels."*

Automation Task Prompt Reference:

⏰ Automation PromptOn the 1st of each month, call the agg-sellingpoint-trend skill. Call AGG-MCP creativeMarketingWordList to list all selling points of the target category, then use materialList to retrieve this-month and last-month data respectively for each selling point, and gather statistics on creative volume and exposure per selling point. Compute the change of selling-point popularity ranking, identify emerging and declining selling points, and output two HTML reports: the category selling-point trend monthly report and next month's creative topic-selection guide.
S4Region × Media Launch Strategy Periodic Analysis

Business goal: For a product or category, analyze "in which region, with which media, what creative" is most effective, to guide budget allocation.

Tool chain:materialList (area × media cross) → downloadResourceUrl (sample the original films)

User-Triggered Prompt Reference:

💬 Trigger PromptWe are going to enter the Latin American market — help me analyze the channel focus and creative-style differences of Brazil / Mexico same-category creatives on TikTok and Meta. Where should the budget be tilted?
📄 SKILL Reference (agg-region-media) — click to collapse
---
name: agg-region-media
description: This skill is applicable to: when you need to obtain the "region × media" creative data of overseas mobile advertising based on AGG-MCP (materialList, creativeMarketingWordList, filterList, downloadResourceUrl), when analyzing the region × media creative ecosystem. It maps the region × media creative landscape, marks channel concentration, describes cross-channel creative style differences, and outputs media budget priorities and risks. Trigger scenario: quarterly media budget planning or before entering a new market; or the user proposes "we are ready to enter Latin America — analyze the channel focus and creative style differences of Brazil / Mexico same-category creatives on TikTok and Meta, and which way the budget should be tilted".
agent_created: true
---

# AGG Region × Media Creative Ecosystem Analysis

## Overview
Analysis skill for **single scenarios** within the AGG-MCP × Skill × Automation framework. It takes (region, media) cross-grouped creative datasets and turns them into a structured **region × media creative ecosystem analysis** (scenario "D · Region and media delivery strategy analysis"). This skill is decoupled from the MCP fetching layer: it consumes the normalized `CreativeRecord[]` pulled and tagged by the MCP/orchestration layer in advance; it does not invoke any tools itself.

## When to Call
- Scheduled quarterly media budget review, or one-time analysis before entering a new market (Automation / manual).
- Users ask for region/media creative differences and budget inclination, such as "entering Latin America, analyzing Brazil/Mexico creative differences on TikTok and Meta — how should the budget be tilted".
- Any task that requires a region × media creative map rather than a single-channel perspective.

**Do not** use it to retrieve data. If there is no data set, run filterList (area codes / media IDs) → cross materialList by area × media, then return to this skill.

## Core Workflow
1. **Load the contract**: Read `references/data_contract.md`, confirm required fields (`region`, `media`, `format`, `selling_points`, `advertising_days`; ≥3 (region, media) units with ≥5 items each).
2. **Generate the analysis prompt**: Copy `references/analysis_prompt.md`, replace `<DATASET_SUMMARY>` / `<PARAMS>` (region set, media set, time window), and execute it.
3. **Apply deterministic rules**: For each (region, media) unit output creative volume / form share / TOP selling points; channel concentration — a media's share within a region ≥50% marked "highly concentrated", otherwise "scattered"; creative style differences — qualitative description based on each media's format/language/selling_points combination; budget priority + risk (e.g. a highly homogenized channel → recommend differentiation or cost reduction).
4. **Delivery by envelope**: Standard envelope (conclusion → evidence → recommendations → boundaries). Units with sample <5 marked "insufficient sample" at the boundary.
5. **Processing gaps**: For missing units only omit that unit and enumerate at the boundary; no imputation.

## Input/Output Contract (Summary)
- **Input**: `CreativeRecord[]` with `region` and `media` tags (can be crossed).
- **Output**: a fixed-envelope Markdown insight block. Numbers must be calculated from the data set; if unavailable, write "insufficient data".

## Boundary Statement (key — must be communicated to stakeholders)
This analysis uses **creative-side proxy metrics** (creative magnitude, form/media/language percentages). It is not real delivery-level / consumption or media cost data (the latter requires `advertTrend` / `regionLaunch` / media APIs). Each deliverable must be labeled: *"This analysis is based on creative-side proxy metrics and does not reflect actual ad-spend levels."*

Automation Task Prompt Reference:

⏰ Automation PromptAt the beginning of each quarter, call the agg-region-media skill. First use AGG-MCP filterList to confirm the target area codes and media ID list, then use materialList to cross-search by region × media combinations (past 90 days), gathering statistics on creative volume, main forms and TOP selling points of each combination. Draw a "region × media creative ecosystem map", point out channel concentration and creative style differences per region, output media budget priority recommendations, and push.
S5New Explosive Creative Automated Early Warning

Business goal: Scan the new creatives of specified categories every day, find potential explosions of "new + high exposure", and warn at the first moment. Suitable for scheduled tasks.

Tool chain:materialList (isNew=1 + recent N days + exposure descending) → downloadResourceUrl

User-Triggered Prompt Reference:

💬 Trigger PromptPlease help me keep an eye on whether RPG in the Japanese market has any explosive creatives or new selling-point plays that suddenly appeared in the past two days. If so, remind me immediately via DingTalk.
📄 SKILL Reference (agg-viral-alert) — click to collapse
---
name: agg-viral-alert
description: This skill is applicable to: when you need to obtain a new-creative set based on AGG-MCP (materialList, creativeMarketingWordList, filterList, downloadResourceUrl) and compare against a ≥7-day baseline, monitoring overseas mobile advertising "viral creative burst signals". It applies three hard threshold gates (similar-count above P95 / exposure surge / ≥3 independent Apps focusing on the same selling point within 48h), and only sends an alert when at least one gate is hit. Trigger scenario: daily / conditional viral-creative monitoring (Automation); or the user asked "help me keep an eye on Japan-market RPG these two days for suddenly emerging viral creatives or new selling-point plays — if any, remind me immediately".
agent_created: true
---

# AGG Viral Creative Monitoring & Early Warning

## Overview
Analysis skill for **single scenarios** within the AGG-MCP × Skill × Automation framework. It converts the "new-creative set + baseline" into a **viral-creative alert** decision (scenario "E · Latest viral creative monitoring alert"). This skill is decoupled from the MCP fetching layer: it consumes normalized `CreativeRecord[]` (new creatives + baseline) pulled in advance by the MCP/orchestration layer, and does not call any tools or download creatives itself.

## When to Call
- Scheduled daily / high-frequency conditional monitoring tasks (Automation). Silence shall be maintained when there is no signal.
- Users ask to keep an eye on sudden viral creatives or new selling-point plays, e.g. "keep an eye on whether Japan RPG has any sudden viral creatives in the past two days, remind me if there are".
- Any task where the correct output when there is no signal should be "no anomaly" rather than fabricated insight.

**Don't** use it to fetch data or download creatives. The MCP layer is responsible for fetching; after a hit the MCP layer resolves `downloadResourceUrl`. If there is no data set, run materialList (isNew=1, order=max_dt_desc, limited category/region) + 7-day baseline first, then return to this skill.

## Core Workflow
1. **Load Contract**: Read `references/data_contract.md`, confirm required fields (`creative_id`, `similar_cnt`, `impression`, `selling_points`, `media`, `max_dt`, `app_name`, `is_new`; baseline ≥7 days history; current window ≥1 item).
2. **Generate the analysis prompt**: Copy `references/analysis_prompt.md`, replace `<DATASET_SUMMARY>` / `<PARAMS>` (category, region, monitoring window), and execute it.
3. **Calculate the baseline first**: Take the P95 of `similar_cnt` and the median of `impression` per media over the past 7 days. If the baseline is <7 days → directly return "no anomaly (baseline under 7 days, no alert)" and stop.
4. **Apply three hard gates (alert on any hit)**: ① single `similar_cnt` > baseline P95; ② `impression` ≥ 3× the median of the same window and media (or day-on-day ≥200% if a time series exists); ③ the same `selling_points` delivered by ≥3 independent `app_name`s within 48h. **No relaxation allowed**.
5. **Delivery**: When hit — envelope with Headline = signal type; evidence table columns "Creative ID + detail-page link | Selling point | Main casting channel | Signal type"; recommended actions: follow-cast / avoid-pit / disassemble. When no gate is hit — return **only** "no anomaly", never fabricate signals.

## Input/Output Contract (Summary)
- **Input**: "new-creative `CreativeRecord[]`" + "≥7-day baseline" with consistent shapes.
- **Output**: either "no anomaly" (or the baseline-insufficient variant), or a fixed-envelope alert Markdown block.

## Boundary Statement (key — must be communicated to stakeholders)
This analysis uses creative-side proxy metrics (similar count, exposure proxy, selling-point co-delivery). It **is not** actual campaign volume data (the latter requires `advertTrend`). When an alert is triggered, it must be marked: *"This alert is based on creative-side proxy metrics, not real delivery levels."*

Automation Task Prompt Reference:

⏰ Automation PromptAt 08:00 every day, call the agg-viral-alert skill and call AGG-MCP materialList (isNew=1, order=max_dt_desc, limited to target category and region) to pull new creatives of the past 24 hours, compared against the baseline of the past 7 days. Identify viral signals: a sudden increase in similar-creative counts, a sudden exposure increase, or multiple competitors simultaneously following the same selling point. Only when a signal is hit, use downloadResourceUrl to parse the representative creative's original film and push an early-warning notification via DingTalk (including creative detail-page link, selling point, channel, signal type). No signal, no notification.

VIFAQ

Q1Why is AppGrowing MCP more suitable for creative strategy analysis?
The key lies in the three-tier selling-point word system, which is industry-unique:
  • ① Picture elements — with descriptions and value: know how a label is tagged
  • ② Selling-point screening — a 330,000+ dynamic lexicon; AI automatically creates new selling points and discovers emerging trends
  • ③ Selling-point trend — directly see a category's recent Top10 selling points sorted by heat, letting you know 'why it is hot', not just 'what exists'
We not only 'Know What' but also 'Know Why' — so AppGrowing MCP is more suitable for creative strategy analysis.
Q2How many pieces of data does AppGrowing MCP return at a time?
100 creatives per page, up to 100 pages.
Q3AppGrowing MCP now exposes 21 tools — why should I choose it?
Because we did not start by piling up numbers — we first made "creative analysis" thorough: the core creative and selling-point module already covers 90% of creative-analysis requirements, and only then did we extend outward with chart intelligence, brand delivery analysis and publisher intelligence, so that every tool solves a practical problem. One of them, creativeMarketingWordList (the selling-point trend list), is the only tool that can answer "why is this selling point popular recently". AppGrowing MCP therefore spans the full path from "who is advertising" to "why a creative works", while keeping depth that other sources cannot provide.
Q4After using AppGrowing MCP, do I still need to log in to AppGrowing?
Daily analysis can usually be done directly in the MCP-capable AI client. You may still need to log in to AppGrowing Global for first-time use, obtaining API Keys, viewing full platform reports, managing permissions, and handling account issues.
Q5Why is the MCP Server connected but AI still does not call AppGrowing?
Possible causes include:
  • AGG Tools were not successfully discovered by the client
  • The user request does not clearly express the intent to search or analyze creatives
  • The Agent's tool-call permission is disabled
  • Skill or system instructions are not loaded correctly
  • Tool descriptions have compatibility issues with the current Agent
You can check the Tool list first, then send a clear request such as "query SLG advertising creatives in the US market in the past 7 days" for testing. If it still fails, contact the business representative assigned to you.
Q6How to handle authentication failure?
Check whether the API Key is fully copied, activated or expired, whether the environment variable name is correct, whether the account plan has permissions, and whether the MCP Server uses the correct authentication method. If it still cannot be resolved, contact the business representative assigned to you.
Q7Does MCP support continuous questioning?
It is recommended to ask follow-up questions within the same conversation. If you switch to a new conversation, you need to restate your requirements.
Q8Is MCP's data source consistent with the AI strategy analysis on the AppGrowing Global platform?
MCP calls the same data source; MCP is only responsible for finding data. Specific analysis results depend on your Agent and the LLM's comprehension ability, as well as the quality of the Prompt and Skill. If you want the same analysis results as AppGrowing, pair it with the AggClaw Skill.
Q9Can AppGrowing MCP be used to automatically generate creatives?
The core capability of AppGrowing MCP is ad-creative search and creative selling-point refinement. It can provide the data basis for scripts, storyboards, creative briefs and delivery analysis reports. Whether pictures, videos or other content can be directly generated depends on the other models and automation tools connected.
AppGrowing Global · MCP User Guide  |  English Edition  |  Updated 2026-09-02