librarian-marketplace

# Telvok Marketplace

Buy and sell knowledge books on the Telvok marketplace.

## Tools

- `library_search(query, filters?)` - Search marketplace for books
- `library_buy(slug)` - Purchase or claim a book
- `library_download(slug)` - Download a free (open) book locally
- `library_publish(name, pricing, attestation, ...)` - Publish your entries as a book
- `my_books(filter?)` - View your published and purchased books
- `sync(slug?, force?)` - Check for and receive updates to owned books
- `rate_book(slug, rating, title?, comment?)` - Rate a purchased book (1-5 stars)
- `seller_analytics()` - View your sales, reviews, and download stats
- `unsubscribe(slug)` - Cancel a subscription to a book

## Pricing Tiers

| Tier | Price | Access | Updates |
|------|-------|--------|---------|
| **Open** | Free | Downloads locally | Manual re-download |
| **One-time** | $X | Cloud API only | Seller decides |
| **Subscription** | $X/mo | Cloud API only | Always latest |

Platform fee: 20% on paid transactions.

## Buying Workflow

1. `library_search({ query: "react patterns" })` - Find books
2. `library_buy({ slug: "react-best-practices" })` - Purchase (returns checkout URL for paid)
3. Complete payment in browser (if paid)
4. `sync()` - Download content
5. `rate_book({ slug: "react-best-practices", rating: 5 })` - Rate the book

## Selling Workflow

1. Build knowledge with `record()` over time
2. `auth({ action: "login" })` - Connect your Telvok account
3. Set up Stripe Connect (required for paid books) at telvok.com
4. `library_publish({ name: "My Patterns", pricing: { type: "one_time", price_cents: 999 }, attestation: { original_work: true, terms_accepted: true } })`
5. `seller_analytics()` - Track performance

## Search Filters

```
library_search({
  query: "auth patterns",
  filters: {
    pricing: "open",        // "open" | "one_time" | "subscription"
    tags: ["auth", "jwt"],  // Filter by tags
    min_rating: 4           // 1-5
  }
})
```

## See Also

- **librarian** - L