# Intent-Aware SEO Scoring and Commerce Discovery

Help4 Builder Suite scores a page against the job that page is meant to do. A local service page, product page, article, and international landing page should not lose points for unrelated requirements.

## Scoring profiles

| Profile | Search | Readability | Analytics | Ad quality | Intent checks |
| --- | ---: | ---: | ---: | ---: | ---: |
| General website | 40% | 25% | 20% | 15% | 0% |
| Local or service business | 30% | 15% | 20% | 5% | 30% |
| Online store or catalog | 30% | 10% | 20% | 0% | 40% |
| Publisher or knowledge site | 30% | 25% | 10% | 20% | 15% |
| International or multilingual | 35% | 20% | 10% | 10% | 25% |

The plugin can select a profile from page schema, Help4 blocks, post type, hreflang setup, or the selected business onboarding profile. Administrators can set a site default and override individual pages in the Help4 SEO panel.

Scores are diagnostic checklists. They do not guarantee rankings, indexing, shopping placement, traffic, conversions, advertising approval, or rich-result display.

## Local intent

Local checks cover the public business identity, a specific truthful business subtype, phone, published location, address or service areas, coordinates, hours, place relevance, and a useful conversion path. Use one complete location record for each real office, store, or service location. Do not create thin location pages for places the business does not serve.

## Ecommerce intent

The Commerce Search Readiness report samples active catalog records in bounded batches and reports coverage for:

- Original factual descriptions.
- Crawlable product landing URLs.
- Primary product images.
- SKU, GTIN, or MPN identity without invented identifiers.
- Brand.
- Positive price and three-letter ISO currency.
- Current stock, preorder, or backorder state.
- Unique SKU and attributes for variable-product rows.
- Public shipping and return policy links.
- Optional merchant-feed availability.

The optional feed is available at `/h4-commerce-feed.xml`. It is off by default, returns 404 on private sites, and only emits complete active products. Public delivery streams 100-product cursor batches so large catalogs are not assembled in PHP memory. Product changes also enter the existing opt-in IndexNow queue when the landing URL belongs to the public site.

For an individual product page, choose Product schema and enter the matching Help4 Commerce product ID. The page graph then derives the product name, description, image, brand, SKU, GTIN, MPN, merchant category, offer price, currency, availability, condition, and seller from the active catalog record. This keeps structured data aligned with the commerce source of truth.

## Publisher and international intent

Publisher checks cover truthful editorial schema, authorship, relevant credentials, useful depth, headings, links and primary-source citations, representative imagery, taxonomy, dates, and summary text.

International checks cover localized URL sets, reciprocal hreflang, x-default, canonical validity, document language, localized social previews, organization identity, IndexNow readiness, and public sitemap discovery. A translated URL should contain a real localized page, not merely redirect by visitor IP.

## Extension contracts

- `h4bs_seo_intent_profiles` adds or changes scoring profiles.
- `h4bs_seo_score_formula` adjusts profile weights.
- `h4bs_seo_intent_scorecard` filters the final report.
- `h4bs_commerce_seo_catalog_audit` extends catalog coverage reporting.
- `h4bs_commerce_feed_item` filters a normalized merchant-feed item.
- `h4bs_commerce_feed_max_products` optionally caps feed output for an integration.
- `h4bs_seo_product_schema` extends or replaces a mapped Product graph.

## Primary references

- Google Product structured data: https://developers.google.com/search/docs/appearance/structured-data/product
- Google merchant listings: https://developers.google.com/search/docs/appearance/structured-data/merchant-listing
- Google product variants: https://developers.google.com/search/docs/appearance/structured-data/product-variants
- Google LocalBusiness structured data: https://developers.google.com/search/docs/appearance/structured-data/local-business
- Google Merchant Center product data: https://support.google.com/merchants/answer/7052112
- IndexNow protocol: https://www.indexnow.org/documentation
