Installation
- Install the app from Shopify.
- Approve product read/write access. The product write scope is used for the app-owned JSON-LD metafield and merchant-approved optimizer saves.
- Open the embedded dashboard.
- Enable the Shopigent AI GEO theme app block or embed in the theme editor.
Quick Start
1. Generate and Sync Schemas
Open the Dashboard and click Generate GEO Schemas. The app generates the JSON-LD pack for up to your plan limit and writes the storefront pack to an app-owned product metafield.
Store-level Organization and WebSite data comes from the theme extension. Product pages render Product with nested Offer data. Current catalog sync does not load review ratings or taxonomy categories, so it does not emit AggregateRating or category-based BreadcrumbList. FAQ, shipping, and return-policy schema configuration are not exposed in Settings.
2. Verify Storefront Delivery
Run Live HTML Check on a product URL. This confirms whether JSON-LD appears in the storefront response. The check runs against publicly accessible product pages; a password-protected storefront can also be checked by supplying the store password for a single check (it is never stored).
3. Review the Description Score
The AI Optimizer gives each product a heuristic score and recommendations. Growth and Pro can request a GPT-4o-mini rewrite. Suggestions are advisory until you explicitly save them.
4. Run a Measurement
Growth includes four and Pro includes ten manual citation runs per month, plus four scheduled citation runs per UTC month on each paid plan. Runs use selected, available engines: OpenAI web search and Perplexity Agent on Growth; Pro can also select Grok (xAI) web search; Claude (Anthropic) web search is available for manual runs only. Only a provider-attached citation of your store domain counts. These are point-in-time provider responses, not ranking guarantees.
Real provider measurement is disabled for test installs, including development/reviewer stores with test subscriptions. Manual runs, scheduled runs, and competitive measurement cannot call providers on those installs; a paid test plan does not enable real measurement. Use schemas, MCP, heuristic optimization, and eligible HTML checks for test-store review instead.
5. Test the MCP Tools
Open MCP Sandbox to run any of the eight tools inside the app. To connect an external compatible client, generate an MCP API key in Settings → MCP Storefront and configure that client with the endpoint and key.
6. Compare a Competitor (Growth and Pro)
Enter a public competitor URL in Competitive Comparison. The app runs one manual comparison through the configured real-AI providers and consumes one real-AI quota unit. Provider failures do not create a successful saved result.
What GEO Means Here
Shopigent AI GEO makes product information more machine-readable through schema.org JSON-LD and authenticated catalog tools. It also provides clearly labeled domain-citation measurements. It does not guarantee that a third-party AI platform will index, rank, or recommend a product.