narou
v1.0.0
Published
Narou API Wrapper
Downloads
104,288
Readme
node-narou
なろうデベロッパーの API を fluent interface で利用できるラッパーライブラリです。 ブラウザでの JSONP の利用も可能です。
以下の API をラップしています。
Installation
以下のコマンドでインストールできます。
npm install narou
Usage - API
https://deflis.github.io/node-narou/ を参照してください。
ブラウザで利用したい場合 narou/browser
をimportしてください。こちらを利用することで自動的にfetch(nodejs)への依存がなくなり、JSONPを利用するようになります。
すでにサポート終了していますがfetchをサポートしないNode.jsバージョンで利用する場合は 、 NarouNovelFetch
にfetchのNode.js実装を渡してください。
なお、その場合の動作は確認していないので動かなければIssueを立ててください。
Example
import { search, ranking, rankingHistory, searchR18 } from "narou";
import {
Genre,
GenreNotation,
Order,
NovelTypeParam,
RankingType,
R18Site,
R18SiteNotation,
} from "narou";
// なろう小説 API
const searchResult = await search("word")
.genre(Genre.RenaiIsekai) // 異世界〔恋愛〕
.order(Order.FavoriteNovelCount) // ブックマーク数の多い順
.type(NovelTypeParam.RensaiNow) // 連載中
.execute();
console.log(searchResult.allcount);
for (const novel of searchResult.values) {
console.log(novel.title);
console.log(novel.ncode);
console.log(GenreNotation[novel.genre]); // 値から名前を取得できるヘルパーもあります
}
// なろう小説ランキング API
const rankingResult = await ranking()
.date(new Date("2023-04-01"))
.type(RankingType.Daily)
.execute();
for (const novel of rankingResult) {
console.log(novel.ncode);
console.log(novel.rank);
console.log(novel.pt);
}
// なろう小説ランキング API となろう小説 API を組み合わせたヘルパーもあります
const rankingResultWithDetail = await ranking()
.date(new Date("2023-04-01"))
.type(RankingType.Daily)
.executeWithFields();
for (const novel of rankingResultWithDetail) {
console.log(novel.ncode);
console.log(novel.rank);
console.log(novel.pt);
console.log(novel.title);
}
// なろう殿堂入り API
const rankingHistoryResult = await rankingHistory("**NCODE**");
for (const history of rankingHistoryResult) {
console.log(history.type);
console.log(history.date);
console.log(history.pt);
console.log(history.rank);
}
// 18禁小説 API
const searchR18Result = await searchR18("word")
.r18Site(R18Site.Nocturne) // ノクターン
.order(Order.FavoriteNovelCount) // ブックマーク数の多い順
.type(NovelTypeParam.RensaiNow) // 連載中
.execute();
console.log(searchR18Result.allcount);
for (const novel of searchR18Result.values) {
console.log(novel.title);
console.log(novel.ncode);
console.log(R18SiteNotation[novel.nocgenre]); // 値から名前を取得できるヘルパーもあります
}
Development
# watch
npm run watch
# build
npm run build
# test
npm run test
Contributing
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request :D
License
MIT