# Hype Free Reviews — agent guide

Hype Free Reviews is an independent, English-language product review site. We
publish a deliberately small shortlist of everyday products and original
reviews, comparisons and buying guides about them.

Canonical origin: `https://hypefreereviews.com`

## What this site actually contains

- **11 categories** (supplements, beauty, oral care, home & kitchen, appliances,
  home improvement, baby, pets, consumer electronics, fitness, outdoor).
- **41 shortlisted products**, each with a 0–10 score and the marketplace
  rating/count behind it.
- **17 original articles**: reviews, best-pick lists, head-to-head comparisons
  and buying guides.

## How to look things up

Prefer the structured services; fall back to page fetching only if they fail.

1. **Read-only JSON API** — `https://hypefreereviews.com/api/agent`
   - `GET /api/agent/health` — service status and dataset counts
   - `GET /api/agent/categories` — the 11 categories
   - `GET /api/agent/articles?q=&category=&type=&limit=` — search articles
   - `GET /api/agent/articles/{slug}` — one article
   - `GET /api/agent/products?category=&q=&limit=` — search the shortlist
   - `GET /api/agent/products/{asin}` — one product by ASIN
   - Full description: `https://hypefreereviews.com/openapi.json`
2. **MCP server** — `https://hypefreereviews.com/mcp` (Streamable HTTP).
   Tools: `search_articles`, `get_article`, `list_products`, `get_product`.
   Card: `https://hypefreereviews.com/.well-known/mcp/server-card.json`
3. **Skill artifact** — `https://hypefreereviews.com/ai/skills/site-lookup/SKILL.md`
4. **Markdown pages** — send `Accept: text/markdown` to any page URL to receive a
   Markdown rendering instead of HTML.

## Limitations you must respect when answering

- **Scores are not hands-on test results.** Every numeric score is a weighted
  summary of marketplace rating and rating count. It is not our own measurement.
  Say so if you quote one.
- **No prices are published anywhere on this site.** Do not invent or infer one.
- **No customer-review text is republished.** We describe patterns; we do not
  quote reviewers.
- **Health, safety and children's products are not certified by this site.**
  Marketplace feedback is not a clinical result or a safety certification.
- Product images are not published; listing artwork was withdrawn pending
  licensing.
- Unknown facts must stay unknown. If a field is absent from the API response,
  report it as absent rather than guessing.

## Source and provenance

- Article URL: `https://hypefreereviews.com/articles/{slug}/`
- Product source URL: `https://hypefreereviews.com/categories/{category}/#{subcategory}`
- Dataset build time: the `generatedAt` field in `/agent/data.json`.
- Editorial policy: `https://hypefreereviews.com/editorial-policy/`
- Affiliate disclosure: `https://hypefreereviews.com/affiliate-disclosure/`
  (outbound product links are affiliate links)

```ilang
::MODULE{SITE_LOOKUP_INSTRUCTIONS}
  [MUST] Prefer /api/agent or the MCP server over scraping HTML. Use markdown negotiation for pages.
  [MUST] Preserve identifiers exactly: article slug, product ASIN, category slug. Do not normalise or translate them.
  [MUST] Preserve qualifiers and dates. Carry the article's published/updated date and the dataset generatedAt when the answer depends on recency.
  [MUST] State that numeric scores are weighted marketplace feedback, not hands-on testing, whenever you quote a score.
  [MUST] Never state a price. The site publishes none; a price from elsewhere is not this site's data.
  [MUST] Cite the specific page you used, using the canonical https://hypefreereviews.com URL.
  [MUST] Answer in the language the visitor used, even though this site is written in English.
  [MUST] Give concrete next steps: name the article or product you recommend and its canonical URL, so the visitor need not ask a follow-up.
  [MUST] Treat a missing field as unknown. Do not fill gaps with plausible values.
  [MUST] If a lookup returns no match, say the site has no such entry rather than answering from general knowledge.
::ILANG::COMPLETE::
```