name	bibliocanvas
description	BiblioCanvasの書籍管理CLI。本の追加・更新・削除、本棚管理、Kindle本のASIN登録に対応。ユーザーが本・読書・本棚・BiblioCanvasに言及したら使用。
allowed-tools	Bash(bibliocanvas:), Bash(curl:), Bash(npx:*)

BiblioCanvas CLI

BiblioCanvasの書籍ライブラリをコマンドラインから管理する。

セットアップ

npx bibliocanvas --version    # インストール確認
npx bibliocanvas login        # 初回: ブラウザ認証

コマンド一覧

書籍の一覧・検索

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指定）:

npx bibliocanvas add --title "タイトル" --authors "著者" --book-id <ASIN> --source kindle_import --image <画像URL>

手動入力:

npx bibliocanvas add --title "タイトル" --authors "著者"

書籍の更新

npx bibliocanvas update <bookId> --status READ
npx bibliocanvas update <bookId> --rating 5
npx bibliocanvas update <bookId> --memo "感想テキスト"
npx bibliocanvas update <bookId> --image <画像URL>

書籍の削除

npx bibliocanvas delete <bookId>

本棚の管理

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 "本棚名"            # 新規本棚作成
npx bibliocanvas shelf publish <shelfId>                 # 本棚を公開
npx bibliocanvas shelf publish <shelfId> --slug my-shelf # slug指定で公開
npx bibliocanvas shelf unpublish <shelfId>               # 本棚を非公開に

公開本棚の閲覧（ログイン不要）

npx bibliocanvas public shelves                           # 公開本棚一覧
npx bibliocanvas public shelves --user <username>         # ユーザーの公開本棚一覧
npx bibliocanvas public shelf <shelfId>                   # 公開本棚の詳細+書籍一覧
npx bibliocanvas public shelves --json                    # JSON出力

手動登録の手順

書名から書籍を登録する手順。

1. 書籍情報を調べる

Web検索で書名を調べ、タイトル・著者・ASINを特定する。

2. 表紙画像を取得する

AmazonのOG画像が最も確実:

# 方法1: OG画像（最も確実）
curl -s -L -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36" -H "Accept-Language: ja-JP,ja;q=0.9" "https://www.amazon.co.jp/dp/{ASIN}" | grep -oP 'property="og:image"[^>]*content="\K[^"]+' | head -1

# 方法2: 検索結果ページから（OG画像が取れない場合）
curl -s -L -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36" -H "Accept-Language: ja-JP,ja;q=0.9" "https://www.amazon.co.jp/s?k={ASIN}&i=digital-text" | grep -oP 'https://m\.media-amazon\.com/images/I/[A-Za-z0-9+._-]+\.jpg' | head -1

3. 重複チェック

npx bibliocanvas list -q "書名"

4. 登録する

npx bibliocanvas add --title "タイトル" --authors "著者" --book-id {ASIN} --source kindle_import --image "{画像URL}"

Kindle本の登録手順

BiblioCanvasのKindleインポートで取り込めなかった本や、手動で追加したいKindle本をASINで登録する。

1. ASINを特定する

AmazonのURLから取得: https://www.amazon.co.jp/dp/{ASIN}

2. 表紙画像を取得する

AmazonのOG画像が最も確実:

# 方法1: OG画像（最も確実）
curl -s -L -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36" -H "Accept-Language: ja-JP,ja;q=0.9" "https://www.amazon.co.jp/dp/{ASIN}" | grep -oP 'property="og:image"[^>]*content="\K[^"]+' | head -1

# 方法2: 検索結果ページから（OG画像が取れない場合）
curl -s -L -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36" -H "Accept-Language: ja-JP,ja;q=0.9" "https://www.amazon.co.jp/s?k={ASIN}&i=digital-text" | grep -oP 'https://m\.media-amazon\.com/images/I/[A-Za-z0-9+._-]+\.jpg' | head -1

3. 登録する

npx bibliocanvas add --title "タイトル" --authors "著者" --book-id {ASIN} --source kindle_import --image "{画像URL}"

シリーズ全巻の一括登録

1巻のページからシリーズのASINを取得:

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

各ASINのタイトルを確認:

curl -s -H "User-Agent: Mozilla/5.0" "https://www.amazon.co.jp/dp/{ASIN}" | grep -oP '<title>[^<]*' | sed 's/<title>//'

各巻を表紙画像付きで登録する。

重要: 追加前に重複チェック

npx bibliocanvas list -q "タイトル"

メモの書式（=== セパレータ）

ひとこと感想（本棚ビューでポップ表示）
===
読書ログ（リストビューで全文表示）。
Markdown対応。

=== の前が「ひとこと」、後が「読書ログ」。=== がない場合はメモ全体が「ひとこと」として扱われる。

本棚比較

2人のユーザーの公開本棚を比較して、共通の本や一致率を算出する。

手順

両者の公開本棚の書籍を取得:

npx bibliocanvas public shelf <shelfId1> --json > /tmp/user1.json
npx bibliocanvas public shelf <shelfId2> --json > /tmp/user2.json

Pythonで比較:

import json, re

with open('/tmp/user1.json') as f:
    user1 = json.load(f).get('books', [])
with open('/tmp/user2.json') as f:
    user2 = json.load(f).get('books', [])

# タイトル完全一致
t1 = set(b['title'] for b in user1)
t2 = set(b['title'] for b in user2)
exact = t1 & t2

# シリーズ単位の一致（巻数表記を除去して比較）
def get_series(title):
    t = re.sub(r'[\(（].*?[\)）]', '', title)
    t = re.sub(r'[\s　]*\d+巻?$', '', t)
    t = re.sub(r'[\s　]*第?\d+[巻集話]', '', t)
    return t.strip()

s1 = set(get_series(b['title']) for b in user1)
s2 = set(get_series(b['title']) for b in user2)
series = {s for s in s1 & s2 if len(s) > 2}

print(f"タイトル完全一致: {len(exact)}冊")
print(f"シリーズ一致: {len(series)}作品")
print(f"一致率: {len(series)/len(s1)*100:.1f}%")
for t in sorted(exact):
    print(f"  {t}")

補足

トークンは自動リフレッシュ。期限切れで再ログイン不要。
--dev フラグで開発環境に接続。
CLIからの変更は公開本棚にも自動同期される。