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. Once MCP is connected, users command the AI Agent in natural language to call MCP tools and capabilities to search and obtain AppGrowing's rich global mobile ad creatives and delivery data.
2. Relationship between MCP and Skill
A Skill is usually a set of instructions, rules, and calling processes for AI agents to use tools — it often also includes the flow that guides the AI to call MCP.
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:
AppGrowing MCP tells AI "what data is there" and Skill tells AI "how to call data and use data for effective insight".
- MCP is responsible for connecting AppGrowing's capabilities to AI Agents.
- The Skill is responsible for helping the Agent understand the user's needs and choose the right Tool.
- The MCP Tool is responsible for searching data and returning it.
- The AI Agent analyzes the returned data, integrates the output, and keeps the session context for follow-up questions.
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 the AI Agent 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 returning it.
- The AI Agent analyzes the returned data and integrates the output, saving the session context for subsequent follow-up questions.
IIBasic Information of AppGrowing MCP
2.1 What tools does AppGrowing MCP have now?
MCP now exposes 21 tools, grouped by purpose into four modules: Creative Retrieval & Selling Points (5, see table below), Charts Intelligence (3), App Advertising Analysis (11) and Publisher & Developer Intelligence (2), plus Basic Tools (1). Creative retrieval & selling points is our core and differentiating capability (🔥 a 300,000+ dynamic creative selling-point lexicon); the charts, ad-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".
| Tool | Effect | One-line scenario | Credit cost |
|---|---|---|---|
| Creative Retrieval & Selling Points (5) — the differentiating core of AppGrowing MCP | |||
| searchAdCreatives | Creative search (filtered by media/region/selling point/audience/cashing method, etc.) | Nearly 30 days of role-playing creatives on TikTok | 10,000/call |
| creativeSellingPointTrends | 💡 Creative selling-point trends (300,000+ lexicon, sorted by number of creatives / advertisements / popularity) | What selling points is everyone playing in the role-playing category? | 10,000/call |
| creativeAIAnalysisData | Pull a creative's narration / selling points / AI interpretation (up to 100 per call) | Extract the selling points and narration of a product's popular creatives in the past 7 days | 50,000/call |
| creativeResourceUrl | Get the download link of the creative's original video/cover. The link has a validity period. | Get the original image/video of a creative | 10,000/call |
| Charts Intelligence (3) — decide "who to look at" first | |||
| appAdRankings | App 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 | 10,000/call |
| appStoreDownloadRankings | iOS App Store download chart | Which new puzzle titles are breaking into the Japan download chart | 10,000/call |
| googlePlayDownloadRankings | Google Play download chart | Who tops US Android downloads in the tools category | 10,000/call |
| App Advertising Analysis (11) — who is advertising, how much, where and with what | |||
| adVolumeTrends | Daily volume trend data for ads and creatives | How many creatives does the rival ship per week, at what cadence | 10,000/call |
| regionOverview | Regional overview: volume and share by country / region | Which markets does its budget concentrate in | 10,000/call |
| regionTimeline | Regional timeline: how each market's volume changes over time | How the market focus shifts from launch to steady state | 10,000/call |
| mediaOverview | Media mix overview: volume and share by media channel | Is this product leaning on Meta or TikTok | 10,000/call |
| mediaTimeline | Media timeline: how each channel's volume changes over time | When did it start scaling up on TikTok | 10,000/call |
| adFormatOverview | Ad-format overview: playable / rewarded / in-feed and other formats | Are rivals already running playable ads at scale | 10,000/call |
| creativeTypeOverview | Creative-type overview: image / video / vertical video distribution | Is this app fighting with images or with video | 10,000/call |
| creativeFormatRatio | Aspect-ratio overview: portrait / landscape and size distribution | Does this app prefer landscape or portrait ads | 10,000/call |
| audienceBreakdown | Audience by age × gender | Which age band and gender should creatives target | 10,000/call |
| appLifecycle | Product lifecycle / version / festival milestone timing | How its buying rhythm shifts around a major version | 10,000/call |
| similarApps | Similar / related products (sortable by similarity or lifetime downloads) | Find 10 direct benchmarks for this SLG | 10,000/call |
| Publisher & Developer Intelligence (2) — roll products up to company level | |||
| developerAppOverview | Products under a developer | How many same-category apps does the same developer run | 10,000/call |
| publisherAppOverview | All products under a publisher (live ads, creatives, running days, version count, region count) | How many products does this publisher run, and how hard | 10,000/call |
| Basic Tools (1) | |||
| filterOptions | Return all optional filter values (media/region/category/style/selling-point category) | What is the media ID of TikTok? | 10,000/call |
2.2 🔥 The Most Unique Capability of AppGrowing MCP — Creative Selling-Point System
| Hierarchy | Tool | Capability | Example |
|---|---|---|---|
| ① Picture elements | searchAdCreatives.resourceElement | Inline return of screen element labels (with description) | Realistic style, 3D, cartoon characters, science-fiction style, real person |
| ② Selling-point screening | searchAdCreatives.marketingWord | Filter creatives by 🔥300,000+ creative selling-point words | High-saturation effect color, easy decompression, overlooking lens, sense of achievement, fragmentary time |
| ③ Selling-point trend | creativeSellingPointTrends | Selling-point word trend list (sorted by creatives / ads / popularity) | Find the recent hottest selling-point words Top N of a category |
Up to now, the selling-point lexicon returned by creativeSellingPointTrends in AppGrowing MCP has exceeded 300,000+ — and unlike a fixed tag system, AppGrowing's creative selling points are automatically identified from massive creatives through AI algorithms: the 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 Name | Description (judgment caliber) |
|---|---|
| Cartoon characters | Japanese-style anime or domestic anime-based character types, excluding anthropomorphic animals (such as Monkey King / Pig). |
| 3D | Characters 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 style | Sources 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 style | 3D 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 style | Europe / North America / South America and other historical & modern unique elements, common in medieval armor, castles, western cowboys, American uncles, etc. |
| Real scene | Real-world scenes appear in the creative, such as offices, seaside, cars, etc. |
| Real person | A real natural person or a highly realistic CG character. |
| Minimalist style | The picture is simple, generally no more than three elements, and the elements are flat — common in Stickman games. |
| Pixel style | Image processing with pixel style, emphasizing clear outlines, bright colors, granular pixels composing a unique picture style. |
| Animals | Cattle, horses, sheep and other poultry / animals. |
2.3 Tool Parameter Details
The complete parameter details, sort enums and call examples of all 21 tools are consolidated into an interactive Tool Index page — an embedded preview is available below (use its EN button for English).
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 🔑 Get 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.
- Enter the command and send it to Codex
- Codex writes the MCP configuration into its config file
- Test whether the MCP connection is normal. If a normal result is returned, the MCP service connection is successful.
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.
When calling MCP in natural language, it is recommended to explicitly state how many creatives to search in the prompt, to minimize MCP cost and prevent the Agent from over-calling creative-search tools and burning too many credits.
The MCP tool layer truncates data returned into the Agent context, so large creative batches may not be returned in full. If you need to pull a large volume of creatives, use a script to call the MCP endpoint directly and save the response as JSON files in the workspace instead of letting the data flow back into the Agent context; the Agent reads the JSON files when needed. A script example is provided in FAQ-Q2.
Call chain:
Call chain:
Call chain:
IVAppGrowing MCP Basic Use Cases
Demand: Find the rising creative direction in a certain category and lock in what selling points to play.
Requirement: Lock a competitor App and disassemble its recent creative play and launch intensity.
Requirement: Collect referable original films in batches for the target market and remake them for the localization team.
Requirement: Scan the current mainstream selling-point themes of a category and the heat of their creatives to guide creative topics.
Demand: Compare the creative style differences of the same category across different channels / formats.
Demand: Before entering a new market, pull the benchmark creatives of the same category in that market for cold-start reference.
Remaining Cases
| Case study | Common problem | Supporting Tool |
|---|---|---|
| Monetization approach benchmarking | IAA vs IAP game creative differences? | searchAdCreatives (supports IAA/IAP cashing-method filtering) |
| Audience positioning research | Creatives targeting 25-34 women? | searchAdCreatives (supports gender and age-range filtering) |
| Website / W2A promotion analysis | How to play Web-promotion creatives? | searchAdCreatives (supports searching creatives promoting websites) |
VAdvanced Use Scenarios
How well AppGrowing MCP works inside your workflow depends on 3 factors:
- The capability of the Agent
- The smartness of the underlying LLM
- The quality of your Prompt and Skill
Most people stumble on Prompt and Skill — a good Prompt and Skill decide the quality of the task. As said earlier: to cook a great dish (a deep advertising insight), besides ingredients and utensils (MCP), what really matters is the recipe that teaches you to cook (Skill).
Besides recommending the 📘 AggClaw Skill, we also encourage you to weave MCP into your own business scenarios and workflows, write your dedicated Skills, and turn MCP data into unique insights and automated efficiency gains.
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). filterOptions & creativeAIAnalysisData to lock dimensions → searchAdCreatives (campaign_name advanced search + selling-point filtering).
User-Triggered Prompt Reference:
📄 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 (searchAdCreatives, creativeAIAnalysisData, filterOptions, creativeResourceUrl) 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 (filterOptions + creativeAIAnalysisData to lock dimensions → use `searchDsl.campaign_name` to lock a single product and pull searchAdCreatives, 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 `adVolumeTrends` / `regionOverview`). Each deliverable must be marked with: *"This analysis is based on creative-side proxy metrics, not true delivery magnitude."*
Automated Task Prompt Reference:
Report Reference:📊 Doomsday Creative Strategy Weekly (open in new window)
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:searchAdCreatives × 2 (lock the two products respectively by campaign_name) → horizontal comparison
User-Triggered Prompt Reference:
📄 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 (searchAdCreatives, creativeSellingPointTrends, filterOptions, creativeResourceUrl), 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 (filterOptions → use `searchDsl.campaign_name` to pull searchAdCreatives 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 `adVolumeTrends` / `regionOverview`, 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:
Report Reference:📊 Doomsday vs Whiteout Paid Strategy Comparison (open in new window)
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:filterOptions (take category) → creativeSellingPointTrends (filter by category) → searchAdCreatives (pull sample verification by Top selling points)
User-Triggered Prompt Reference:
📄 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 (searchAdCreatives, creativeSellingPointTrends, filterOptions, creativeResourceUrl), 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 creativeSellingPointTrends (list all selling points) → searchAdCreatives 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 `adVolumeTrends`). 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:
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:searchAdCreatives (area × media cross) → creativeResourceUrl (sample the original films)
User-Triggered Prompt Reference:
📄 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 (searchAdCreatives, creativeSellingPointTrends, filterOptions, creativeResourceUrl), 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 filterOptions (area codes / media IDs) → cross searchAdCreatives 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 `adVolumeTrends` / `regionOverview` / 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:
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:searchAdCreatives (isNew=1 + recent N days + exposure descending) → creativeResourceUrl
User-Triggered Prompt Reference:
📄 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 (searchAdCreatives, creativeSellingPointTrends, filterOptions, creativeResourceUrl) 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 `creativeResourceUrl`. If there is no data set, run searchAdCreatives (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 `adVolumeTrends`). 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:
VIFAQ
- ① Picture elements — with descriptions and value: know how a label is tagged
- ② Selling-point screening — a 300,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'
🐍 Python call-script example — click to collapse
import json, ssl, urllib.request
API_KEY = '<your key>'
URL = 'https://api-appgrowing-global.youcloud.com/mcp'
def mcp_call(name, args, timeout=90, retries=3):
payload = json.dumps({'jsonrpc':'2.0','id':1,'method':'tools/call',
'params':{'name':name,'arguments':args}}).encode()
req = urllib.request.Request(URL, data=payload, method='POST', headers={
'Content-Type':'application/json',
'Accept':'application/json, text/event-stream',
'accept-language':'zh',
'Authorization': f'Bearer {API_KEY}'})
ctx = ssl.create_default_context()
with urllib.request.urlopen(req, timeout=timeout, context=ctx) as resp:
raw = resp.read().decode('utf-8')
# SSE response: take the lines prefixed with "data: "
for line in raw.splitlines():
if line.startswith('data: '):
return json.loads(line[6:])
return json.loads(raw)
def parse(resp):
return json.loads(resp.get('result',{}).get('content',[{}])[0].get('text','{}'))
# Example: search high-impression card-game creatives in the Japan market
inner = parse(mcp_call('searchAdCreatives', {
'purpose': 1,
'order': 'impression_inc_2y_desc',
'startDate': '2026-07-10', 'endDate': '2026-08-10',
'page': 1,
'category': [2009],
'area': ['JP'],
}))
ml = inner['data']['materialList']
print(f'total={ml["total"]}')
for item in ml['data'][:5]:
m = item['material']
game = (m['campaign'][0]['name'] if m.get('campaign') else '?')
print(f' {game} | {m.get("impression_inc_2y")} | {(m.get("creative") or {}).get("slogan","")[:40]}')creativeSellingPointTrends (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.- MCP 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