anime-manga-research について
Crawlora APIを通じて、アニメやマンガの情報を正規化されたJSONで取得するリサーチスキルです。作品、キャラクター、スタッフ、ランキング、放送情報の調査や作品探しに使えます。
主な機能
- 01アニメ・マンガの作品検索
- 02作品詳細・キャラクター・スタッフ
- 03ランキングと放送スケジュール
- 04キャラクター検索とおすすめ作品
- 05Crawlora APIによるJSON取得
活用シーン
- 01作品のあらすじ・ジャンル・状態の調査
- 02作品のキャストや制作スタッフの確認
- 03シーズン別・ジャンル別ランキングの作成
- 04類似作品や放送中アニメの検索
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ crawlora-org/ crawlora-skills --skill anime-manga-researchインストール後、Claude Code で/anime-manga-researchを入力して読み込まれたか確認します。
同梱ファイルreference/endpoints.mdscripts/crawlora.sh
詳細
アニメ・マンガの調査
Crawlora API から正規化された JSON 形式で、アニメやマンガのタイトル、キャラクター、スタッフ、ランキングを検索できます。ファン Wiki やトラッカーサイトのページをスクレイピングする必要はありません。
このスキルを使う場面
- 「このアニメ/マンガについて教えて」(あらすじ、ジャンル、ステータス、スコア)。
- 「キャストは誰?/誰が制作に関わった?」(キャラクター、スタッフ)。
- 「今シーズン放送中の作品は?」/「ジャンル別・年別の上位アニメは?」
- 「 に似たタイトルを探して。」
- タイトルを横断して、名前からキャラクターを検索する。
セットアップ(一度だけ)
- https://crawlora.net で無料の Crawlora API キーを取得します(月 2,000 クレジット、カード不要)。
- ヘルパーを実行する前に、環境変数に
CRAWLORA_API_KEYを設定します。 - ヘルパーは環境変数から
CRAWLORA_API_KEYを読み込み、https://api.crawlora.net/api/v1にリクエストを送信します。キーがない、または無効な場合は401が返されます。
仕組み
- アニメ —
/anime/search(query)でタイトル ID を検索してから、/anime/title/{id}で詳細を取得します(生の ID または MyAnimeList ID のmalを指定できます)。/anime/title/{id}/characters、/anime/title/{id}/staff、/anime/title/{id}/recommendationsも利用できます。/anime/rankings(season、season_year、genre、format、statusで絞り込み)と/anime/airing-scheduleでは、ランキングや現在放送中の作品を確認できます。/anime/character/{id}と/anime/character/search(query)では、キャラクターを直接検索できます。 - マンガ — アニメと同様です。
/manga/search(query)→/manga/title/{id}(こちらもmalを指定できます)。ランキングには/manga/rankingsを使います。
すべてのエンドポイント、メソッド、パラメーターの一覧については、reference/endpoints.md をご覧ください。
API の呼び出し
# Anime:
scripts/crawlora.sh /anime/search query="Frieren" | jq '.'
scripts/crawlora.sh /anime/title/154587 | jq '.'
scripts/crawlora.sh /anime/airing-schedule | jq '.'
# Manga:
scripts/crawlora.sh /manga/search query="Frieren" | jq '.'
scripts/crawlora.sh /manga/rankings | jq '.'
すべてのリクエストに scripts/crawlora.sh を使用してください。API キーをコマンドライン引数に含めずに済みます。
エンドポイントのリファレンス
このスキルで使用する Anime と Manga のすべてのエンドポイントについては、reference/endpoints.md をご覧ください。
使用例
- シーズン作品のまとめ:
/anime/rankingsをseasonとseason_yearで絞り込み、そのシーズンのタイトルをランキング形式で取得します。 - 徹底調査:
/anime/title/{id}と/characters、/staffを組み合わせて、1 作品の詳細なプロフィールを取得します。 - 「次に見る作品」:
/anime/title/{id}/recommendationsで、見終わった作品に似たタイトルを探します。
注意事項と制限
- クレジット/成功時のみ課金:
2xxの場合にのみ課金されます。無料プランは月 2,000 クレジットです。キーは https://crawlora.net で取得できます。 - 公開データのみ — 公開されているタイトル/トラッカーページが対象です。
- セキュリティ: キーは
CRAWLORA_API_KEYのみに保存してください。ハードコード、クエリパラメーターへの指定、コミットは絶対に行わないでください。 - タイトル/キャラクターの詳細取得には、プラットフォーム独自の ID が必要です。名前しかわからない場合は、先に
.../searchで ID を特定してください。 - リストのエンドポイントはページネーションに対応しています(
page/per_page)。すべての結果を取得するには、ページを順にたどってください。
コメント
Markdown 対応