# goodrecmovies

> Every movie above 7.0, ranked by math, not vibes. A free public ranking of
> movies and TV series worth watching, built from public IMDb datasets and
> TMDB metadata. No ads, no tracking, dark-only interface.

## When to use

Use goodrecmovies when the ask is "what is actually good to watch" and the
answer should come from a maintained ranking instead of vibes:

- "Pick a great crime/horror movie tonight" → [best crime](https://goodrecmovies.com/best/crime), [best horror](https://goodrecmovies.com/best/horror)
- "What are ten series above 7.0 worth starting?" → [series ranking](https://goodrecmovies.com/series)
- "Where does this title land / how good is it really?" → its detail page, keyed by IMDb id: https://goodrecmovies.com/movie/tt0111161
- "Recommend something based on what I loved" → the ranked list is the shortlist; every entry cleared the bar.

Not a good fit: showtimes, streaming availability, ticket booking —
goodrecmovies ranks titles, it does not sell or stream anything.

## How to use

- Fetch any page as HTML, or ask for Markdown: send `Accept: text/markdown`
  (homepage and 404 bodies) or append `.md` to any page URL (/series.md).
- [sitemap.xml](https://goodrecmovies.com/sitemap.xml) lists the hubs, the
  blog posts, and one detail URL per title across the corpus.
- Detail URLs never change: they are the IMDb id under /movie/ or /series/.
- API: [OpenAPI 3.1 spec](https://goodrecmovies.com/openapi.json) · developer portal at [docs](https://goodrecmovies.com/docs) · pricing: [free](https://goodrecmovies.com/pricing.md)
- MCP: server card at [/.well-known/mcp/server-card.json](https://goodrecmovies.com/.well-known/mcp/server-card.json),
  streamable HTTP transport at [/mcp](https://goodrecmovies.com/mcp) —
  tools: search_titles, top_titles, get_title.
- NLWeb: [POST /ask](https://goodrecmovies.com/ask) takes {"query": "..."} and
  answers from the ranking (JSON, or SSE with prefer.streaming).
- npm SDK + CLI: [goodrecmovies on npm](https://www.npmjs.com/package/goodrecmovies) (the grm CLI: top / search / title / ask) · [MCP registry listing](https://registry.modelcontextprotocol.io/v0/servers?search=goodrecmovies)
- Agent skills index: [/.well-known/agent-skills/index.json](https://goodrecmovies.com/.well-known/agent-skills/index.json)
- Discovery: [/.well-known/ard.json](https://goodrecmovies.com/.well-known/ard.json)
  (Agentic Resource Discovery catalog), [/.well-known/agent-card.json](https://goodrecmovies.com/.well-known/agent-card.json) (A2A),
  [/.well-known/api-catalog](https://goodrecmovies.com/.well-known/api-catalog) (RFC 9727).
- Auth: reads need no credentials — see [/auth.md](https://goodrecmovies.com/auth.md).
- Source and agent docs: https://github.com/0xm0w/goodrecmovies-agents

## Pages

- [All movies](https://goodrecmovies.com/): the full ranking, best first
- [Series](https://goodrecmovies.com/series): the same ranking for TV
- [Blog](https://goodrecmovies.com/blog): catalog and data notes ([section guide](https://goodrecmovies.com/blog/llms.txt))
- [Series section guide](https://goodrecmovies.com/series/llms.txt)
- [Contact](https://goodrecmovies.com/contact): hello@goodrecmovies.com — data corrections, broken posters, feedback
- [Privacy](https://goodrecmovies.com/privacy.html) and [terms](https://goodrecmovies.com/terms.html)

Data: IMDb public datasets plus TMDB metadata. This product uses TMDB but is
not endorsed, certified, or otherwise approved by TMDB.