Notionの読書データベースへの本の登録を、録画から作ったSkillと本棚の写真で片づける

---
name: "book-to-notion-reading-log"
description: "本のタイトルを受け取り、Amazon.co.jpで書誌情報とアソシエイトリンクを取得して、Notionの「読書記録」データベースに1件登録する。"
---

# 本をNotionの読書記録に登録する

ユーザーが本のタイトル(またはAmazonのURL/ASIN/ISBN)を1冊または複数冊渡したら、書誌情報を集めてNotionの読書データベースにページを作る。手作業の流れ(Amazon検索 → 商品ページ → アソシエイトツールバーでリンク生成 → Save.to拡張でNotionへクリップ)を、ツールで直接再現する。画面操作の再生はしない。

## 0. 登録先

- Notionのデータベース「📙 読書」(Dashboard / 本棚 / 読書。Save.to上の表示名は「読書記録」)。
- データソース: `collection://xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`
- スキーマが変わっている可能性があるので、最初に `notion-fetch` で確認する(出力は非常に長いので、プロパティ名と型が分かれば十分)。

## 1. Amazonを読む手段

- 優先: Claude in Chrome(ユーザーのChromeでAmazonにログイン済み)。`tabs_context_mcp` → 新しいタブで `https://www.amazon.co.jp/` を開く。
- Chromeが繋がっていなければ、デスクトップアプリの内蔵ブラウザ(amazon.co.jp のサイト許可が必要)。
- サンドボックスのシェルやWebFetchからはAmazon・openBD・国立国会図書館APIに届かないので試さない。
- 複数冊のときは、Amazonのページを1つ開いた状態で `javascript_tool` から同一オリジンの `fetch('/s?k=...&i=stripbooks')` や `fetch('/dp/<ASIN>')` を順に呼び、DOMParserで解析すると1回でまとめて取れる。出力が長いと切れるので、1回あたり3〜5冊にする。

## 2. 本を特定する

- URLやASINが渡されていればそれを使う。
- 検索結果: `div[data-component-type="s-search-result"]` の `data-asin`、`h2`(書名)、`.a-row.a-size-base.a-color-secondary`(著者と日付)。
- 紙の本(単行本・ソフトカバー)を優先する。紙の本のASINは数字10桁(ISBN-10)、`B0`で始まるものはKindle版。
- 検索結果の先頭がKindle版しかない場合は、そのKindle商品ページのHTMLから `/dp/(4\d{8}[\dX])` に一致するリンクを探し、書名が一致する紙の本のASINを使う。
- タイトルが少し違う(例:「テスト」と「コンテスト」)場合は、最も近い本を選び、そう解釈したことを報告で伝える。旧版と新版がある場合は、DBに旧版が既にあれば新版を選ぶ。判別できないときだけユーザーに確認する。

## 3. 書誌情報を取る

商品ページ `/dp/<ASIN>` から:

- 書名: `#productTitle`(Amazonの表記をそのまま使う。シリーズ名の括弧も残す。既存ページもこの形式)。
- 著者: `#bylineInfo .author`(「(著)」「(翻訳)」「(監修)」の役割付き)。
- 出版社・発売日: `#detailBullets_feature_div li` のうち「出版社」「発売日」を含む行。発売日は YYYY-MM-DD に直す。
- 表紙画像: `#landingImage` の `data-old-hires`(m.media-amazon.com の大きい画像)。
- 本文用の紹介文は商品説明を参考に自分の言葉で1〜2文にまとめる。丸写しはしない。

## 4. アソシエイトリンク

- ストアID / トラッキングID: `example-22`
- 形式: `https://www.amazon.co.jp/dp/<ASIN>?tag=example-22`
- amzn.to の短縮リンクが必要と言われた場合だけ、Chromeでアソシエイトツールバーの「リンク生成」→「ショートリンク」→「アフィリエイトリンクをコピー」を使う。

## 5. 重複チェックと既存ページの更新

- 作成前に、各タイトルの特徴的な語で `notion-search`(`data_source_url` に上記データソース、`max_highlight_length: 0`)を実行する。
- 同じ本が既にあれば新しいページは作らず、その既存ページを `notion-fetch` して次の2つを確認する(確認なしで行ってよい):
  1. Status が「ほしい書籍」なら、Status を外す(`update_properties` で `{"Status": null}`)。それ以外の Status(doing / done など)は触らない。
  2. Image プロパティが空(fetch 結果の properties に Image がない)なら、手順7と同じ方法で表紙をアップロードして設定する。
- それ以外の既存の値(Link、著者、本文など)は変えない。
- 旧版だけがある場合は新版として新規登録してよい。
- 報告では、既存ページごとに何を変えたか(「ほしい書籍」を外した、画像を追加した、変更なし)を伝える。

## 6. Notionに登録する

`notion-create-pages`(parent は `data_source_id`、複数冊は1回の呼び出しでまとめる)。

- title: 書名
- genre(複数選択): 技術書・プログラミング系は「技術書」、ビジネス・ファシリテーション系は「ビジネス書」、英語学習は「英語」。既存の選択肢から選ぶ。
- 出版社(複数選択): 出版社名。既存の選択肢と表記を合わせる(例:「ハーパーコリンズ・ ジャパン」)。
- 著者(複数選択): **既存の選択肢に一致する名前だけ設定する**(姓名の間に半角スペースがある表記が多い)。選択肢にない名前を入れると作成全体がエラーになる。APIで選択肢を追加するには既存の約1,000件を全部書き直す必要があり、消してしまう恐れがあるので行わない。設定できなかった著者は本文に「著者: …」として書き、報告で伝える。
- 発売日: `date:発売日:start` に YYYY-MM-DD、`date:発売日:is_datetime` に 0。
- Link: アソシエイトリンク。
- Status / 希望: 空のまま(ユーザーが指定した場合のみ)。
- cover: 表紙画像URL。
- 本文: 表紙画像、著者(全員・役割付き)、紹介文、Amazonリンク。

## 7. 表紙画像をImageプロパティに入れる

Image はファイル型なので外部URLはそのまま入らない。新規ページの作成後、または既存ページのImageが空のときに:

1. `notion-create-attachment` に `source_url`(表紙画像URL)と `filename`(`<ASIN>.jpg`)を渡してNotionにアップロードし、`file_upload_id` を得る。複数冊なら並列に呼ぶ。
2. `notion-update-page` の `update_properties` で `{"Image": [{"type": "file_upload", "file_upload": {"id": "<file_upload_id>"}}]}` を設定する。

アップロードは1時間で期限切れになるので、すぐに設定する。

## 8. 後片付けと報告

- 自分で開いたブラウザのタブを閉じる。
- 報告は、登録した本(書名・出版社・発売日とNotionページのリンク)の一覧、登録済みだった本とそこで変えた内容、解釈した点(タイトルの読み替え・新版選択・genreの判断)、手作業が必要な点(未設定の著者)を短くまとめる。