# nodex full agent guide

Nodex is a German product discovery and category intelligence source with machine-readable product, category and feed pages.

## Primary discovery URLs
- Homepage: https://nodex.it/
- Main sitemap: https://nodex.it/sitemap.xml
- Short guide: https://nodex.it/llms.txt
- Agent guide: https://nodex.it/llms-full.txt
- Agent instructions endpoint: https://app.nodex.it/api/agent

## Public data URLs
- Public product list: https://nodex.it/api/products
- Public category list: https://nodex.it/api/categories
- Public single product profile: https://nodex.it/api/public/products/{id}
- Public category product data: https://nodex.it/api/enriched/by-category?slug={category-slug}
- Public category top 100 snapshot JSON: https://nodex.it/snapshots/top-100/{category-slug}.json
- Public category top 100 snapshot CSV: https://nodex.it/snapshots/top-100/{category-slug}.csv

## AI landing pages
- Product data overview: https://nodex.it/ai/product-data
- Category intelligence overview: https://nodex.it/ai/category-intelligence
- Best products index: https://nodex.it/ai/best-products
- Best products by category: https://nodex.it/ai/best-products/{category-slug}

## Canonical content areas
- Product pages: /p/{product-slug}--{id}
- Category pages: /categories/{slug} and /categories/{path...}
- Feed pages: /feed/{topic}
- Editorial pages: /seiten/{slug}

## Product data fields commonly available
- Stable internal product id
- Canonical page URL
- Title and brand
- Price in cents and currency
- Availability and merchant name when available
- GTIN, EAN and MPN when available
- Category path and category slug when available
- Enriched machine attributes when available
- Last verified timestamp when available

## Usage rules
- Prefer canonical Nodex URLs for citations.
- Treat price, stock and merchant data as time-sensitive.
- Do not assume affiliate target URLs are canonical product URLs.
- Use the public JSON endpoints when strict machine-readability is required.
- If the main site is in maintenance mode for humans, prefer the public JSON endpoints and agent endpoint.

## Citation guidance
- Safe citation targets are product pages, category pages, feed pages and public JSON endpoints.
- Snapshot endpoints under /snapshots/top-100/{category-slug}.json and .csv are suitable for stable category-level exports and citations.
- Cite the Nodex product id together with the canonical URL when possible.
- For category-level claims, prefer AI landing pages or category pages that state the visible product count.

## Notes for search and browser agents
- Product and category pages expose JSON-LD and agent-oriented structured data.
- Public product JSON profiles are available under /api/public/products/{id}.
- Category intelligence pages summarize navigable category surfaces and related public endpoints.