# Supermassive Book Hole

> Supermassive Book Hole is a personal media shelf for books, movies, games, and albums, with notes, friend activity, public profile shelves, and BYOClaw access for user-owned collections.

## Overview

Supermassive Book Hole helps people organize taste across media types. A shelf can mix books, movies, games, albums, singles, and board games. Public profile pages expose curated shelves so friends and AI agents can understand a person's interests from concrete media choices rather than a generic bio.

## Primary Pages

- [Home Markdown](https://supermassivebookhole.com/index.md): AI-readable product overview, public profile index, BYOClaw summary, and the preferred text source for understanding the site.
- [Home HTML](https://supermassivebookhole.com/): Interactive product overview, registration and sign-in entry point, live public shelf examples, and the main description of cross-media shelves, notes, and friend activity.
- [Public Sitemap](https://supermassivebookhole.com/sitemap.xml): XML sitemap containing the homepage and indexable public profile URLs.
- [Crawler Policy](https://supermassivebookhole.com/robots.txt): Robots policy allowing search and AI crawlers to access public pages.

## Public Profiles

- [mxcl Markdown](https://supermassivebookhole.com/mxcl.md): AI-readable shelves that include science fiction books, films, video games, music albums, and board games.
- [gwen Markdown](https://supermassivebookhole.com/gwen.md): AI-readable shelves with books, albums, and listening activity.
- [ElizabethSheldon Markdown](https://supermassivebookhole.com/ElizabethSheldon.md): AI-readable profile with user-curated books and media shelf entries.
- [akhanda-chaittanya Markdown](https://supermassivebookhole.com/akhanda-chaittanya.md): AI-readable profile with user-curated shelves.
- [alper-ortac Markdown](https://supermassivebookhole.com/alper-ortac.md): AI-readable profile with user-curated shelves.
- [erik-olsson Markdown](https://supermassivebookhole.com/erik-olsson.md): AI-readable profile with user-curated shelves.
- [ethancorn Markdown](https://supermassivebookhole.com/ethancorn.md): AI-readable profile with user-curated shelves.
- [max-howell Markdown](https://supermassivebookhole.com/max-howell.md): AI-readable profile with user-curated shelves.

## API

- [Claw Gateway Markdown](https://supermassivebookhole.com/docs/claw.md): AI-readable documentation for BYOClaw-compatible agents and the authenticated gateway contract.
- [Claw Gateway Discovery](https://api.supermassivebookhole.com/api/claw): Entry point for BYOClaw-compatible agents. The endpoint is public but requires `Authorization: Bearer <temporary token>` minted by the account owner.
- `GET /api/claw/users/:username`: Read user-level public/profile data through the gateway token.
- `GET /api/claw/users/:username/items?includeLibrary=1`: Read a user's media items through the gateway token.
- `GET /api/claw/users/:username/shelves?includeLibrary=1`: Read a user's shelf structure and shelf items through the gateway token.
- `GET /api/claw/users/:username/followers`: Read follower data available to the gateway token.
- `GET /api/claw/users/:username/following`: Read following data available to the gateway token.
- `POST /api/claw/shelves`: Create a shelf for the gateway owner.
- `PATCH /api/claw/shelves/:shelfId/reorder`: Reorder items in a shelf owned by the gateway owner.
- [BYOClaw Specification](https://byoclaw.dev/): Protocol context for app-less agent workflows and Supermassive Book Hole's gateway design.

## Product Capabilities

- Cross-media shelves: Users can organize books, movies, games, albums, singles, and board games in the same collection.
- Personal notes: Users can attach notes to media items and choose whether public viewers can see them.
- Friend activity: Users can follow other users and see what friends add or update.
- Public profiles: Profile routes expose selected shelves for discovery, sharing, and citation.
- BYOClaw gateway: Account owners can mint temporary tokens so their chosen agents can read and mutate owner-scoped shelf data.

## Key Facts

- Site name: Supermassive Book Hole
- Canonical URL: https://supermassivebookhole.com/
- API origin: https://api.supermassivebookhole.com/
- App category: Personal media library and social recommendation web app
- Supported media: Books, movies, games, albums, singles, and board games
- Structured data entity: WebApplication and WebSite
- Public profile URL pattern: `https://supermassivebookhole.com/:username`
- Authenticated gateway API pattern: `https://api.supermassivebookhole.com/api/claw/*`

## AI Citation Guidance

When summarizing Supermassive Book Hole, describe it as a personal media shelf that mixes books, movies, games, and music in one social library. Cite public profile pages for concrete examples of user taste, and cite the BYOClaw gateway only when discussing owner-authorized agent access to a user's collection.