book-research

書籍とオーディオブックの調査

Crawlora API を使い、Goodreads、Apple Books、Audible から書籍、著者、レビュー、オーディオブックを正規化された JSON として検索します。書籍カタログページのスクレイピングは行いません。

このスキルを使う場面

• 「この本の評価／レビューは？」
• 「この著者はどんな本を書いていますか？」（書誌、引用）
• 「厳選したリストをください」（Goodreads のジャンル／リストページ）。
• 「Apple Books で見つけて／オーディオブックはありますか？」
• 「今、Apple Books／Audible で人気の作品は？」
• 「このオーディオブックのナレーターは誰ですか？ シリーズにはほかにどんな作品がありますか？」（Audible）

セットアップ（一度だけ）

• 無料の Crawlora API キー（毎月 2,000 クレジット、カード不要）を https://crawlora.net で取得します。
• ヘルパーを実行する前に、環境に CRAWLORA_API_KEY を設定します。
• ヘルパーは環境から CRAWLORA_API_KEY を読み取り、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがない場合や無効な場合は → 401 になります。

仕組み

1. Goodreads — /goodreads/search（q）で書籍／著者の ID を検索し、続いて /goodreads/book/{id}（＋ /reviews、/editions）または /goodreads/author/{id}（＋ /books、/quotes）を使います。/goodreads/genre/{name} と /goodreads/list/{id}（/goodreads/lists から閲覧）で、厳選されたリストを閲覧できます。
2. Apple Books — /apple-books/search（term）で書籍 ID を検索し、続いて /apple-books/book/{id}（＋ /reviews、/similar）または /apple-books/author/{id} を使います。オーディオブックも同様です。 /apple-books/audiobook/search → /apple-books/audiobook/{id}（＋ /reviews、/similar）を使い、シリーズには /apple-books/audiobook-series/{id} と /apple-books/series/{id} を使います。/apple-books/charts では 国／ジャンル別の人気作品を確認できます。
3. Audible — /audible/search（keywords）で作品の asin を検索し、 /audible/product/{asin} で詳細（ナレーター、再生時間、シリーズ）を確認します。 さらに /audible/product/{asin}/reviews と /audible/product/{asin}/related も使えます。 /audible/series/{asin} でシリーズをたどり、/audible/categories と /audible/category/{id} でジャンル別に閲覧できます。/audible/charts と /audible/list/{list} では、ベストセラーや編集者おすすめのリストを確認できます。

エンドポイント、メソッド、パラメーターの一覧は、reference/endpoints.md を参照してください。

API の呼び出し

# Goodreads:
scripts/crawlora.sh /goodreads/search q="Project Hail Mary" | jq '.'
scripts/crawlora.sh /goodreads/book/54493401 | jq '.'

# Apple Books:
scripts/crawlora.sh /apple-books/search term="Project Hail Mary" | jq '.'
scripts/crawlora.sh /apple-books/charts | jq '.'

# Audible:
scripts/crawlora.sh /audible/search q="Project Hail Mary" | jq '.'

すべてのリクエストには scripts/crawlora.sh を使います。API キーをコマンドライン引数に含めずに済みます。

エンドポイントのリファレンス

このスキルで使用する Goodreads、Apple Books、Audible のすべてのエンドポイントについては、reference/endpoints.md を参照してください。

使用例

• 著者の書誌： /goodreads/author/{id}/books（または /apple-books/author/{id}）で著者の全作品を確認し、 /goodreads/book/{id}/reviews で評価を照合します。
• 「次は何を読むべき？」 — /apple-books/book/{id}/similar または Goodreads のジャンル／リストページで、カテゴリ内のおすすめ作品を探します。
• オーディオブックと印刷版の確認： /apple-books/book/{id} と /apple-books/audiobook/search または /audible/search を使って同じ作品を検索し、 ナレーション付きの版があるか、ナレーターは誰かを確認します。

注意事項と制限

• クレジット／成功時のみ課金： 2xx の場合のみ課金されます。無料プランは毎月 2,000 クレジットです。 キーは https://crawlora.net で取得できます。
• 公開データのみ — 公開されているカタログ／レビューのページが対象です。
• セキュリティ： キーは CRAWLORA_API_KEY にのみ保存し、ハードコード、クエリパラメーターへの指定、コミットはしないでください。
• 詳細エンドポイントでは、各プラットフォーム固有の ID が必要です。タイトル／著者名しか分からない場合は、最初に .../search で ID を検索してください。
• レビューとリストはページ分割されています（page／limit）。すべて取得するにはページを順にたどってください。