seo-audit

seo-audit 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. It is suitable for marketing, operations, product, and software to invoke after clarifying business goals, content materials, or analysis targets. It combines inputs such as website pages and SEO clues, pasteable page body text, title tags, navigation structure, keyword notes, search performance explanations, or existing... to organize 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 executable 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 audit goals (for example, increasing organic traffic, improving AI citations, fixing content structure, increasing inquiries, or identifying content gaps.), target search users (describe the search audience, buying roles, intent stages, or main usage scenarios.), and pages or site links to audit (fill in pages, sections, sitemaps, or public case links that can be accessed without logging in.), and want to organize them into executable analysis or optimization results
Users need to turn materials related to the SEO/AEO Diagnostic Assistant 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, increasing organic traffic, improving AI citations, fixing content structure, increasing inquiries, or identifying content gaps
`audience`	string	No	-	Describe the search audience, buying roles, intent stages, or main usage scenarios
`materialUrl`	string	No	-	Fill in pages, sections, sitemaps, or public case links that can be accessed without logging in; complete accessible URLs must be provided
`materialFile`	string	No	-	Supports web page exports, site inventories, keyword lists, content inventories, screenshot descriptions, or audit documents
`materialText`	string	No	-	Can paste page body text, title tags, navigation structure, keyword notes, search performance explanations, or existing audit findings
`brandRequirements`	string	No	-	Supplement brand tone, facts that must be retained, prohibited expressions, industry compliance restrictions, or internal guidelines

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

Parameter Value Reference

The current skill has no categorical parameters that require additional lookup.

Supported Input Formats

The current skill directly accepts JSON parameters; if the parameters contain link fields, provide complete, accessible URLs.

Example Request

The following example parameters 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 audit goals (for example, increasing organic traffic, improving AI citations, fixing content structure, increasing inquiries, or identifying content gaps.), target search users (explain the search audience, buying roles, intent stages, or main use scenarios.), pages or site links to be audited (fill in pages, sections, sitemaps, or public case 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 continue to be 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 given.
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