ai-seo

ai-seo SEO/AEO Diagnostic Assistant

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 call after clarifying business goals, content materials, or analysis targets. It combines inputs such as AI search optimization content, pasteable page body text, product descriptions, FAQs, knowledge base entries, entity introductions, or content that needs improvement..., organizes key context, and outputs summaries, diagnostic conclusions, action recommendations, and reusable deliverables for continued execution, review, or delivery.

When to Use

Applicable Scenarios

When users raise questions such as "Can this be cited by AI?" and need to quickly break down goals, determine priorities, and form actionable results
When marketing, operations, product, and software need to generate summaries, diagnostic conclusions, action recommendations, and reusable deliverables around the SEO/AEO Diagnostic Assistant
When users have already prepared GEO optimization goals (for example, improving AI summary citability, strengthening entity recognition, improving FAQ coverage, or increasing lead conversion.), target questioners (explaining the questions, roles, intent stages, or decision scenarios users will pose to AI search.), and AI search target pages (filling in pages, articles, documents, or reference links accessible without login.), and want to organize them into actionable analysis or optimization results
When users need to turn SEO/AEO Diagnostic Assistant-related materials into clear conclusions, priorities, and next actions

How to Invoke

Directly call the AI Skills API through the exported Python runner:

Command Examples

Basic Call

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

Call with Common Parameters

python3 scripts/run.py --params '{"goal":"GEO 优化目标"}'

Parameter Description

Parameter	Type	Required	Default	Description
`goal`	string	No	-	For example, improving AI summary citability, strengthening entity recognition, improving FAQ coverage, or increasing lead conversion
`audience`	string	No	-	Explain the questions, roles, intent stages, or decision scenarios users will pose to AI search
`materialUrl`	string	No	-	Fill in pages, articles, documents, or reference links accessible without login; a complete accessible URL must be provided
`materialFile`	string	No	-	Supports article drafts, page documents, knowledge base files, product materials, or FAQ tables
`materialText`	string	No	-	Can paste page body text, product descriptions, FAQs, knowledge base entries, entity introductions, or content that needs to improve AI summary quality
`brandRequirements`	string	No	-	Supplement brand naming, factual boundaries, descriptions that must be retained, prohibited expressions, and compliance restrictions

For the complete machine-readable parameter structure, see references/form-schema.json。

Parameter Value Reference

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

Supported Input Formats

This skill currently directly accepts JSON parameters; if the parameters contain link fields, please provide complete, accessible URLs.

Example Request

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

python3 scripts/run.py --params '{"goal":"GEO 优化目标"}'

Equivalent --params JSON：

{
  "goal": "GEO 优化目标"
}

Example return result

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

Deliverables

Summary, diagnostic conclusions, action recommendations, and reusable deliverables: core results organized around the user's goals that can be directly read, reviewed, or delivered.
Interpretation of input materials: combine the GEO optimization goals (e.g., improving the citability of AI summaries, strengthening entity recognition, improving FAQ coverage, or increasing lead conversion.), target questioners (explain the questions users will ask AI search, their roles, intent stages, or decision scenarios.), AI search target pages (fill in pages, articles, documents, or reference 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 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