bibliocanvas 0.2.0

package/skills/bibliocanvas/SKILL.md

@@ -0,0 +1,138 @@
+---
+name: bibliocanvas
+description: BiblioCanvasの書籍管理CLI。本の追加・更新・削除、本棚管理、Kindle本のASIN登録に対応。ユーザーが本・読書・本棚・BiblioCanvasに言及したら使用。
+allowed-tools: Bash(bibliocanvas:*), Bash(curl:*), Bash(npx:*)
+---
+
+# BiblioCanvas CLI
+
+BiblioCanvasの書籍ライブラリをコマンドラインから管理する。
+
+## セットアップ
+
+```bash
+npx bibliocanvas --version    # インストール確認
+npx bibliocanvas login        # 初回: ブラウザ認証
+```
+
+## コマンド一覧
+
+### 書籍の一覧・検索
+
+```bash
+npx bibliocanvas list                          # 全書籍
+npx bibliocanvas list -q "キーワード"           # タイトル・著者で検索
+npx bibliocanvas list --status READ            # ステータスで絞り込み（READ, READING, UNREAD, BACKLOG）
+npx bibliocanvas list --shelf <shelfId>        # 特定の本棚の書籍
+npx bibliocanvas list --rating 5               # 最低評価で絞り込み
+npx bibliocanvas list --limit 20               # 表示件数制限
+npx bibliocanvas list --json                   # JSON出力
+```
+
+### 書籍の追加
+
+**Kindle本（ASIN指定）:**
+```bash
+npx bibliocanvas add --title "タイトル" --authors "著者" --book-id <ASIN> --source kindle_import --image <画像URL>
+```
+
+**ISBN指定:**
+```bash
+npx bibliocanvas add --isbn 9784065371534
+```
+
+**手動入力:**
+```bash
+npx bibliocanvas add --title "タイトル" --authors "著者"
+```
+
+### 書籍の更新
+
+```bash
+npx bibliocanvas update <bookId> --status READ
+npx bibliocanvas update <bookId> --rating 5
+npx bibliocanvas update <bookId> --memo "感想テキスト"
+```
+
+### 書籍の削除
+
+```bash
+npx bibliocanvas delete <bookId>
+```
+
+### 本棚の管理
+
+```bash
+npx bibliocanvas shelf list                              # 本棚一覧
+npx bibliocanvas shelf books <shelfId>                   # 本棚の中身を表示
+npx bibliocanvas shelf add-book <shelfId> <bookId>       # 本棚に書籍追加
+npx bibliocanvas shelf remove-book <shelfId> <bookId>    # 本棚から書籍削除
+npx bibliocanvas shelf create --name "本棚名"            # 新規本棚作成
+```
+
+### 公開本棚の閲覧（ログイン不要）
+
+```bash
+npx bibliocanvas public shelves                           # 公開本棚一覧
+npx bibliocanvas public shelves --user <username>         # ユーザーの公開本棚一覧
+npx bibliocanvas public shelf <shelfId>                   # 公開本棚の詳細+書籍一覧
+npx bibliocanvas public shelves --json                    # JSON出力
+```
+
+## Kindle本の登録手順
+
+BiblioCanvasのKindleインポートで取り込めなかった本や、手動で追加したいKindle本をASINで登録する。
+
+### 1. ASINを特定する
+
+AmazonのURLから取得: `https://www.amazon.co.jp/dp/{ASIN}`
+
+### 2. 表紙画像を取得する
+
+Amazonの商品ページからOG画像を取得:
+```bash
+curl -s -H "User-Agent: Mozilla/5.0" "https://www.amazon.co.jp/dp/{ASIN}" | grep -oP 'property="og:image"[^>]*content="([^"]+)"' | grep -oP 'https://[^"]+' | head -1
+```
+
+### 3. 登録する
+
+```bash
+npx bibliocanvas add --title "タイトル" --authors "著者" --book-id {ASIN} --source kindle_import --image "{画像URL}"
+```
+
+### シリーズ全巻の一括登録
+
+1. 1巻のページからシリーズのASINを取得:
+```bash
+curl -s -H "User-Agent: Mozilla/5.0" "https://www.amazon.co.jp/dp/{1巻のASIN}" | grep -oP 'dp/(B[A-Z0-9]{9,10})' | sort -u
+```
+
+2. 各ASINのタイトルを確認:
+```bash
+curl -s -H "User-Agent: Mozilla/5.0" "https://www.amazon.co.jp/dp/{ASIN}" | grep -oP '<title>[^<]*' | sed 's/<title>//'
+```
+
+3. 各巻を表紙画像付きで登録する。
+
+### 重要: 追加前に重複チェック
+
+```bash
+npx bibliocanvas list -q "タイトル"
+```
+
+## メモの書式（=== セパレータ）
+
+```
+ひとこと感想（本棚ビューでポップ表示）
+===
+読書ログ（リストビューで全文表示）。
+Markdown対応。
+```
+
+`===` の前が「ひとこと」、後が「読書ログ」。`===` がない場合はメモ全体が「ひとこと」として扱われる。
+
+## 補足
+
+- トークンは自動リフレッシュ。期限切れで再ログイン不要。
+- `--dev` フラグで開発環境に接続。
+- CLIからの変更は公開本棚にも自動同期される。

package/src/api.ts

@@ -0,0 +1,315 @@
+/**
+ * API client for BiblioCanvas REST API
+ */
+
+import { getIdToken, getApiBaseUrl } from './auth.js';
+
+export interface Book {
+  bookId: string;
+  title: string;
+  authors: string;
+  acquiredTime: number;
+  readStatus: 'NONE' | 'UNREAD' | 'READING' | 'READ' | 'BACKLOG';
+  productImage: string;
+  source: string;
+  addedDate: number;
+  rating?: number;
+  memo?: string;
+  detailPageUrl?: string;
+}
+
+export interface Shelf {
+  id: string;
+  name: string;
+  description: string;
+  books: string[];
+  isPublic: boolean;
+  color: string;
+}
+
+export interface SearchResult {
+  volumeId: string;
+  title: string;
+  authors: string;
+  thumbnail: string;
+  isbn?: string;
+}
+
+type Env = 'production' | 'development';
+
+async function apiRequest(
+  method: string,
+  path: string,
+  env: Env,
+  body?: Record<string, unknown>,
+  query?: Record<string, string>
+): Promise<unknown> {
+  const token = await getIdToken(env);
+  const baseUrl = getApiBaseUrl(env);
+  let url = `${baseUrl}${path}`;
+
+  if (query) {
+    const params = new URLSearchParams(
+      Object.entries(query).filter(([, v]) => v !== undefined)
+    );
+    if (params.toString()) {
+      url += `?${params.toString()}`;
+    }
+  }
+
+  const options: RequestInit = {
+    method,
+    headers: {
+      Authorization: `Bearer ${token}`,
+      'Content-Type': 'application/json',
+    },
+  };
+
+  if (body && (method === 'POST' || method === 'PATCH')) {
+    options.body = JSON.stringify(body);
+  }
+
+  const response = await fetch(url, options);
+  const data = await response.json();
+
+  if (!response.ok) {
+    throw new Error(
+      (data as { error?: string }).error || `API error: ${response.status}`
+    );
+  }
+
+  return data;
+}
+
+async function publicApiRequest(
+  path: string,
+  env: Env,
+  query?: Record<string, string>
+): Promise<unknown> {
+  const baseUrl = getApiBaseUrl(env);
+  let url = `${baseUrl}${path}`;
+
+  if (query) {
+    const params = new URLSearchParams(
+      Object.entries(query).filter(([, v]) => v !== undefined)
+    );
+    if (params.toString()) {
+      url += `?${params.toString()}`;
+    }
+  }
+
+  const response = await fetch(url);
+  const data = await response.json();
+
+  if (!response.ok) {
+    throw new Error(
+      (data as { error?: string }).error || `API error: ${response.status}`
+    );
+  }
+
+  return data;
+}
+
+// ==================== Public Shelves (no auth required) ====================
+
+export interface PublicShelf {
+  id: string;
+  name: string;
+  description: string;
+  ownerUsername: string;
+  ownerDisplayName: string;
+  slug: string;
+  bookCount: number;
+  likeCount: number;
+  commentCount: number;
+  updatedAt: string | null;
+  books?: PublicBook[];
+}
+
+export interface PublicBook {
+  bookId: string;
+  title: string;
+  authors: string;
+  productImage: string;
+  rating: number | null;
+  memo: string | null;
+  readStatus: string | null;
+}
+
+export async function listPublicShelves(
+  env: Env,
+  options?: { limit?: number }
+): Promise<{ shelves: PublicShelf[]; total: number }> {
+  const query: Record<string, string> = {};
+  if (options?.limit) query.limit = options.limit.toString();
+  return publicApiRequest('/public/shelves', env, query) as Promise<{
+    shelves: PublicShelf[];
+    total: number;
+  }>;
+}
+
+export async function listUserPublicShelves(
+  env: Env,
+  username: string
+): Promise<{ shelves: PublicShelf[]; total: number }> {
+  return publicApiRequest(`/public/users/${username}/shelves`, env) as Promise<{
+    shelves: PublicShelf[];
+    total: number;
+  }>;
+}
+
+export async function getPublicShelf(
+  env: Env,
+  shelfId: string,
+  options?: { books?: boolean }
+): Promise<PublicShelf> {
+  const query: Record<string, string> = {};
+  if (options?.books === false) query.books = 'false';
+  return publicApiRequest(`/public/shelves/${shelfId}`, env, query) as Promise<PublicShelf>;
+}
+
+// ==================== Books ====================
+
+export async function listBooks(
+  env: Env,
+  options?: { q?: string; status?: string; sort?: string; dir?: string }
+): Promise<{ books: Book[]; total: number }> {
+  const query: Record<string, string> = {};
+  if (options?.q) query.q = options.q;
+  if (options?.status) query.status = options.status;
+  if (options?.sort) query.sort = options.sort;
+  if (options?.dir) query.dir = options.dir;
+
+  return apiRequest('GET', '/books', env, undefined, query) as Promise<{
+    books: Book[];
+    total: number;
+  }>;
+}
+
+export async function getBook(
+  env: Env,
+  bookId: string
+): Promise<Book> {
+  return apiRequest('GET', `/books/${bookId}`, env) as Promise<Book>;
+}
+
+export async function addBookByIsbn(
+  env: Env,
+  isbn: string
+): Promise<Book> {
+  return apiRequest('POST', '/books', env, { isbn }) as Promise<Book>;
+}
+
+export async function addBookBySearch(
+  env: Env,
+  search: string,
+  volumeId?: string
+): Promise<Book | { message: string; results: SearchResult[] }> {
+  const body: Record<string, unknown> = { search };
+  if (volumeId) body.volumeId = volumeId;
+  return apiRequest('POST', '/books', env, body) as Promise<
+    Book | { message: string; results: SearchResult[] }
+  >;
+}
+
+export async function addBookManual(
+  env: Env,
+  data: {
+    title: string;
+    authors?: string;
+    readStatus?: string;
+    rating?: number;
+    memo?: string;
+    bookId?: string;
+    source?: string;
+    productImage?: string;
+  }
+): Promise<Book> {
+  return apiRequest('POST', '/books', env, data) as Promise<Book>;
+}
+
+export async function updateBook(
+  env: Env,
+  bookId: string,
+  updates: Record<string, unknown>
+): Promise<Book> {
+  return apiRequest('PATCH', `/books/${bookId}`, env, updates) as Promise<Book>;
+}
+
+export async function deleteBook(
+  env: Env,
+  bookId: string
+): Promise<{ deleted: string }> {
+  return apiRequest('DELETE', `/books/${bookId}`, env) as Promise<{
+    deleted: string;
+  }>;
+}
+
+export async function searchBooks(
+  env: Env,
+  q: string,
+  type?: 'isbn' | 'title'
+): Promise<{ results: SearchResult[] }> {
+  const query: Record<string, string> = { q };
+  if (type) query.type = type;
+  return apiRequest('GET', '/books/search', env, undefined, query) as Promise<{
+    results: SearchResult[];
+  }>;
+}
+
+// ==================== Shelves ====================
+
+export async function listShelves(
+  env: Env
+): Promise<{ shelves: Shelf[]; total: number }> {
+  return apiRequest('GET', '/shelves', env) as Promise<{
+    shelves: Shelf[];
+    total: number;
+  }>;
+}
+
+export async function createShelf(
+  env: Env,
+  data: { name: string; description?: string; color?: string }
+): Promise<Shelf> {
+  return apiRequest('POST', '/shelves', env, data) as Promise<Shelf>;
+}
+
+export async function updateShelf(
+  env: Env,
+  shelfId: string,
+  updates: Record<string, unknown>
+): Promise<Shelf> {
+  return apiRequest('PATCH', `/shelves/${shelfId}`, env, updates) as Promise<Shelf>;
+}
+
+export async function deleteShelf(
+  env: Env,
+  shelfId: string
+): Promise<{ deleted: string }> {
+  return apiRequest('DELETE', `/shelves/${shelfId}`, env) as Promise<{
+    deleted: string;
+  }>;
+}
+
+export async function addBookToShelf(
+  env: Env,
+  shelfId: string,
+  bookId: string
+): Promise<{ shelfId: string; bookId: string; added: boolean }> {
+  return apiRequest('POST', `/shelves/${shelfId}/books`, env, {
+    bookId,
+  }) as Promise<{ shelfId: string; bookId: string; added: boolean }>;
+}
+
+export async function removeBookFromShelf(
+  env: Env,
+  shelfId: string,
+  bookId: string
+): Promise<{ shelfId: string; bookId: string; removed: boolean }> {
+  return apiRequest(
+    'DELETE',
+    `/shelves/${shelfId}/books/${bookId}`,
+    env
+  ) as Promise<{ shelfId: string; bookId: string; removed: boolean }>;
+}