# Golpo Hub auth.md

Welcome to the automated agent authentication and registration guide for **Golpo Hub**.

## Overview

Golpo Hub supports standard **Auth.md** and OAuth discovery for AI agents, crawlers, and programmatic tools to access serialized web novels, public chapters, metadata search, and API services.

## Discovery Metadata

- **OAuth Protected Resource Metadata (PRM)**: [https://golpohub.com/.well-known/oauth-protected-resource](https://golpohub.com/.well-known/oauth-protected-resource)
- **OAuth Authorization Server Metadata**: [https://golpohub.com/.well-known/oauth-authorization-server](https://golpohub.com/.well-known/oauth-authorization-server)
- **API Catalog (RFC 9727)**: [https://golpohub.com/.well-known/api-catalog](https://golpohub.com/.well-known/api-catalog)
- **OpenAPI 3.1 Specification**: [https://golpohub.com/openapi.json](https://golpohub.com/openapi.json)

## Agent Registration & Provisioning

Agents may provision credentials and obtain bearer tokens via:
- **Registration Endpoint**: `https://golpohub.com/agent/register`
- **Claim Endpoint**: `https://golpohub.com/agent/claim`

### Supported Identity Types

1. **Identity Assertion (`identity_assertion`)**:
   - `urn:ietf:params:oauth:token-type:id-jag` (Identity-JAG)
   - `verified_email` (Agent verified email identity)
2. **Anonymous Access (`anonymous`)**:
   - Read-only bearer token acquisition for search and public reading.

## Supported Scopes

- `read`: Read published series, volumes, and chapters.
- `search`: Execute full-text and indexed search queries across the catalog.
- `episodes`: Access negotiated chapter markdown content.

## Bearer Token Usage

Include the issued bearer token in the HTTP `Authorization` header on all requests:
```http
Authorization: Bearer <your-agent-token>
```