Overview
The SEO/AEO Diagnostic Assistant is used to answer "Can this be cited by AI?", SEO, AEO, and article optimization questions, and is suitable for content creators, operations, marketing, and technical users to invoke after clarifying business goals, content materials, or analysis targets. It will combine SEO/AEO article drafts, pasteable article text to be reviewed, title options, or search optimization drafts; it is recommended to retain inputs such as H1/H2, ... to organize key context, and output summaries, diagnostic conclusions, action recommendations, and reusable deliverables for continued execution, review, or delivery.
When to Use
Applicable Scenarios
- The user asks questions such as "Can this be cited by AI?" and needs to quickly break down goals, determine priorities, and form actionable results
- Content creators, operations, marketing, and technical users need to generate summaries, diagnostic conclusions, action recommendations, and reusable deliverables around the SEO/AEO Diagnostic Assistant
- The user has already prepared conversion goals (for example, improving keyword coverage, search rankings, AI summary citations, lead conversion, or content authority.), target audience (explaining the search user profile and intent stage, for example, beginner learning, solution comparison, purchasing decisions, or expert review.), public article link (providing an article page, blog page, or search landing page link that can be accessed without logging in.), and hopes to organize it into actionable analysis or optimization results
- The user needs to turn materials related to the SEO/AEO Diagnostic Assistant into clear conclusions, priorities, and next-step actions
How to Invoke
Call the AI Skills API directly through the exported Python runner:
Command Example
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, improving keyword coverage, search rankings, AI summary citations, lead conversion, or content authority |
audience |
string | No | - | Explain the search user profile and intent stage, for example, beginner learning, solution comparison, purchasing decisions, or expert review |
materialUrl |
string | No | - | Provide an article page, blog page, or search landing page link that can be accessed without logging in; a complete accessible URL must be passed |
reviewDepth |
string | No | 标准诊断 |
Diagnostic depth; optional values:快速体检、标准诊断、深度改稿 |
materialFile |
string | No | - | Supports article manuscripts such as docx, pdf, md, txt, suitable for submitting Markdown, Word, or reviewed version files |
materialText |
string | No | - | Pasteable article text to be reviewed, title options, or search optimization drafts; it is recommended to retain H1/H2, keywords, and internal link markers |
searchIntent |
string | No | - | For example, understanding concepts, comparing solutions, purchase decisions, tutorial operations |
targetKeyword |
string | No | - | Core keywords or query statements intended to be covered |
targetPlatform |
string | No | SEO/AEO |
Target platform; optional values:SEO/AEO、官网博客、知识库 |
brandRequirements |
string | No | - | Supplement brand tone, facts that must be preserved, internal linking requirements, compliance boundaries, or prohibited expressions |
See the complete machine-readable parameter structure at references/form-schema.json。
Parameter Value Reference
This skill currently has no categorical parameters that require an additional lookup table.
Supported Input Formats
This skill directly accepts JSON parameters; if the parameters include 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 Return Result
{
"success": true,
"data": {
"message": "示例结果请以技能真实返回结构为准。"
},
"meta": {
"executionTime": 842,
"cached": false
}
}
Deliverables
- Summary, diagnostic conclusions, action recommendations, and reusable deliverables: organize the core results that can be directly read, reviewed, or delivered around the user's goals.
- Interpretation of input materials: combined with the conversion goal (for example, improving keyword coverage, search ranking, AI summary citations, lead conversion, or content authority.), target audience (describe the search user profile and intent stage, for example, beginner learning, solution comparison, procurement decision, or expert review.), public article link (fill in an article page, blog page, or search landing page link that can be accessed without logging in.) to extract key context and the basis for judgment.
- Next steps: provide priorities, execution recommendations, or a content framework that can be further processed.
Suggestions for Using the Results
- First determine whether the output answers the user's core question about the "SEO/AEO 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 source materials before running.
Preparation Before Running
AISKILLS_BASE_URL: defaulthttps://ai-skills.aiAISKILLS_API_KEY: required, used for authenticated callsAISKILLS_TENANT_ID: defaultdefault