ai-seo-audit

ai-seo-audit SEO Audit Assistant

Overview

The SEO Audit Assistant is used to answer "Is the website's SEO healthy," performance diagnostics, website quality, and experience metrics. It is suitable for technical, product, marketing, and software users to call 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, organizes key context, and outputs SEO diagnostics, priority recommendations, and launch checklists for further execution, review, or delivery. Capability positioning supplement: a high-frequency skill in trending marketing, which can be transformed into a page and content SEO/GEO audit tool.

When to Use

Applicable Scenarios

When users ask questions like "Is the website's SEO healthy" and need to quickly break down goals, determine priorities, and form actionable results
When technical, product, marketing, and software users need to generate SEO diagnostics, priority recommendations, and launch checklists around the SEO Audit Assistant
When users have already prepared optimization goals (explaining the keywords, search intent, visibility, citation opportunities, or conversion goals to improve), target audience (explaining search users, target market, industry, purchase stage, or content audience), page or site links (filling in publicly accessible pages, sites, SERPs, competitors, or reference links), and want to organize them into executable analysis or optimization results
When users need to turn SEO Audit Assistant-related materials into clear conclusions, priorities, and next steps

How to Call

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	-	Explain the keywords, search intent, visibility, citation opportunities, or conversion goals to improve
`audience`	string	No	-	Explain the 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 focus points

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 currently accepts JSON parameters directly; if the parameters include a link field, please provide a complete, accessible URL.

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":"优化目标"}'

Equivalent --params JSON：

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

Example return result

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

Deliverables

SEO diagnosis, priority recommendations, launch checklist: organize the core results around the user's goals that can be directly read, reviewed, or delivered.
Interpretation of input materials: combine the optimization goals (explain the keywords, search intent, visibility, citation opportunities, or conversion goals to be improved.), target audience (explain the 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.) to extract key context and the basis for judgment.
Next steps: provide priorities, execution suggestions, or a content framework that can be further processed.

Suggestions for using the results

First determine whether the output answers the user's core questions about the "SEO Audit Assistant".
Then check whether the results cover SEO diagnosis, priority recommendations, and the launch checklist, and whether clear next steps are given.
If the input materials are limited, 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