pull-store-data

Download current store content to store-data/ so future sessions can read local files instead of re-querying the API. Run this after major content changes or when starting a new build phase.

Validate every query with shopify-plugin:shopify-admin before executing with shopify-plugin:shopify-admin-execution (read-only throughout — no --allow-mutations).

Add a _pulled timestamp field to each file so staleness is visible.

---

1. Pages → store-data/pages.json

{
  pages(first: 250) {
    nodes {
      id handle title bodySummary
      createdAt updatedAt publishedAt
    }
  }
}

If pageInfo.hasNextPage is true, paginate until all pages are fetched.

---

2. Navigation → store-data/navigation.json

{
  menus(first: 20) {
    nodes {
      id handle title
      items {
        id title url type
        items { id title url type }
      }
    }
  }
}

---

3. Blogs & posts → store-data/blogs.json

{
  blogs(first: 20) {
    nodes {
      id handle title
      articles(first: 50, sortKey: PUBLISHED_AT, reverse: true) {
        nodes { id handle title publishedAt tags }
      }
    }
  }
}

---

4. Collections → store-data/collections.json

{
  collections(first: 250) {
    nodes {
      id handle title productsCount { count }
      ruleSet { appliedDisjunctively rules { column relation condition } }
    }
  }
}

Paginate if needed.

---

5. Products index → store-data/products-index.csv

Fetch up to 500 products. If the catalog is larger (check store-data/store-profile.md), note the total count and fetch the first 500 sorted by UPDATED_AT descending so the most-recently-touched products are captured.

{
  products(first: 250, sortKey: UPDATED_AT, reverse: true) {
    nodes {
      id handle title vendor productType tags status
      variantsCount { count }
      metafields(first: 5) { nodes { namespace key } }
      collections(first: 10) { nodes { handle title } }
    }
    pageInfo { hasNextPage endCursor }
  }
}