mars-tw/open-seo-advisor-skill

開源、可攜、不綁定單一廠商的全域 SEO 顧問技能 - 蒸餾 SEO 權威方法論，協助任何產業做 SEO 健檢、修復、內容產出

Open SEO Advisor – What it is

Open SEO Advisor is an open‑source CLI tool and skill for AI coding agents (e.g., Claude Code, Codex, OpenCode). It bundles a set of SEO‑related workflows – site health checks, technical fixes, security audits, content generation, WordPress plugin scaffolding, ad‑campaign advice, and even a “matrix” that coordinates many AI‑assistant roles – into a single command‑line interface that can be run locally or invoked by an AI agent.

Core capabilities (the “seven modes”)

Mode	What it does
Consultant	Scans an entire site, produces a plain‑language report and a prioritized to‑do list.
Engineer	Detects and proposes fixes for technical SEO items such as `sitemap.xml`, `robots.txt`, canonical tags, `hreflang`, etc.
Security	Looks for SEO‑related security risks (exposed files, outdated CMS, malicious redirects, HTTPS problems).
Content Writer	Calls an LLM (Claude, OpenAI GPT, or a local model) to draft SEO‑friendly copy following best‑practice guidelines.
Plugin Dev	Generates starter code for SEO‑focused WordPress plugins or other CMS extensions.
Meta Ads	Analyzes a Meta (Facebook/Instagram) ad account and outputs a dry‑run optimisation plan; any real spend actions are locked behind explicit confirmation.
Image Material	Produces image assets for ads, articles, or social posts using a configurable image provider (OpenAI DALL‑E by default).

Higher‑level “AI Matrix” orchestrator

Beyond the individual modes, the tool offers a matrix command that accepts a single business goal (e.g., “promote a new product and increase enquiries”). An internal controller (named NORA) assigns the task to a roster of 26 AI‑role agents (strategy, marketing, sales, finance, legal, etc.). Each role invokes the appropriate mode, and the system aggregates the outputs into a single deliverable. High‑risk steps such as publishing or spending money always require manual confirmation.

How you can use it

Standalone CLI – Install the package, then run seo-advisor commands directly. Example:
```
seo-advisor audit consultant --url https://example.com --out ./report
```
This creates four reports (markdown, JSON, HTML, and a beginner‑friendly summary).
AI‑agent skill – Clone the repo into an OpenCode or Codex skill directory. An agent can then be prompted:

“使用 $open‑seo‑advisor，帶我建立有 GPT 圖文與沉浸式滾動動畫的購物網站，優先用免費主機。” The agent will guide you through brand definition, story‑boarding, GPT image generation, site scaffolding, and deployment choices (Cloudflare, Firebase, GCP Cloud Run).
Offline site builder – The seo-advisor website init command creates a static site skeleton, a list of image prompts, and deployment configuration files. You still need to run the LLM/image APIs yourself and add any e‑commerce logic.

What the repo actually ships

Python package (scripts/) exposing the seo-advisor entry‑point.
Documentation covering quick‑start, architecture, mode‑specific details, and a capability map.
Example demos of immersive storytelling sites that use GPT‑generated images (the “leaf home” and “gongbi painting” demos). These are no‑index demo pages meant only for illustration.
CI workflow and an Apache‑2.0 license.

Limitations & verification notes (as stated in the README)

The CLI only performs offline analysis; it never modifies a live site unless you explicitly approve a write/deploy step.
Generated GPT images, multi‑page e‑commerce flows, and payment integration are not automated – the agent must invoke the appropriate APIs after the scaffold is built.
SEO impact (rankings, AI‑search citations) must be measured after the site is live and indexed; the tool can only guarantee that metadata, canonical tags, etc., are correctly set.
Demo sites are served with noindex,follow and are not intended as production‑ready examples.

Who might find it useful?

SEO consultants who want a reproducible, scriptable audit that can be handed off to an LLM for report generation.
Developers building SEO‑aware static or WordPress sites and who prefer a single tool that can also scaffold content.
AI‑agent platform users (OpenCode, Claude Code, Codex) looking for a ready‑made “skill” that lets the agent orchestrate SEO, content, and marketing tasks.
Small businesses that want to experiment with AI‑generated copy and images while keeping costs low (the tool defaults to read‑only, free‑tier APIs).

Quick start checklist

Run the platform‑specific install script (install.sh or install.ps1).
Execute seo-advisor and answer the interactive prompts, or run a specific mode like seo-advisor audit consultant --url https://your‑site.com.
Review the generated reports; address any P0–P3 items manually or let an AI agent continue the workflow.
When ready, use the seo-advisor website commands to scaffold a site, then deploy via your chosen host.

Contribution & community

The project welcomes contributions: new connectors (e.g., for additional CMSs), extra analyzers, language localisations, or improvements to the AI‑matrix logic. See CONTRIBUTING.md for setup instructions and the issue tracker for open tasks.

Bottom line: Open SEO Advisor is a genuine, AI‑enhanced SEO toolkit that can be run as a normal CLI or as a skill for AI coding agents. It focuses on audit, remediation guidance, and content generation rather than providing a full‑featured e‑commerce platform.