ai-seo-2

ai-seo-2 SEO Diagnostic Assistant

Quick Start

More Skills

Overview

The SEO Diagnostic Assistant is used to answer "Where is the website's SEO weak?", SEO, content growth, and search optimization. It is suitable for marketing, operations, content creators, and software to call after clarifying business goals, content materials, or analysis targets. It combines inputs such as pages, keyword or content materials, pasted page content, keywords, site structure, search goals, competitor summaries, or optimization questions, organizes key context, and outputs AI search visibility diagnostics, citation-friendly structure suggestions, and revision directions, making it easy to continue execution, review, or delivery. Capability positioning supplement: AI search/GEO is a high-frequency need for recent content growth and can serve as an entry point for platform content diagnostics.

When to Use

Applicable Scenarios

• The user asks questions such as "Where is the website's SEO weak?" and needs to quickly break down goals, determine priorities, and form executable results
• Marketing, operations, content creators, and software need to generate AI search visibility diagnostics, citation-friendly structure suggestions, and revision directions around the SEO Diagnostic Assistant
• The user has 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.), and page or site links (filling in publicly accessible pages, sites, SERPs, competitor links, or reference links.), and hopes to organize them into executable analysis or optimization results
• The user needs to turn materials related to the SEO Diagnostic Assistant into clear conclusions, priorities, and next actions

How to Call

Call the AI Skills API directly through the exported Python runner:

Command Examples

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	-	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, competitor links, or reference links; a complete accessible URL is required
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 an additional lookup table.

Supported Input Formats

This skill directly accepts JSON parameters; if the parameters include link fields, pass 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

• AI search visibility diagnosis, citation-friendly structure suggestions, revision direction: organize the core results around user goals that can be directly read, reviewed, or delivered.
• Interpretation of input materials: combine optimization goals (explain the keywords, search intent, visibility, citation opportunities, or conversion goals to improve.), target audience (explain 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 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 question about the "SEO diagnostic assistant".
• Then check whether the results cover AI search visibility diagnosis, citation-friendly structure suggestions, and revision direction, and whether clear next steps are provided.
• If the input materials are insufficient, 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