AI Practice | Zuki Zhuang

AI SEO Diagnose Workflow: A Designer’s Practice Ground for Building, Testing, and Learning

Background

As a UX/Product designer, I’m watching AI reshape how software is built and shipped. Instead of waiting for a perfect plan, I’m learning by doing. This SEO Diagnose workflow is part of my ongoing practice: small experiments, honest results, steady iteration. Building it shifted my mindset, from designing screens to designing workflows and data paths. It also changed how I plan work: shorter cycles, clear constraints, simple metrics, and explainable outputs. It isn’t a finished product but a living sandbox for learning.

Tools

Core Function

Diagnose the SEO performance of your product page with a single link

At first the workflow was just three nodes: an input node, an LLM that ran the diagnosis, and an output node. That was fine for my own use, but not for real users. To make it product ready, branches and guardrails are needed.

Initial Workflow Plan

Guardrails and Branches

1. Input Content
We cannot control what people type. They paste sentences, product names, or multiple links. Before any diagnosis, the workflow must ensure the LLM receives a single, valid URL that can be analyzed.

Two nodes added

URL Extractor: Scan the user message, pick the first valid http or https link, normalize it, and strip obvious tracking parameters.
No-URL Handler: If no valid link is found, stop the flow and ask the user to provide a direct product page URL.

2. Fetch Page Content

LLMs can read only a small slice of a page when you give them a URL. That is not enough for a real SEO diagnosis. The workflow needs the page’s front-end code so the model can see titles, metadata, headings, links, and schema. 

Two nodes added

HTML Fetcher: Request the URL, follow redirects, record status code, content type, and charset. Detect blocked pages, login walls, very heavy JavaScript, or non-HTML responses. Output fields include raw_html, status, and fetch_notes.
SEO Sanitizer: Reduce the HTML to only what matters for SEO. Keep title, meta description, meta robots, canonical, hreflang, Open Graph, JSON-LD for Product or Breadcrumb, headings H1 to H3, image tags with alt, and anchor links. Drop scripts, styles, tracking markup, repeated navigation, and non-content widgets. Collapse whitespace and normalize attributes.

3. Page Type Check

Before any SEO diagnosis, the workflow must verify that the URL is a standalone site product detail page. If it is a homepage, category, search, blog, or a marketplace listing, the diagnosis stops and the user is asked for a valid product page on an independent site.

Improved Workflow

Try the demo

Workflow in Coze

https://www.snazzyswitch.com/stained-glass-roses-light-switch-plate-cover/

You are “The SEO & Online-Marketing Strategist,” a senior-level specialist in technical SEO, content strategy, paid / organic acquisition, and e-commerce conversion.
For every user request:
1. ****
2. ****
3. ****
Always follow these rules in every reply.
Your task is to critically audit the SEO performance of a product detail page. You will be provided with the page’s URL ({{url}}), and sometimes the front-end code ({{seo_data}}).
STEP 1: Validate Page Type (Independent Store Product Page Validation)
• ****
• ****
• ****
STEP 2: Data Source Selection
• ****
• ****
• ****
Audit Checklist (for your internal analysis):
Content & Keywords
• ****
• ****
• ****
Technical SEO & Site Structure
• ****
• ****
• ****
User Experience
• ****
• ****
• ****
Platform-Specific & Seller Trust Signals
• ****
• ****
• ****
Output Formatting Instructions:
• ****
• ****
• ****

Problem: Missing structured data for product, offers, and reviews.
SEO Concept Explanation: Structured data (schema markup) helps search engines understand the content and context of the page, enabling rich results like product details, price, availability, and reviews in search listings.
Impact on SEO: Without proper structured data, the product page may not appear with enhanced listings in search results, reducing click-through rates and visibility.
How to Fix: Implement JSON-LD structured data for Product, Offer, and AggregateRating schemas following schema.org standards, including price, availability, and customer reviews.

Problem: Meta description is missing or not clearly provided.
SEO Concept Explanation: The meta description is a snippet shown in search results that summarizes the page content; it should be unique and compelling to encourage clicks.
Impact on SEO: Lack of a clear meta description can result in search engines generating random snippets, which may be less relevant or attractive to users, reducing click-through rates.
How to Fix: Add a concise, keyword-rich meta description describing the product and its benefits.

Problem: Product description lacks detailed specifications or bullet points.
SEO Concept Explanation: Detailed product information helps both users and search engines understand the product features and benefits clearly.
Impact on SEO: Thin or vague product descriptions reduce relevance for search queries, lowering rankings and user engagement.
How to Fix: Enhance the product description by adding clear, original content including specifications, materials, sizes, and unique selling points in bullet points or short paragraphs.

Problem: Only one H1 heading present but subheadings (H2, H3) are not fully optimized for content structure.
SEO Concept Explanation: Proper heading hierarchy organizes content for users and search engines, improving readability and crawlability.
Impact on SEO: Poor heading structure can confuse search engines about page content priorities, potentially hurting ranking.
How to Fix: Review and optimize subheadings to logically organize sections like Description, Reviews, Related Products, ensuring they include relevant keywords.

Problem: Some images have generic alt text or missing alt attributes.
SEO Concept Explanation: Alt text describes images for search engines and accessibility tools, improving SEO and user experience.
Impact on SEO: Missing or non-descriptive alt text reduces image search visibility and accessibility compliance.
How to Fix: Add descriptive alt text to all product images that include the product name and key features.

Problem: URL is long and includes unnecessary words.
SEO Concept Explanation: Short, keyword-rich URLs are easier for users and search engines to understand and remember.
Impact on SEO: Complex URLs can dilute keyword relevance and reduce click-through rates.
How to Fix: Simplify the URL to focus on main keywords, e.g., /stained-glass-roses-switch-plate/

Problem: No breadcrumb navigation structured data and breadcrumbs are not clearly visible.
SEO Concept Explanation: Breadcrumbs help users and search engines understand site hierarchy and improve navigation.
Impact on SEO: Lack of breadcrumbs can reduce user experience and site crawlability.
How to Fix: Add visible breadcrumb navigation with proper schema markup.

Problem: Lack of visible stock or shipping information on the product page.
SEO Concept Explanation: Clear stock and shipping info builds user trust and can influence purchase decisions.
Impact on SEO: Absence may increase bounce rates and reduce conversions.
How to Fix: Display current stock status and shipping details prominently near the purchase button.

Problem: No visible seller or brand information on the product page.
SEO Concept Explanation: Brand and seller info enhance E-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness) signals.
Impact on SEO: Missing brand info can reduce user confidence and SEO trust signals.
How to Fix: Add clear branding and seller details on the product page.

Problem: No visible customer support, return policy, or FAQ links on the product page.
SEO Concept Explanation: These elements reduce purchase friction and improve user trust.
Impact on SEO: Absence can increase bounce rates and reduce conversions.
How to Fix: Include links or sections for support, returns, and FAQs on or near the product page.

CoT-Guided Reasoning & Output

Beyond page-type verification, I modeled the prompt on how an SEO specialist audits a product page. The LLM now follows a clear reasoning checklist and returns a structured report. It reviews content and keywords, technical markup and structure, media and alt text, structured data, page experience, and trust signals. For each area it summarizes signals, states status, ranks severity, points to evidence, and provides a concrete fix with an example. To help non-experts, it also explains any SEO terms briefly. After this change, outputs became professional, controllable, and consistent.

The product detail page (PDP) for 'Stained Glass Roses Decorative Light Switch Plate Cover' demonstrates several strengths and some critical SEO improvement opportunities. Strengths include a clear, descriptive H1 heading that matches the product title, relevant meta keywords, and well-optimized image alt attributes describing the product, which supports image SEO. The page title is descriptive and contains the main product keyword. However, the page lacks structured data markup for products and offers, which is crucial for enhanced search results and rich snippets. The canonical URL is correctly set. The meta description is missing or not provided, which is a significant gap for CTR optimization in SERPs. The headings structure beyond H1 is mostly for UI sections (reviews, related products) and does not include keyword-rich subheadings to support content relevance. Images have alt text but could benefit from optimized file names and sizes for Core Web Vitals performance. No hreflang tags are present, which is acceptable if the site targets only one language/region. The page does not appear to have visible schema.org Product or Offer structured data, limiting rich snippet eligibility. The user reviews and related products sections could be leveraged to add user-generated content and internal linking, boosting E-E-A-T and crawlability. Recommendations: 1) Implement Product and Offer schema with accurate price, availability, and rating data; 2) Add a compelling meta description incorporating target keywords; 3) Enhance content with keyword-optimized subheadings and detailed product descriptions; 4) Optimize images for faster loading and SEO-friendly filenames; 5) Use internal linking to related products and encourage review generation; 6) Monitor Core Web Vitals and improve page speed if needed. These actions align with Google Search Central guidelines and best practices from Moz and SEMrush for ecommerce PDP optimization. Without structured data and meta description, the page risks lower CTR and missed rich result opportunities despite relevant content and images.

Identity Reinforcement

I explicitly defined the model’s role and guardrails—who it is, what to consider, and how to answer. As a result, responses became more professional: clearer problem identification with simple, actionable fix suggestions. However, the output still lacked a structured format and consistent sections or fields.

The core function of Desty Page is to provide users with the widgets they need to create biolin pages. With such an infrastructure, it becomes very easy and organized to manage the development of widgets, including adding, modifying, and deleting.

The product detail page (PDP) for 'Stained Glass Roses Decorative Light Switch Plate Cover' has several SEO strengths including a clear and descriptive title tag, relevant meta keywords, and good use of headings (H1 and H2) that incorporate the product name and related content sections. The page includes multiple high-quality images with descriptive alt attributes, which enhances image SEO and accessibility. The canonical URL is correctly set to the product URL, helping to avoid duplicate content issues. Open Graph metadata is present with a descriptive product description, image, site name, and URL, supporting social media sharing optimization. However, the page lacks structured data markup for product, offers, and ratings, which are important for rich results in search engines. Also, the meta description tag is missing or not provided in the data, which is critical for click-through rates from search results. Adding complete and accurate structured data (Product schema with offers and aggregateRating) and a well-crafted meta description would improve the page's SEO performance significantly.

Initial Prompt

The first version used a single paragraph. Outputs were very simple and lacked structure, with no clear sections or consistent formatting.

Guardrails and Branches

Future Iteration

This workflow is just one step in my exploration, not a finished product. I’m still learning the concept of RAG and testing how knowledge base structure affects answer quality: chunk sizes, metadata, re-ranking, and evaluation sets. The exploration is still ongoing...

View more cases

Contact me

(1) 506 566 3218

Zuki Zhuang