ai-serp-analysis

ai-serp-analysis SERP Analysis Assistant

Quick Start

More Skills

Overview

The SERP Analysis Assistant is used to answer "what is SERP telling me," 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, keyword or content materials, pasted page content, keywords, site structure, search goals, competitor summaries, or optimization questions, organizes key context, and outputs content diagnostics, structured optimization suggestions, and actionable publishing checklists for further execution, review, or delivery. Capability positioning supplement: the skills.sh hot signal shows that serp-analysis has user demand; the platform displays it as a content_marketing business assistant directory, outputting reviewable diagnostics, suggestions, or production preparation packages.

When to Use

Applicable Scenarios

• Users ask questions such as "what is SERP telling me" and need to quickly break down goals, determine priorities, and form actionable results
• Marketing, operations, content creators, and software need to generate content diagnostics, structured optimization suggestions, and actionable publishing checklists around the SERP Analysis Assistant
• Users have already prepared 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), and page or site links (fill in publicly accessible pages, sites, SERPs, competitor or reference links), and want to organize them into actionable analysis or optimization results
• Users need to turn materials related to the SERP Analysis Assistant into clear conclusions, priorities, and next-step actions

How to Invoke

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

Command Example

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	-	Explain the keywords, search intent, visibility, citation opportunities, or conversion goals to improve
audience	string	No	-	Explain search users, target market, industry, purchase stage, or content audience
materialUrl	string	No	-	Fill in publicly accessible pages, sites, SERPs, competitor or reference links; a complete accessible URL must be provided
materialFile	string	No	-	Upload content drafts, keyword lists, site structure, 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 region, language, brand restrictions, unchangeable facts, compliance requirements, or key points for manual review

See the complete machine-readable parameter structure in references/form-schema.json。

Parameter Value Reference

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

Supported Input Formats

The current skill directly accepts JSON parameters; if the parameters include a link field, please pass a complete, accessible URL.

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

• Content diagnosis, structured optimization suggestions, actionable publishing checklist: organizes the core results that can be directly read, reviewed, or delivered around the user's goals.
• Interpretation of input materials: combined with the optimization goal (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, competitor, 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 question about the "SERP Analysis Assistant".
• Then check whether the results cover content diagnosis, structured optimization suggestions, an actionable publishing 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