ai-schema-markup

ai-schema-markup Schema Markup Assistant

Overview

Schema Markup Assistant is used to answer “Is the structured data correct?”, SEO, content growth, and search optimization. It is suitable for marketing, operations, content creators, and software to invoke after clarifying business goals, content materials, or analysis targets. It combines inputs such as pages, keywords or content materials, pasted page content, keywords, site structure, search goals, competitor summaries, or optimization questions. It organizes key context and outputs Schema suggestions, FAQ structures, and launch checklists, making it easy to continue execution, review, or delivery. Capability positioning supplement: structured data needs can be combined with SEO/GEO audits to improve search explainability.

When to Use

Applicable Scenarios

When users ask questions like “Is the structured data correct?” and need to quickly break down goals, determine priorities, and form actionable results
When marketing, operations, content creators, and software need to generate Schema suggestions, FAQ structures, and launch checklists around Schema Markup Assistant
When users have already prepared optimization goals (specify the keywords, search intent, visibility, citation opportunities, or conversion goals to improve.), target audience (specify search users, target market, industry, purchase stage, or content audience.), page or site links (fill in publicly accessible pages, sites, SERPs, competitors, or reference links.), and want to organize them into actionable analysis or optimization results
When users need to turn Schema Markup Assistant-related materials into clear conclusions, priorities, and next steps

How to Invoke

Invoke 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	-	Specify the keywords, search intent, visibility, citation opportunities, or conversion goals to improve
`audience`	string	No	-	Specify search users, target market, industry, purchase stage, or content audience
`materialUrl`	string	No	-	Fill in publicly accessible pages, sites, SERPs, competitors, or reference links; a complete accessible URL must be provided
`materialFile`	string	No	-	Upload content drafts, keyword lists, site structures, audit reports, or SEO planning materials
`materialText`	string	No	-	Paste page content, keywords, site structure, search goals, competitor summaries, or optimization questions
`brandRequirements`	string	No	-	Supplement target regions, languages, brand restrictions, unchangeable facts, compliance requirements, or manual review priorities

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 tables.

Supported Input Formats

This skill directly accepts JSON parameters; if a parameter contains a link field, 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

Schema recommendations, FAQ structure, launch checklist: organize the core results around user goals that can be directly read, reviewed, or delivered.
Interpretation of input materials: combine the optimization goal (specify the keywords, search intent, visibility, citation opportunities, or conversion goals to improve.), target audience (specify the search users, target market, industry, purchase stage, or content audience.), and page or site links (fill in publicly accessible pages, sites, SERPs, competitors, or reference links.) to extract key context and the basis for judgment.
Next steps: provide priorities, execution recommendations, 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 “Schema Markup Assistant”.
Then check whether the results cover Schema recommendations, FAQ structure, and the launch checklist, and whether they provide clear next steps.
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