# BrightBean

> YouTube Intelligence API for AI Agents. Content gap analysis, packaging scoring (titles + thumbnails), video hook scoring, and channel/video benchmarks — delivered via API and MCP server.

## Docs

- [API Documentation](https://brightbean.xyz/docs/)
- [Quickstart](https://brightbean.xyz/docs/quickstart)
- [MCP Server Setup](https://brightbean.xyz/docs/mcp)

## API Endpoints

- [/v1/score/packaging](https://brightbean.xyz/docs/reference/): Score a YouTube title and/or thumbnail for click-through potential
- [/v1/score/video-hook](https://brightbean.xyz/docs/reference/): Classify and score the opening of a YouTube video
- [/v1/research/content-gaps](https://brightbean.xyz/docs/reference/): Find underserved YouTube topics with high demand and low supply
- [/v1/research/niches](https://brightbean.xyz/docs/reference/): List catalogued YouTube niches
- [/v1/benchmark/channel](https://brightbean.xyz/docs/reference/): Benchmark a YouTube channel against its niche
- [/v1/benchmark/video](https://brightbean.xyz/docs/reference/): Benchmark a YouTube video against its niche

## Quickstart

```python
# pip install brightbean
from brightbean import BrightBean

client = BrightBean(api_key="bb_YOUR_API_KEY")

# Find content gaps in a niche
gaps = client.research.content_gaps(niche="home-cooking")

# Score a title
score = client.score.packaging(
    title="10 Budget Meals Under $5"
)
```

## MCP Server

```json
{
  "mcpServers": {
    "brightbean": {
      "url": "https://api.brightbean.xyz/mcp",
      "headers": {
        "Authorization": "Bearer bb_YOUR_API_KEY"
      }
    }
  }
}
```

## Pricing

- Free: 350 credits (no credit card)
- Paid plans available — see [pricing](https://brightbean.xyz)

## Links

- [Website](https://brightbean.xyz)
- [Blog](https://brightbean.xyz/blog/)
- [GitHub](https://github.com/brightbeanxyz)