content-advisory

# Content Advisory

Detailed parental content ratings for movies and TV shows. Goes beyond simple MPAA ratings with specific breakdowns of objectionable content.

## Features

- **Detailed ratings** — Sex/Nudity, Violence/Gore, Language on 0-10 scale
- **Content specifics** — Exact descriptions of concerning content
- **Substance use** — Alcohol, drugs, smoking references
- **Discussion topics** — Themes parents may want to discuss
- **Message/moral** — Overall takeaway of the film
- **Caching** — Results cached locally to avoid repeated lookups

## Commands

### Lookup a Movie

```bash
uv run {baseDir}/scripts/content_advisory.py lookup "The Batman"
uv run {baseDir}/scripts/content_advisory.py lookup "Inside Out" --year 2015
uv run {baseDir}/scripts/content_advisory.py lookup "Oppenheimer" --json
```

### Search for Titles

```bash
uv run {baseDir}/scripts/content_advisory.py search "batman"
uv run {baseDir}/scripts/content_advisory.py search "pixar" --limit 10
```

### Clear Cache

```bash
uv run {baseDir}/scripts/content_advisory.py clear-cache
```

## Output Example

```
🎬 The Batman (2022) | PG-13

📊 CONTENT RATINGS
   Sex/Nudity:    2 ▓▓░░░░░░░░
   Violence/Gore: 7 ▓▓▓▓▓▓▓░░░
   Language:      5 ▓▓▓▓▓░░░░░

📋 CATEGORY DETAILS
   Sex/Nudity: A man and woman kiss...
   Violence:   Multiple fight scenes with punching...
   Language:   15 uses of profanity including...

💊 SUBSTANCE USE
   Alcohol consumed at party scenes...

💬 DISCUSSION TOPICS
   Vigilantism, revenge, grief, corruption

📝 MESSAGE
   Justice requires restraint, not vengeance.
```

## Rating Scale

| Score | Level    | Description                 |
| ----- | -------- | --------------------------- |
| 0-1   | None     | No content in this category |
| 2-3   | Mild     | Brief, non-graphic content  |
| 4-5   | Moderate | Some concerning content     |
| 6-7   | Heavy    | Significant content         |
| 8-10  | Severe   | Extensive, graphic content  |

## Data Source

Content ratings are sourced from [Kids-In-Mind.com](https://kids-in-mind.com), an independent nonprofit that has been reviewing movies since 1992. They do not assign age ratings but provide objective descriptions so parents can make informed decisions.

## Usage Examples

**"Is The Batman appropriate for my 12 year old?"**

```bash
uv run {baseDir}/scripts/content_advisory.py lookup "The Batman"
```

**"How violent is Oppenheimer?"**

```bash
uv run {baseDir}/scripts/content_advisory.py lookup "Oppenheimer"
# Check the Violence/Gore rating and details
```

**"Find family movies with low content ratings"**

```bash
uv run {baseDir}/scripts/content_advisory.py search "disney" --limit 20
# Review results for low-rated titles
```

## Data Storage

Cache stored at `~/.clawdbot/content-advisory/cache.json` to minimize repeated lookups.

## Notes

- Results are scraped from Kids-In-Mind.com
- Not all movies are reviewed — primarily theatrical releases
- Cache can be cleared to force fresh lookups
- Please support Kids-In-Mind if you find their service valuable