programmatic-seo

programmatic-seo Programmatic SEO Assistant

Quick Start

More Skills

Overview

The Programmatic SEO Assistant is used to answer questions such as "Can pages acquire customers at scale?", SEO, GEO, and content growth. 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 programmatic page samples, pasteable page templates, field samples, keyword/entity lists, directory structures, page rules, or business... 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

• When users raise questions such as "Can pages acquire customers at scale?" and need to quickly break down goals, determine priorities, and form actionable results
• Marketing, operations, product, and software need to generate summaries, diagnostic conclusions, action recommendations, and reusable deliverables around the Programmatic SEO Assistant
• Users have already prepared scaled SEO goals (for example, covering long-tail keywords, expanding regional/industry pages, improving AI citations, or acquiring leads.), long-tail search audiences (explaining target query scenarios, regional/industry segments, buyer roles, or content consumption stages.), sample pages or directory links (filling in sample pages, directory pages, competitor pages, or page template links accessible without login.), and want 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 steps

How to Invoke

Invoke 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":"规模化 SEO 目标"}'

Parameter Description

Parameter	Type	Required	Default	Description
goal	string	No	-	For example, covering long-tail keywords, expanding regional/industry pages, improving AI citations, or acquiring leads
audience	string	No	-	Explain target query scenarios, regional/industry segments, buyer roles, or content consumption stages
materialUrl	string	No	-	Fill in sample pages, directory pages, competitor pages, or page template links accessible without login; must pass complete accessible URLs
materialFile	string	No	-	Supports CSV, spreadsheets, keyword lists, entity data samples, page templates, site structures, or requirement documents
materialText	string	No	-	Can paste page templates, field samples, keyword/entity lists, directory structures, page rules, or business descriptions
brandRequirements	string	No	-	Supplement brand tone, prohibited generation methods, compliance restrictions, required fields, and manual review requirements

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 a parameter contains a link field, 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":"规模化 SEO 目标"}'

Equivalent --params JSON：

{
  "goal": "规模化 SEO 目标"
}

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: combined with scaled SEO goals (for example, covering long-tail keywords, expanding regional/industry pages, improving AI citations, or generating leads.), long-tail search audiences (explain the target query scenarios, regional/industry segmentation, purchasing roles, or content consumption stages.), sample pages or directory links (fill in sample pages, directory pages, competitor pages, or page template links that can be accessed without logging in.) to extract key context and judgment basis.
• 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 "Programmatic SEO Assistant".
• Then check whether the results cover the summary, diagnostic conclusions, action recommendations, and reusable deliverables, 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