SuperAPI AI Directory

paid-ads

Marketing & growth

View repository

Updated 10-15 19:55

About this skill

paid-ads Business Diagnostic Assistant

Quick Start

More Skills

Overview

The Business Diagnostic Assistant is used to answer "how should this be done," conversion rates, growth marketing, and copywriting. It is suitable for marketing, operations, product, and sales to invoke after clarifying business goals, content materials, or analysis targets. It combines inputs such as ad delivery content, pasted ad headlines, primary copy, descriptions, keywords, audience hypotheses, budget context, landing page summaries, etc., organizes key context, and outputs summaries, diagnostic conclusions, action recommendations, and reusable deliverables for continued execution, review, or delivery.

When to Use

Applicable Scenarios

  • Users ask questions like "how should this be done," requiring rapid breakdown of goals, identification of priorities, and formation of actionable results
  • Marketing, operations, product, and sales need to generate summaries, diagnostic conclusions, action recommendations, and reusable deliverables around the Business Diagnostic Assistant
  • Users have already prepared delivery goals (e.g., clicks, lead generation, purchases, installs, appointments, retargeting, brand awareness, or event registration.), target audience and intent (supplement search intent, interests, industry, region, funnel stage, retargeting conditions, or excluded audiences.), and ad or landing page links (fill in publicly accessible ad previews, landing pages, product pages, event pages, or material description links.), and hope to organize them into actionable analysis or optimization results
  • Users need to turn Business Diagnostic Assistant-related materials into clear conclusions, priorities, and next steps

How to Invoke

Call the AI Skills API directly through the exported Python runner:

Command Examples

Basic Invocation

python3 scripts/run.py --params '{}'

Invocation with Common Parameters

python3 scripts/run.py --params '{"goal":"投放目标"}'

Parameter Description

Parameter Type Required Default Description
goal string No - For example, clicks, lead generation, purchases, installs, appointments, retargeting, brand awareness, or event registration
audience string No - Supplement search intent, interests, industry, region, funnel stage, retargeting conditions, or excluded audiences
materialUrl string No - Fill in publicly accessible ad previews, landing pages, product pages, event pages, or material description links; a complete accessible URL must be provided
reviewDepth string No 标准诊断 Choose quick checkup, standard diagnosis, or in-depth delivery brief; optional values:快速体检、标准诊断、深度改稿
materialFile string No - Supports docx, pdf, md, txt, and other ad materials, suitable for submitting delivery briefs, creative lists, keyword lists, or page drafts
materialText string No - Paste ad headlines, primary copy, descriptions, keywords, audience hypotheses, budget context, landing page summaries, or delivery briefs
targetPlatform string No - For example, Google Ads, Meta, TikTok, LinkedIn, Xiaohongshu, Bing, Amazon Ads, or programmatic advertising
brandRequirements string No - Supplement brand tone, prohibited words, claim requirements, industry restrictions, material specifications, and promises that cannot be exaggerated

See the complete machine-readable parameter structure at references/form-schema.json。

Parameter Value Reference

This skill has no categorized parameters that require additional lookup.

Supported Input Formats

This skill directly accepts JSON parameters; if the parameters contain a link field, please pass a complete, accessible URL.

Example Request

The example parameters below can be passed directly to scripts/run.py, and the runner will send them to the AI Skills API.

python3 scripts/run.py --params '{"goal":"投放目标"}'

Equivalent --params JSON:

{
  "goal": "投放目标"
}

Example Response Result

{
  "success": true,
  "data": {
    "message": "示例结果请以技能真实返回结构为准。"
  },
  "meta": {
    "executionTime": 842,
    "cached": false
  }
}

Deliverables

  • Summary, diagnostic conclusions, action recommendations, and reusable deliverables: organize the core results around the user's goals that can be directly read, reviewed, or delivered.
  • Interpretation of input materials: extract key context and judgment basis by combining campaign goals (e.g., clicks, lead generation, purchases, installs, appointments, remarketing, brand awareness, or event registration.), target audience and intent (supplement with search intent, interests, industry, region, funnel stage, remarketing conditions, or excluded audiences.), and ad or landing page links (provide publicly accessible ad previews, landing pages, product pages, event pages, or creative description links.).
  • Next steps: provide priorities, execution recommendations, or a content framework that can be further processed.

Result Usage Recommendations

  • First determine whether the output answers the user's core questions about the "Business Diagnostic Assistant".
  • Then check whether the results cover the summary, diagnostic conclusions, action recommendations, and reusable deliverables, and whether clear next steps are provided.
  • If there is little input material, it is recommended to have the user supplement the goals, audience, constraints, or original materials before running.

Preparation Before Running

  • AISKILLS_BASE_URL: default https://ai-skills.ai
  • AISKILLS_API_KEY: required, used for authenticated calls
  • AISKILLS_TENANT_ID: default default