overlay: 1.0.0
info:
  title: API Evangelist enhancements — _done Shopify AI Rank Checker
  version: 1.0.0
extends: openapi/done-shopify-ai-rank-checker-openapi.yml
x-generated: '2026-08-11'
x-method: generated
x-source: openapi/_original/done-shopify-ai-rank-checker-openapi.json
x-note: 'Non-destructive. Captures API Evangelist enhancements only: catalog provenance, a canonical resource tag
  in place of the SEO keyword tag list (keywords preserved under x-keywords), and a service-namespaced canonical
  operationId. The provider spec is never mutated.'
actions:
- target: $.info
  description: Record API Evangelist provenance and the catalog identity of this service.
  update:
    x-api-evangelist:
      provider: _done
      slug: done
      catalog: https://apis.io/provider/done/
      harvested: '2026-08-11'
      source: https://shopify-ai-rank-checker.underscoredone.com/openapi.json
      payment_protocol: x402
      price_usd: 0.01
- target: $.paths["/rank"].post
  description: Collapse 15 SEO keyword tags to one canonical resource tag "shopify rank". The original keyword list
    is preserved as x-keywords so nothing is lost.
  update:
    tags:
    - shopify rank
    x-keywords:
    - shopify rank
    - ai visibility
    - product visibility
    - shopify
    - ai shopping
    - shopify seo
    - ai search ranking
    - llm seo
    - generative engine optimization
    - answer engine optimization
    - geo
    - aeo
    - chatgpt shopping
    - product rank checker
    - ai overview ranking
- target: $.paths["/rank"].post
  description: Namespace the operationId by service — operationIds collide across the 26 _done specs.
  update:
    x-canonical-operation-id: shopify_ai_rank_checker_handler_rank_post
- target: $.tags
  description: Reduce the 15-entry SEO tag list to one canonical resource tag.
  update:
  - name: shopify rank
    description: Shopify AI Rank Checker