schema-markup

schema-markup SEO/AEO Diagnostic Assistant

Quick Start

More Skills

Overview

The SEO/AEO Diagnostic Assistant is used to answer "Can this be cited by AI?", SEO, GEO, and content growth questions, and is suitable for marketing, operations, product, and software to invoke after clarifying business goals, content materials, or analysis targets. It combines structured data page content, pasteable product pages, service pages, article pages, FAQs, organization introductions, event information, or entity facts as input, 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 "Can this be cited by AI?" and need to quickly break down goals, determine priorities, and form actionable results
• Marketing, operations, product, and software need to generate summaries, diagnostic conclusions, action recommendations, and reusable deliverables around the SEO/AEO Diagnostic Assistant
• Users have already prepared structured data goals (for example, aiming for rich result display, helping entity recognition, standardizing FAQs, strengthening understanding of product or service pages), target search audiences (explaining search users, buyers, readers, or entity audiences, and the key information they need to understand), public pages that need markup (fill in product pages, service pages, article pages, FAQ pages, or organization introduction links accessible without login), and hope to organize them into actionable analysis or optimization results
• Users need to turn SEO/AEO 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 Example

Basic Call

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

Call with Common Parameters

python3 scripts/run.py --params '{"goal":"结构化数据目标"}'

Parameter Description

Parameter	Type	Required	Default	Description
goal	string	No	-	For example, aiming for rich result display, helping entity recognition, standardizing FAQs, strengthening understanding of product or service pages
audience	string	No	-	Explain search users, buyers, readers, or entity audiences, and the key information they need to understand
materialUrl	string	No	-	Fill in product pages, service pages, article pages, FAQ pages, or organization introduction links accessible without login; a complete accessible URL must be provided
materialFile	string	No	-	Supports page documents, product tables, FAQ files, entity materials, content lists, or existing structured data drafts
materialText	string	No	-	Pasteable product pages, service pages, article pages, FAQs, organization introductions, event information, or entity facts
brandRequirements	string	No	-	Supplement brand name, legal entity name, address, contact information, pricing conventions, qualifications, and compliance boundaries

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

Parameter Value Reference

This skill currently has no categorical parameters that require additional lookup.

Supported Input Formats

This skill directly accepts JSON parameters; if a parameter contains a link field, please provide 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 around the user's goals that can be directly read, reviewed, or delivered.
• Interpretation of input materials: combine the structured data goals (for example, striving for rich result display, helping entity recognition, standardizing FAQs, and strengthening understanding of product or service pages.), the target search audience (explain the search users, buyers, readers, or entity audience, as well as the key information they need to understand.), and public pages that need markup (provide product pages, service pages, article pages, FAQ pages, or organization introduction links that can be accessed without logging in.) to extract key context and the basis for judgment.
• Next steps: provide priorities, execution suggestions, or a content framework that can be further developed.

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 are few input materials, 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