ai-programmatic-seo

ai-programmatic-seo Programmatic SEO Assistant

Quick Start

More Skills

Overview

The Programmatic SEO Assistant is used to answer "Can pages acquire customers at scale?", 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 will combine inputs such as pages, keywords or content materials, pasted page content, keywords, site structure, search goals, competitor summaries, or optimization questions. It organizes key context and outputs page cluster plans, template risk warnings, and content production checklists, making it easy to continue execution, review, or delivery. Capability positioning supplement: it can be converted into batch page planning and a content quality gate, rather than directly generating low-quality pages.

When to Use

Applicable Scenarios

• Users ask questions such as "Can pages acquire customers at scale?" and need to quickly break down goals, determine priorities, and form actionable results
• Marketing, operations, content creators, and software need to generate page cluster plans, template risk warnings, and content production checklists around the Programmatic SEO 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.), page or site links (fill in publicly accessible pages, sites, SERPs, competitors, or reference links.), and hope to organize them into actionable analysis or optimization results
• Users need to turn materials related to the Programmatic SEO Assistant into clear conclusions, priorities, and next-step 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	-	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, 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 region, language, 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

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

Supported Input Formats

The current skill directly accepts JSON parameters; if the parameters contain link fields, please 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

• Page cluster planning, template risk alerts, content production checklist: organize the core results around user goals that can be directly read, reviewed, or delivered.
• Interpretation of input materials: combine 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.), and 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 developed.

Suggestions for using the results

• First determine whether the output answers the user's core question about "Programmatic SEO Assistant".
• Then check whether the results cover page cluster planning, template risk alerts, and the content production checklist, 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 source 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