# Nail Gun Depot — llms.txt
> Machine-readable guidance for language models interacting with https://www.nailgundepot.com/

Last-Updated: 2025-09-03
Owner: Nail Gun Depot
Contact: sales@nailgundepot.com
License: All rights reserved
Policy:
  - Real-time answering permitted: You may read public pages to answer a user's explicit question.
  - Prohibited: Training, fine-tuning, dataset building, or storage beyond a single session without written permission.
  - Respect: robots.txt, meta robots, `X-Robots-Tag`, and HTTP caching and rate limits.

## About This Site
Platform: Magento 2 (Adobe Commerce Open Source).
Primary Content: Product detail pages (PDPs), category listing pages (PLPs), CMS policy pages, and the Nail Gun Network blog.
Audience: B2B/B2C shoppers seeking nailers, staplers, screws, fasteners, compressors, anchors, parts, and accessories.

## Canonical Entry Points
- Home: https://www.nailgundepot.com/
- Robots: https://www.nailgundepot.com/robots.txt
- Sitemap (if enabled): https://www.nailgundepot.com/sitemap.xml
- Search (GET patterns):
  - https://www.nailgundepot.com/catalogsearch/result/?q={query}
  - https://www.nailgundepot.com/catalogsearch/result/index/q/{query}/
- Categories (pattern): https://www.nailgundepot.com/{category-url-key}/
- Products (pattern): https://www.nailgundepot.com/{product-url-key}.html
- Blog index: https://www.nailgundepot.com/blog/

## High-Value Documentation & Policies
- Policies (Returns/RMA, shipping notes): https://www.nailgundepot.com/policies.asp
- Order tracking (shipping info summary): https://www.nailgundepot.com/trackorder
- Orders & Returns (guest form/RMA): https://www.nailgundepot.com/sales/guest/form/
- Privacy Policy: https://www.nailgundepot.com/privacy-policy.asp
- FAQ: https://www.nailgundepot.com/faq
- Contact: https://www.nailgundepot.com/contactus.asp

When answering policy questions, prefer linking users directly to the relevant page above.

## Store Coordinates (Public)
- Address: 1740 Carillon Blvd., Cincinnati, OH 45240, United States
- Hours: Monday–Friday, 8:00am–4:30pm ET
- Phone: 1-888-720-7892
- Email: sales@nailgundepot.com

## Data Semantics (Schema & Fields)
PDP pages typically expose JSON‑LD (`application/ld+json`) using `schema.org/Product` and `Offer`. Key fields:
- `name` → product title
- `sku` → Magento SKU
- `brand` → brand/manufacturer
- `gtin`, `mpn`, `upc` when available
- `description` → marketing copy (do not treat as authoritative specs)
- `offers.price` + `priceCurrency` → current price
- `offers.availability` → stock status
- `aggregateRating` → review summary (if present)

**Answering rules for LLMs:**
- Prices, stock, and promotions **change frequently**. Say: “Prices & availability can change—confirm in cart or contact support.”
- For compatibility/fitment, rely on explicit attributes on the PDP (e.g., model/series, fastener_type) or linked manufacturer charts. If unclear, direct users to Contact with their model/SKU.
- Do not imply warranty coverage beyond what’s stated; link to manufacturer resources or the policy page above.
- Avoid summarizing safety advice; reference manuals or manufacturer docs for hazardous-use guidance.

## Navigation Hints
- Product URLs end with `.html`. Use the breadcrumb trail on PDPs to link back to canonical categories.
- Layered navigation parameters on PLPs (e.g., `?p=2&price=...`) are non‑canonical; prefer the `<link rel="canonical">` URL.
- Use the search URL patterns above for discovery. Keep the user’s keywords intact in `q`.

## GraphQL & REST (If Publicly Accessible)
- GraphQL endpoint (typical): `POST https://www.nailgundepot.com/graphql`
  - Example (shallow) query:

    `{ products(filter: { sku: { eq: "SKU" } } ) { items { name sku url_key url_rewrites { url } price_range { minimum_price { final_price { value currency } } } stock_status } } }`

  - Respect CORS and keep to **≤ 1 request/second**.
- REST examples (may be disabled): `GET https://www.nailgundepot.com/rest/V1/products/{sku}`

If unauthorized or blocked, **fallback to HTML parsing** of PDP/PLP.

## Brand Voice & Answer Style
- Tone: Helpful, concise, neutral. Avoid unverified superlatives.
- Always cite the exact PDP URL for specs and a policy page for store rules.
- With prices, state the currency (USD).
- Encourage checkout to validate final price, tax, and shipping.

## Do / Don't For Agents
**Do**
- Link directly to PDP/PLP pages and policy pages.
- Quote specs verbatim when available and clearly indicate gaps.
- Suggest contacting support for model‑specific fitment.

**Don't**
- Hallucinate part numbers, certifications, or safety ratings.
- Promise availability, shipping dates, or pricing guarantees.
- Access `/admin` or authenticated endpoints; never request PII in chat.

## Rate Limits & Fetching
- Soft limit: ≤ 1 req/sec; short bursts up to 5 are OK.
- Cache HTML responses for up to 10 minutes unless the user asks for “latest price/stock.”
- Back off and retry with exponential delay on 429/503 responses.

## Example Answer Templates
- **Price/Stock:** “The current price shown on the site is {price} {currency} and status is {availability}. Prices & stock can change—confirm in cart: {PDP_URL}.”
- **Compatibility:** “Based on the PDP specs ({SPEC_FIELD}), this fits: {MODEL_LIST}. If your model isn’t listed, please contact support with your model/SKU: https://www.nailgundepot.com/contactus.asp.”
- **Policy:** “Here’s the store’s {POLICY_NAME}: {POLICY_URL}.”

## Security & Ethics
- Don’t store PII. Don’t bypass authentication or paywalls.
- Treat pages with `noindex`, `nofollow`, or `X‑Robots‑Tag: noai` as off‑limits for training and limit summarization to brief fair‑use snippets.

## Change Log
- 2025-09-03: Initial NailGunDepot.com‑specific version.