sansfiction-library

# SansFiction Library (Authorized)

## What this skill does
- **Library management (auth required):** add/remove books, set reading status, log progress, view “currently reading”, and reading stats.
- **Daily check-in:** schedule a reminder that asks “How much did you read today?” and then logs what the user reports.

## Hard rules
- **Never ask for or store passwords.** Use a SansFiction token only.
- **Never echo the token back** to the user or write it into chat logs.
- **No side effects without confirmation** when the target book is ambiguous (multiple matches).

---

## Setup (one-time) — get the token
If `SANSFICTION_TOKEN` is missing, do this immediately:

1) Tell the user to open **SansFiction → Connect AI Agents** and use **Manual Token**:
   - Go to: https://sansfiction.com/docs/agents
   - In **Manual Token**, click **Generate token**
   - Copy the token

2) Ask the user to paste the token **once** in this chat.

3) Persist it (recommended):
- In `~/.openclaw/openclaw.json`:
  - `skills.entries.sansfiction-library.apiKey: "<TOKEN>"`
  - (this maps to env var `SANSFICTION_TOKEN`)
- Or set:
  - `skills.entries.sansfiction-library.env.SANSFICTION_TOKEN: "<TOKEN>"`

If you can’t edit config automatically, give the user the exact snippet to paste.

---

## How to talk to SansFiction (MCP over HTTP)
Endpoint:
- `https://sansfiction.com/api/mcp`

Use JSON-RPC with Bearer auth.

### 1) List available tools (discover exact tool names)
```bash
curl -s https://sansfiction.com/api/mcp \
  -H "Authorization: Bearer $SANSFICTION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

2) Call a tool

Replace TOOL_NAME and ARGS with what tools/list returns.

curl -s https://sansfiction.com/api/mcp \
  -H "Authorization: Bearer $SANSFICTION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"TOOL_NAME","arguments":ARGS}}'

Error handling
	•	If you...