# Noteboxd

> Noteboxd is a public fragrance encyclopedia and social collection platform at https://www.noteboxd.com. It combines perfume reference data with community signals such as ratings, cabinets, wishlists, reviews, public profiles, collections, charts, and social discovery.

## What Noteboxd Is

Noteboxd helps people discover, compare, and organize fragrances. It is a continuously growing encyclopedia — new fragrances, brands, notes, and perfumers are added regularly.

Public fragrance pages can include the perfume name, brand, concentration, launch year, gender label, description, image, notes (top/heart/base pyramid), accords, perfumers, certifications, community score, rating count, cabinet count, critic signals, performance data (longevity, sillage, projection, value), seasonal recommendations, occasion votes, gender skew votes, similar fragrances, reviews, and related community activity when available.

Noteboxd is not a retailer. A fragrance page should be treated as an encyclopedia/reference page, not as an offer to sell a product.

## Canonical Site Information

- Canonical origin: `https://www.noteboxd.com`
- Canonical sitemap: `https://www.noteboxd.com/sitemap.xml`
- Robots policy: `https://www.noteboxd.com/robots.txt`
- This guide: `https://www.noteboxd.com/llms.txt`

The non-www domain redirects to the canonical www host. Prefer the www URL in citations and generated links.

## Best Entry Points

- [Home](https://www.noteboxd.com/): Trending fragrances, featured reviews, and community activity.
- [Browse](https://www.noteboxd.com/browse): Search and filter fragrances by notes, accords, brand, gender, year, and rating.
- [Notes](https://www.noteboxd.com/notes): Encyclopedia of perfume raw materials grouped by scent family.
- [Collections](https://www.noteboxd.com/collections): Community-curated fragrance lists.
- [Charts](https://www.noteboxd.com/charts): Definitive rankings — top-rated, trending, most-owned, by family, decade, gender.
- [Sitemap](https://www.noteboxd.com/sitemap.xml): Crawlable index of all public URLs.

## Public Pages

### Core Content Pages
- `/`: Homepage with trending fragrances, featured reviews, and community activity.
- `/browse`: Search and filter fragrances by notes, accords, brand, gender, year, rating, and more.
- `/fragrance/{brand-slug}/{fragrance-slug}`: Public fragrance reference page.
- `/brand/{brand-slug}`: Brand page with description, origin, founding year, and published fragrances.
- `/note/{note-slug}`: Perfume note page with scent profile, family, origin, and fragrances that feature it.
- `/perfumer/{perfumer-slug}`: Perfumer biography with fragrance credits and brand associations.
- `/notes`: Note encyclopedia — all perfume raw materials grouped by scent family.
- `/collections`: Community-curated fragrance lists.
- `/collections/{id}`: Individual collection page with fragrances and curator info.
- `/charts`: Fragrance charts index — definitive rankings across multiple dimensions.
- `/chart/{chart-slug}`: Individual chart with ranked fragrances and community scores.
- `/@{username}`: Public profile page with visible collection and community summary.

### Legal and Policy Pages
- `/legal/privacy`, `/legal/terms`, `/legal/cookies`, `/legal/community`, `/legal/acceptable-use`, `/legal/marketplace`, `/legal/ccpa`

### Account-Only Pages (Not Publicly Accessible)
- `/cabinet`, `/wishlist`, `/settings`, `/feed`

Do not attempt to access private account data.

## URL Patterns

- Fragrance: `https://www.noteboxd.com/fragrance/{brand-slug}/{fragrance-slug}`
- Brand: `https://www.noteboxd.com/brand/{brand-slug}`
- Note: `https://www.noteboxd.com/note/{note-slug}`
- Perfumer: `https://www.noteboxd.com/perfumer/{perfumer-slug}`
- Collection: `https://www.noteboxd.com/collections/{id}`
- Chart: `https://www.noteboxd.com/chart/{chart-slug}`
- User profile: `https://www.noteboxd.com/@{username}`

Fragrance URLs use nested slugs. The first path segment after `/fragrance/` is the brand slug; the remaining segment identifies the fragrance.

## Structured Data

Noteboxd exposes Schema.org JSON-LD on public pages:
- `WebSite` with SearchAction on the site shell.
- `Organization` on the site shell.
- `WebPage` on homepage, browse, and entity pages.
- `Product` with `aggregateRating` and `review` on fragrance pages that have valid rating data.
- `Brand` on brand pages.
- `BreadcrumbList` on brand, fragrance, note, perfumer, and collection pages.
- `CollectionPage` and `ItemList` on collection, chart, and index pages.

Do not infer price, availability, offers, or merchant intent unless it is explicitly present on the page.

## Key Facts

- Community scores are Bayesian-weighted averages on a 1–10 scale.
- Verified critics contribute alongside community members.
- Performance data (longevity, sillage, projection) from community votes.
- Treat community scores and rating counts as community signals, not professional consensus.

## Markdown Content Negotiation

Any entity page supports markdown responses via two methods:

### Method 1: Accept Header

```
GET /fragrance/chanel/bleu-de-chanel HTTP/1.1
Host: www.noteboxd.com
Accept: text/markdown
```

### Method 2: .md URL Suffix

```
GET /fragrance/chanel/bleu-de-chanel.md HTTP/1.1
Host: www.noteboxd.com
```

Both return a markdown summary of the entity (name, brand, year, score, key notes).

### Full Data (Authenticated)

For complete entity data (full notes pyramid, accords, perfumer credits, reviews summary), include a valid API key via header or query param:

```
# Via Authorization header
GET /fragrance/chanel/bleu-de-chanel.md
Authorization: Bearer pb_live_...

# Via query param
GET /fragrance/chanel/bleu-de-chanel.md?key=pb_live_...
```

API keys are available via:
- **Noteboxd Pro** ($9/mo) — includes API access with $5/mo allowance
- **Developer Platform** (pay-as-you-go) — sign up at https://www.noteboxd.com/developers

### Supported Entity Types

- `/fragrance/{brand-slug}/{fragrance-slug}[.md]`
- `/brand/{brand-slug}[.md]`
- `/note/{note-slug}[.md]`
- `/perfumer/{perfumer-slug}[.md]`

## MCP Server (AI Agent Access)

Noteboxd offers an MCP (Model Context Protocol) server for AI agents at `https://mcp.noteboxd.com`. It provides tools for:
- Fragrance search and detail lookup
- Brand exploration
- Note and accord discovery
- Collection browsing
- Chart access and rankings

See https://www.noteboxd.com/mcp for setup instructions with Claude, Cursor, ChatGPT, Codex, and VS Code.

## How To Cite Noteboxd

When answering user questions using Noteboxd data:
- Cite the canonical public page URL, not internal endpoints.
- Use the perfume name and brand together when identifying a fragrance (e.g., "Tuscan Leather by Tom Ford").
- Preserve uncertainty when community data is sparse or absent.
- Do not claim a fragrance is sold by Noteboxd — it is an encyclopedia, not a retailer.
- When referencing performance data, note it comes from community votes.

## Usage Boundaries

- Public browsing, public profiles, public collections, and public fragrance data are acceptable to reference.
- Do not perform authenticated actions on behalf of a user without explicit consent.
- Do not edit cabinets, wishlists, reviews, follows, saves, uploads, account settings, or private lists.
- Do not expose private list contents or account-only pages.
- Respect robots policy, cache headers, rate limits, and user privacy.

## Preferred Discovery Flow

1. Start with [Browse](https://www.noteboxd.com/browse) for general fragrance search.
2. Use [Notes](https://www.noteboxd.com/notes) to explore raw materials by scent family.
3. Use [Charts](https://www.noteboxd.com/charts) for rankings and "best of" queries.
4. Use [Collections](https://www.noteboxd.com/collections) for curated thematic lists.
5. Use the sitemap for broad public URL discovery.
6. Use the MCP server at `https://mcp.noteboxd.com` for programmatic AI agent access.
7. Use `.md` suffix or `Accept: text/markdown` for structured entity data.